Démarrage rapide : Intégrez le chat apertus ai

Prérequis et configuration

Commencez par créer un compte et obtenir votre clé API. Inscrivez-vous en utilisant Google ou un mot de passe par e-mail sur la page de génération de clés. Le système affiche votre clé immédiatement, afin que vous puissiez la copier sans délai. Aucun numéro de téléphone n'est requis pour l'inscription. Vous recevez $0.50 de crédit d'essai valable sept jours, afin de tester la connectivité sans ajouter de fonds.

Configurez votre variable d'environnement ou le client SDK pour pointer vers la bonne URL de base. Cette URL fonctionne avec les bibliothèques OpenAI standard. Modifiez uniquement l'URL de base et votre clé. L'ID du modèle est "uncensored". Ce point de terminaison unique gère toutes les complétions de texte. Vous n'avez pas besoin de gérer l'acheminement ou de sélectionner différents modèles.

Assurez-vous que la bibliothèque cliente prend en charge le protocole OpenAI Chat Completions. La plupart des SDK modernes fonctionnent directement. Vérifiez que votre réseau autorise les requêtes HTTPS sortantes. Le service accepte les payloads JSON standard. Aucun en-tête spécial n'est nécessaire au-delà de l'authentification.

Authentification avec clés API

Transmettez votre clé API dans l'en-tête Authorization pour chaque requête. Utilisez le schéma Bearer suivi de votre chaîne de clé. Le service valide la clé par rapport à votre compte. Les clés invalides renvoient une erreur 401 Unauthorized. Une expiration ou un solde insuffisant déclenche une réponse 402 Payment Required. Vérifiez votre solde dans le tableau de bord si les requêtes échouent.

Conservez votre clé en sécurité. Chaque compte détient une clé active. La génération d'une nouvelle clé invalide la précédente. Ne partagez pas votre clé dans les dépôts publics. La clé API est l'unique identifiant de votre utilisation. Les limites de débit s'appliquent par clé, et non par compte.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

L'authentification est sans état. Le serveur vérifie le jeton à chaque appel. Si vous faites tourner votre clé, mettez à jour tous les clients en cours d'exécution immédiatement. L'absence d'en-tête entraîne un rejet immédiat. Le message d'erreur indique clairement l'échec de l'authentification.

Envoi de votre première requête

Envoyez une requête POST au point de terminaison des complétions de chat. Incluez l'ID de modèle « uncensored » et l'historique de vos messages. L'API renvoie une réponse textuelle. Vous pouvez diffuser la sortie en continu ou attendre la complétion complète. Chaque requête consomme des jetons d'entrée et de sortie. Les erreurs ne débitent pas de crédits. Les refus sont gratuits.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.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)

La réponse inclut des statistiques d'utilisation. Suivez la consommation de jetons pour gérer votre crédit prépayé. Le modèle répond sans refus de contenu pour une utilisation adulte légale. Vous pouvez envoyer des invites système pour définir le comportement. Les messages de l'utilisateur guident la conversation. La fenêtre de contexte prend en charge 100 000 jetons au total.

Commencez par un échange simple à deux messages. Cela vérifie la connectivité et la qualité des réponses. Ajustez la température et le top_p pour des sorties créatives ou précises. L'API prend en charge les paramètres standard. Les séquences d'arrêt fonctionnent comme prévu. Les valeurs de seed garantissent des résultats reproductibles.

Réponses en streaming via SSE

Activez le streaming en définissant le paramètre stream à true. L'API renvoie des Server-Sent Events (SSE) au lieu d'un seul objet JSON. Chaque fragment contient une partie du texte généré. Lisez les fragments jusqu'à la fin du flux. Le dernier fragment inclut l'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. Les utilisateurs voient le texte apparaître en temps réel. C'est idéal pour les interfaces de chat. Gérez soigneusement les tokens partiels. Concaténez les fragments pour former la réponse complète. Le serveur ferme la connexion lorsque la génération est terminée.

Surveillez les erreurs de stream. Les interruptions réseau peuvent interrompre le stream. Implémentez une logique de reconnexion si nécessaire. L'API ne renvoie pas l'historique. Lancez une nouvelle requête si le stream échoue. Les comptes de tokens dans le dernier chunk reflètent toute la génération.

Gestion des paramètres et modes

Utilisez des paramètres standard pour contrôler la génération. Réglez temperature pour l'aléatoire. Ajustez top_p pour l'échantillonnage du noyau. Définissez des séquences d'arrêt pour interrompre la génération prématurément. Passez un seed pour des sorties déterministes. Activez le mode JSON en définissant response_format sur json_object. Le modèle renvoie du JSON valide lorsqu'il est demandé.

L'appel de fonctions est pris en charge. Définissez des outils dans la requête. Le modèle renvoie des appels d'outils lorsque cela est approprié. Analysez les arguments de l'outil dans votre code. Renvoyez les résultats pour continuer la conversation. Cela permet des workflows d'agents complexes.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusaichat.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);

Les tokens max limitent la longueur de sortie. La valeur par défaut est de 2 048 tokens. Définissez une valeur plus élevée si nécessaire. La limite absolue par requête est de 16 000 tokens. La fenêtre de contexte est de 100 000 tokens. Planifiez la longueur de votre historique en conséquence. Les pénalités de fréquence et de présence aident à réduire les répétitions.

Comprendre les limites et les erreurs

Les limites de taux protègent la stabilité du service. Vous pouvez envoyer 300 requêtes par minute. La concurrence est limitée à huit requêtes simultanées par clé. Les corps de requête ne doivent pas dépasser 8 Mo. Le dépassement des limites renvoie une erreur 429 Too Many Errors. Attendez avant de réessayer.

Vérifiez les codes d'erreur pour le diagnostic. 401 signifie clé invalide ou manquante. 402 indique un crédit prépayé insuffisant. Rechargez via crypto pour reprendre le service. 429 signale une limitation de débit. 400 indique une syntaxe de requête incorrecte. Consultez le message d'erreur pour plus de détails.

La gestion de la fenêtre de contexte est cruciale. Additionnez les jetons de prompt et de complétion. Restez bien en dessous de 100 000 jetons. Tronquez les anciens messages si nécessaire. L'API ne tronque pas automatiquement. Vous contrôlez la longueur de l'historique. Une utilisation efficace du contexte réduit les coûts.