FR ▾
Obtenir clé API

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.

Obtenir une clé API

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.

Obtenir une clé APILire la documentation

Caractéristiques techniques

Toutes les limites et fonctions réelles de l'API au même endroit — vérifiez-les avant de recharger.

ÉlémentValeur
Formatcompatible OpenAI : tout SDK OpenAI fonctionne en changeant la base URL et la clé
ID du modèleuncensored
AuthentificationAuthorization: Bearer YOUR_KEY
EndpointsPOST /v1/chat/completions · GET /v1/models
Base URLhttps://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ètrestemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Appel de fonctionsoui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool
Streamingoui — server-sent events ; le dernier bloc contient l'usage des tokens
Fenêtre de contexte100 000 tokens (entrée + sortie)
Mode JSONresponse_format: {"type": "json_object"}
Concurrence8 requêtes simultanées par clé
Limite de débit300 requêtes par minute et par clé
En-têtesX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Taillejusqu'à 8 Mo par requête
Prix0,15 $ par million de tokens en entrée · 0,50 $ par million en sortie
Facturationcré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
RechargeUSDT (TRC20) ou USDC (Base), tout montant entier de 20 $ à 500 $
Essai gratuit0,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ésune clé active par compte ; une nouvelle remplace l'ancienne
ConnexionGoogle ou e-mail et mot de passe
Contenucontenu 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.

CodeTypeSignification
400bad_requestJSON invalide, messages vides, mauvais paramètre ou contexte trop long
401missing_key · invalid_key · key_revokedclé absente, erronée ou remplacée
402no_creditplus de crédit — rechargez, la reprise est immédiate
403content_blockedcontenu sexuel impliquant des mineurs — refusé, non facturé
404not_foundendpoint inconnu
413request_too_largecorps supérieur à 8 Mo
429rate_limited · concurrencyau-delà de 300/min ou 8 en parallèle — patientez
503upstream_busymodèle occupé — réessayez dans quelques secondes