Guide de démarrage rapide : API des complétions de chat

Prérequis et URL de base

Notre API est entièrement compatible avec l'interface standard de complétion de chat OpenAI. Il vous suffit d'une URL de base et d'une clé API pour commencer à envoyer des requêtes. L'URL de base est HTTPS://api.howmuchisanapikey.com/v1. Ce point de terminaison unique gère toute la génération de texte sans que vous ayez à gérer plusieurs URL de service ou configurations de proxy.

L'authentification est simple. Vous devez inclure un en-tête Authorization avec le schéma Bearer suivi de votre clé unique. Chaque requête vers le point de terminaison des complétions de chat nécessite cet en-tête pour valider votre compte et suivre l'utilisation des jetons par rapport à votre solde de crédit prépayé.

Authentification et en-têtes

Incluez l'en-tête Authorization dans chaque requête pour vérifier votre identité. Le format de l'en-tête est Authorization: Bearer YOUR_API_KEY. Si la clé est invalide ou expirée, l'API renvoie immédiatement une erreur 401. Cela garantit que seuls les comptes autorisés peuvent consommer votre crédit prépayé.

Vous n'avez pas besoin de passer des en-têtes supplémentaires pour la génération de texte basique. Cependant, si vous utilisez des fonctionnalités spécifiques comme le mode JSON ou l'appel de fonctions, vous devez définir l'en-tête Content-Type sur application/json. Cela indique au serveur comment analyser correctement le corps de votre requête.

Envoi de votre première complétion de chat

Envoyez une requête POST à /v1/chat/completions avec votre historique de messages et l'identifiant du modèle. L'ID du modèle est "uncensored". Ce modèle est ajusté pour répondre sans refus pour le contenu adulte légal, la fiction ou les sujets controversés. Il ne filtre pas en fonction des normes politiques ou sociales standards.

Voici un exemple curl de base pour vous aider à démarrer :

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

La réponse contiendra le texte généré dans le tableau 'choices'. Vous pouvez l'analyser directement dans la logique de votre application. Chaque requête consomme des jetons d'entrée pour votre invite et des jetons de sortie pour la réponse du modèle.

Utilisation des jetons et réponses en streaming

Utilisez les Événements envoyés par le serveur (SSE) pour recevoir les tokens au fur et à mesure de leur génération. Cela réduit la latence perçue pour les sorties longues. Définissez le paramètre stream sur true dans le corps de votre requête. Le serveur enverra plusieurs chunks, chacun contenant un delta partiel de la réponse.

Le dernier chunk inclut les données d'utilisation. Cet objet contient le total des jetons d'entrée et de sortie consommés par la requête. Vous pouvez utiliser ces données pour mettre à jour votre solde de crédit local ou surveiller vos dépenses en temps réel. Le streaming est idéal pour les interfaces de chat où les utilisateurs attendent une réactivité instantanée.

Appel de fonctions et mode JSON

L'API prend en charge les sorties structurées via le mode JSON et l'appel de fonctions. Définissez response_format sur {"type": "json_object"} pour forcer le modèle à renvoyer du JSON valide. Cela est utile pour extraire des données ou générer des configurations structurées sans erreurs d'analyse.

Pour l'appel de fonctions, fournissez un tableau tools dans votre requête. Le modèle répondra avec tool_calls s'il détermine qu'une fonction est nécessaire. Vous pouvez ensuite exécuter la fonction et renvoyer le résultat au modèle. Cela permet des workflows complexes en plusieurs étapes sans logique de parsing externe.

Gestion des limites et des erreurs

Vous êtes limité à 300 requêtes par minute par clé et à 8 requêtes simultanées. Si vous dépassez ces limites, vous recevrez une erreur 429 Too Many Requests. Le corps de la réponse inclura les détails retry-after. Ajustez le throttling côté client pour éviter les nouvelles tentatives inutiles.

Si votre crédit prépayé est épuisé, l'API renvoie une erreur 402 Payment Required. Vous pouvez recharger via crypto à tout moment. Les erreurs et les refus sont gratuits, vous ne payez que pour la génération de jetons réussie. La fenêtre de contexte est de 100,000 jetons pour le prompt et la complétion combinés.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)