Documentation de l'API : Points de terminaison OpenAI-Compatible

Authentification & URL de base

Accédez à l'API en définissant votre clé unique et l'URL de base dans vos variables d'environnement. L'endpoint se trouve à https://api.apikeykimi.com/v1. Vous devez inclure l'en-tête Authorization: Bearer YOUR_API_KEY avec chaque requête. Cette clé est générée instantanément lors de l'inscription via Google ou par e-mail. C'est le seul identifiant requis pour l'authentification. Aucune configuration de portées ou de permissions n'est nécessaire.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Point de terminaison Chat Completions

Envoyez des messages au modèle en utilisant le standard /v1/chat/completions point de terminaison. Spécifiez l'ID du modèle comme uncensored dans le corps de la requête. L'API renvoie du texte généré en fonction de l'historique de vos invites. Vous pouvez ajuster des paramètres comme la température et le top_p pour contrôler la créativité. Le modèle prend en charge l'appel de fonctions et le mode JSON pour les sorties structurées.

Copyfrom openai import OpenAI

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

Réponses en streaming (SSE)

Activer la livraison de jetons en temps réel en définissant stream: true dans votre requête. Le serveur retourne un flux de Server-Sent Events. Chaque chunk contient du texte partiel jusqu'à ce que la réponse soit complète. C'est idéal pour les interfaces de chat et les affichages de code en direct. Les détails d'utilisation des tokens apparaissent dans le dernier chunk du flux.

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)

Appel de fonctions et mode JSON

Définissez des outils ou forcez la sortie JSON en utilisant le response_format paramètre. Définissez json_object pour garantir des réponses JSON valides. Vous pouvez également transmettre des définitions d'outils pour l'appel de fonctions. Le modèle respecte strictement ces contraintes. Cela permet une intégration fiable avec des services externes. Utilisez tool_choice pour contrôler la façon dont les outils sont invoqués.

Limites et contraintes des jetons

La fenêtre de contexte prend en charge jusqu'à 100 000 tokens, combinant entrée et sortie. La sortie maximale par requête est de 16 000 tokens. Si vous ne définissez pas max_tokens, la limite par défaut est de 2 048 tokens. Les requêtes sont limitées à 8 Mo en taille de corps. Vous êtes limité à 300 requêtes par minute. Seules 8 requêtes peuvent s'exécuter simultanément par clé.

Gestion des erreurs & Limites d'utilisation

Gérez les erreurs en vérifiant le code de statut HTTP. Un 401 indique une clé API invalide ou expirée. Une erreur 402 signifie que votre crédit prépayé est épuisé. Une réponse 429 signale que vous avez dépassé la limite de débit de 300 requêtes par minute. Les erreurs et les refus ne consomment pas de tokens. Vérifiez votre solde sur le tableau de bord pour éviter les interruptions.

Node.js

Copyimport OpenAI from "openai";

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