Documentation API

URL de base et authentification

Connectez votre application en pointant vers notre point de terminaison dédié et en transmettant votre clé API unique. L'URL de base pour toutes les requêtes est https://api.apertusapp.com/v1. Vous obtenez votre clé immédiatement après vous être inscrit via Google ou e-mail sur le Obtenir la clé API page. Incluez cette clé dans le Authorization header pour chaque requête.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Chaque compte génère une clé active. Si vous générez une nouvelle clé, la précédente devient instantanément invalide. Cela garantit un contrôle strict de votre accès sans abonnements ni frais d'inactivité.

Première demande

Envoyez votre première invite au point de terminaison de chat completions pour recevoir du texte brut et non filtré. Utilisez l'ID du modèle uncensored pour accéder à notre modèle open-source spécifique ajusté pour les sujets adultes et controversés licites.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusapp.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

L'API accepte les paramètres standards tels que temperature et top_p. Les erreurs et les refus ne consomment pas de jetons, vous ne payez donc que pour ce qui atteint réellement le modèle. Cette approche maintient des coûts prévisibles par rapport aux agrégateurs qui facturent les frais de routage.

Intégration du SDK Node

Utilisez le SDK Node officiel pour gérer efficacement le mode JSON et l'appel de fonctions. Définissez response_format à {"type": "json_object"} pour des sorties structurées ou définir des outils pour un comportement de type agent.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusapp.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Le modèle prend en charge les appels d'outils avec tool_choice options. Vous pouvez également définir un seed pour des résultats déterministes. Cette flexibilité vous permet de construire des applications complexes sans quitter l'écosystème compatible OpenAI.

Réponses en streaming

Diffusez les jetons en temps réel à l'aide des Server-Sent Events (SSE) pour des expériences utilisateur à faible latence. Chaque bloc contient le texte généré, et le dernier bloc inclut les statistiques d'utilisation totale des jetons.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Le streaming réduit la latence perçue pour les utilisateurs finaux. Vous pouvez interrompre le flux si l'utilisateur change d'avis. L'API gère automatiquement le protocole SSE, nécessitant un code minimal de votre côté.

Fenêtre de contexte et capacité

Le modèle prend en charge une fenêtre de contexte de 100 000 tokens pour l'entrée et la sortie combinées. Vous pouvez spécifier jusqu'à 16 000 tokens par requête, ou revenir à 2 048 tokens si vous omettez max_tokens.

Cette grande fenêtre permet une analyse approfondie de documents ou des historiques de conversation longs. Cependant, gardez les corps de requête inférieurs à 8 Mo. Le modèle n’est ni GPT ni Llama ; c’est un modèle d’IA sans filtre distinct optimisé pour votre cas d’utilisation spécifique.

Gestion des erreurs et limites

Gérez les erreurs HTTP standard avec élégance pour maintenir un flux d'application robuste. Un 401 erreur indique une clé API invalide ou manquante. Un 402 erreur signifie que votre crédit prépayé est épuisé. Un 429 erreur signale que vous avez dépassé 300 requêtes par minute ou 8 requêtes simultanées.

Le crédit n'expire jamais, vous pouvez ainsi suspendre l'utilisation et reprendre plus tard. Les erreurs comme les doubles facturations sont corrigées via la page Support. Le crédit prépayé est facturé uniquement pour la consommation réelle de tokens, garantissant une tarification transparente pour chaque octet.