kimiapikey.comDocumentation
API Kimi : première requête en cinq minutes
Obtenez votre première réponse en moins de cinq minutes grâce à l'interface compatible OpenAI. Ce guide couvre la configuration, l'authentification et l'utilisation de base du modèle sans censure.
Prérequis
Pour commencer, vous avez besoin d’une clé API de kimiapikey.com. Inscrivez-vous avec simplement un e-mail et un mot de passe ; aucune carte bancaire n’est requise pour l’essai. Vous avez également besoin d’un environnement de langage pris en charge avec un SDK officiel ou compatible installé. Notre API suit le format chat-completions OpenAI, donc le code existant pour GPT-3.5/4 fonctionne souvent avec des modifications minimales. Assurez-vous que votre version du SDK est suffisamment récente pour prendre en charge le paramètre base_url.
URL de base et authentification
Notre API est disponible à l'adresse https://api.kimiapikey.com/v1. L'authentification est gérée via l'en-tête Authorization standard. Transmettez votre clé en tant que jeton Bearer. Cela fonctionne avec n'importe quel client acceptant des endpoints compatibles OpenAI. Si vous utilisez un proxy ou un client personnalisé, assurez-vous qu'il transmet correctement l'en-tête Authorization. L'ID de modèle que vous demanderez est uncensored.
Première requête
Envoyez une complétion de chat simple pour vérifier votre configuration. Utilisez la commande curl ci-dessous, en remplaçant YOUR_API_KEY par votre clé réelle. Cette requête envoie un prompt court au modèle uncensored. Si elle aboutit, vous recevrez une réponse JSON contenant la réponse du modèle. Vérifiez le tableau choices pour le texte généré. Si vous obtenez une erreur 401, votre clé est invalide ou expirée.
SDK Python
Utilisez la bibliothèque Python officielle OpenAI pour une intégration facile. Définissez le base_url sur notre endpoint et fournissez votre clé. Cet exemple montre un appel de génération de texte basique. Vous pouvez ajuster le paramètre model si nécessaire, bien que uncensored soit la valeur par défaut. Cette approche garde votre code portable entre différents services compatibles OpenAI.
SDK Node.js
Pour les projets JavaScript/TypeScript, utilisez le package npm openai. Configurez le client avec notre URL de base et votre clé API. Cela vous permet d'effectuer des requêtes directement depuis votre environnement Node. La syntaxe imite le SDK Python, assurant la cohérence si vous changez de langage. N'oubliez pas de gérer correctement les réponses asynchrones en utilisant await.
Réponses en streaming
Pour une sortie en temps réel, activez le streaming dans votre SDK. Cela envoie des morceaux de texte au fur et à mesure de leur génération, réduisant la latence perçue. Utilisez le drapeau stream dans votre requête. Le SDK restituera des réponses partielles, vous permettant de mettre à jour l'interface utilisateur de manière incrémentale. C'est idéal pour les interfaces de chat ou la génération de contenu long où un retour immédiat est précieux.
Limites et erreurs
Chaque clé est limitée à 300 requêtes par minute. Si vous dépassez cette limite, vous recevrez une erreur 429. Votre corps de requête ne doit pas dépasser 8 Mo. Une fenêtre de contexte de 100 000 tokens s'applique à la somme du prompt et de la complétion. Les erreurs courantes incluent 401 (clé invalide) et 402 (crédit insuffisant). Rechargez via le tableau de bord pour continuer à utiliser l'API. Les crédits n'expirent jamais et il n'y a pas de frais mensuels.
cURL
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapikey.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.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
stream = 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)Questions et réponses
L'API prend-elle en charge l'appel de fonctions ?
Oui, l'endpoint prend en charge l'appel d'outils/fonctions au format OpenAI standard. Vous pouvez définir des outils dans votre requête et le modèle renverra des arguments structurés.
Que se passe-t-il si je dépasse la limite de débit ?
Vous recevrez une erreur 429 Too Many Requests. Attendez brièvement et réessayez, ou mettez à niveau votre palier de crédit prépayé pour maintenir un débit plus élevé.
Le modèle est-il entraîné sur mes données ?
Non. Les prompts envoyés à l'API ne sont pas utilisés pour l'entraînement. Vos données restent privées et ne servent pas à améliorer le modèle de base.
Votre clé n'est qu'à un formulaire d'ici
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.
Caractéristiques techniques
Toutes les limites et fonctions réelles de l'API au même endroit — vérifiez-les avant de recharger.
| Élément | Valeur |
|---|---|
| Format | compatible OpenAI : tout SDK OpenAI fonctionne en changeant la base URL et la clé |
| ID du modèle | uncensored |
| Authentification | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Sortie max. | jusqu'au reste de la fenêtre de 100 000 tokens ; max_tokens optionnel (pas de plafond distinct) |
| Paramètres | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Appel de fonctions | oui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool |
| Streaming | oui — server-sent events ; le dernier bloc contient l'usage des tokens |
| Fenêtre de contexte | 100 000 tokens (entrée + sortie) |
| Mode JSON | response_format: {"type": "json_object"} |
| Concurrence | 8 requêtes simultanées par clé |
| Limite de débit | 300 requêtes par minute et par clé |
| En-têtes | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Taille | jusqu'à 8 Mo par requête |
| Prix | 0,15 $ par million de tokens en entrée · 0,50 $ par million en sortie |
| Facturation | crédit prépayé selon l'usage réel ; erreurs et refus gratuits |
| Bonus | +5 % dès 50 $, +10 % dès 100 $, +15 % dès 200 $ |
| Validité | le crédit payé n'expire jamais, sans abonnement |
| Recharge | USDT (TRC20) ou USDC (Base), tout montant entier de 20 $ à 500 $ |
| Essai gratuit | 0,50 $ pendant 7 jours, sans carte · Clé d'essai : 2 requêtes parallèles, 60 par minute ; limites complètes (8 et 300) après la 1re recharge |
| Clés | une clé active par compte ; une nouvelle remplace l'ancienne |
| Connexion | Google ou e-mail et mot de passe |
| Contenu | contenu adulte autorisé ; tout contenu sexuel impliquant des mineurs est refusé |
Erreurs et solutions
Les erreurs arrivent en JSON avec un type stable ; les requêtes échouées ou refusées ne sont pas facturées.
| Code | Type | Signification |
|---|---|---|
400 | bad_request | JSON invalide, messages vides, mauvais paramètre ou contexte trop long |
401 | missing_key · invalid_key · key_revoked | clé absente, erronée ou remplacée |
402 | no_credit | plus de crédit — rechargez, la reprise est immédiate |
403 | content_blocked | contenu sexuel impliquant des mineurs — refusé, non facturé |
404 | not_found | endpoint inconnu |
413 | request_too_large | corps supérieur à 8 Mo |
429 | rate_limited · concurrency | au-delà de 300/min ou 8 en parallèle — patientez |
503 | upstream_busy | modèle occupé — réessayez dans quelques secondes |