Guide de démarrage rapide API Kimi

Prérequis : installation du SDK

Installez le SDK officiel pour votre langage préféré afin de gérer l'authentification et la sérialisation automatiquement. Notre API adhère au standard OpenAI, donc toute bibliothèque cliente compatible fonctionne avec des modifications de configuration minimales.

Pour Python, installez la bibliothèque via pip. Pour Node.js, utilisez npm ou yarn. Ces outils gèrent le client HTTP et l'analyse JSON pour vous.

Authentification : Définition de votre clé API kimi

Obtenez votre clé depuis le tableau de bord et transmettez-la en tant que Authorization header. Utilisez l'URL de base https://api.apikimi.cc/v1 pour toutes les requêtes.

Stockez la clé en toute sécurité dans vos variables d'environnement ou fichiers de configuration. Le format de l'en-tête est Bearer YOUR_API_KEY.

Envoi de votre première requête

Envoyez une requête POST à /v1/chat/completions avec votre ID de modèle uncensored. La réponse renvoie le texte généré directement.

Assurez-vous de définir le model field correctly. The API returns raw output without content refusals for lawful topics.

Réponses en streaming

Activez le streaming en définissant stream: true dans le corps de votre requête. Cela renvoie des chunks sous forme de Server-Sent Events (SSE).

Analysez le flux SSE pour afficher les tokens en temps réel. Le dernier chunk inclut les statistiques d'utilisation des tokens pour la facturation.

Configuration de l'appel de fonction

Définissez des outils dans le tools tableau dans votre requête. Le modèle retourne des appels d'outils au lieu de texte direct lorsque cela est approprié.

Gérez les appels d'outils dans la logique de votre application et renvoyez les résultats à l'API pour un traitement ultérieur. Prise en charge de tool_choice Permet une application stricte.

Gestion des erreurs et limites

Gérer les erreurs HTTP standard : 401 pour les clés invalides, 402 pour un crédit insuffisant et 429 pour les limites de débit. La fenêtre de contexte prend en charge 100 000 jetons au total.

La sortie max est de 16 000 tokens par requête. Les erreurs ne consomment pas de crédit. Ajustez votre logique de retry en fonction du code d'erreur.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

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