FR ▾
Obtenir la clé API

kimiapikey.comGuide

URL de base de l'API Moonshot : Pointez votre code ailleurs

L'URL de base de l'API Moonshot n'est qu'une chaîne de caractères dans votre client de style OpenAI, et la modifier permet de diriger le même code vers un autre fournisseur. Cette page indique où se trouve cette chaîne dans Python, Node, curl et les outils courants, et comment la pointer vers un endpoint alternatif.

Mis à jour le

Un câble déplacé entre deux prises sur un tableau de commutation, illustrant un changement d'URL de base API
Illustration isométrique d'un éditeur de code relié par un câble lumineux à un serveur API

Points clés

  • L'URL de base est un paramètre unique ; le corps de la requête reste au format de chat OpenAI.
  • Modifiez trois éléments lorsque vous changez : URL de base, clé API, ID de modèle.
  • Notre endpoint est https://api.kimiapikey.com/v1 et l'ID du modèle est uncensored.
  • Il s'agit d'un modèle hébergé de manière indépendante, pas du service officiel de Moonshot, donc retestez vos prompts.

Ce que fait réellement une URL de base

Les clients compatibles OpenAI construisent chaque requête à partir de deux parties : une URL de base et un chemin. Le SDK les assemble, donc un appel à chat.completions.create devient un POST vers <base_url>/chat/completions. Les fournisseurs qui suivent ce format, dont Moonshot, publient leur propre URL de base dans leur documentation. Recherchez-la là plutôt que de la copier depuis un fil de forum, car c'est la seule valeur que vous ne pouvez pas deviner.

Changer de fournisseur nécessite donc trois modifications et rien d'autre :

  1. L'URL de base, qui détermine où va la requête.
  2. La clé API, qui est délivrée par fournisseur et ne fonctionne que sur les serveurs de ce fournisseur.
  3. L'ID du modèle, car chaque fournisseur nomme ses modèles différemment.

Les messages, les rôles, le streaming, les outils et le mode JSON conservent la même structure, ce qui rend la migration rapide. Tout ce qui dépend d'une fonctionnalité spécifique au fournisseur, comme un outil de recherche web intégré, nécessitera un traitement séparé.

Il est également utile de conserver les trois valeurs ensemble dans un bloc de configuration ou un fichier d'environnement par fournisseur. Lorsque l'URL de base, la clé et l'ID du modèle sont côte à côte, revenir en arrière est une modification d'une ligne, et vous évitez l'état de migration partielle où une nouvelle clé est associée à une ancienne adresse.

Python : le package openai

En Python, vous définissez l'URL de base lors de la création du client. Cet exemple interagit avec l'endpoint de ce site :

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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)

Si vous préférez garder le code exempt de paramètres, utilisez l'environnement. Le SDK lit OPENAI_BASE_URL et OPENAI_API_KEY lorsque vous appelez OpenAI() sans arguments, permettant ainsi à un déploiement de changer de fournisseur sans modifier le code. Notez qu'une variable résiduelle dans votre shell peut alors écraser une valeur que vous avez écrite dans le fichier.

Node et curl

Le package JavaScript officiel utilise le même nom d'option, écrit en camelCase :

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: "Hello" }],
  stream: false,
});
console.log(resp.choices[0].message.content);

Sans aucun SDK, l'URL de base est simplement le début de l'adresse :

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":"Hello"}]}'

Le même endpoint accepte également POST /v1/responses, et GET /v1/models liste ce qu'il sert. L'authentification est un jeton bearer dans l'en-tête Authorization dans tous les cas.

Éditeurs et interfaces de chat

Les outils GUI exposent l'URL de base sous différents libellés : « API base », « Override OpenAI Base URL », « Custom endpoint » ou « Provider URL ». La valeur que vous collez est la même chaîne que dans le code ci-dessus, se terminant par /v1. Ne collez pas l'adresse complète /chat/completions sauf si l'outil indique qu'il souhaite l'URL complète.

Après avoir enregistré, ajoutez l'ID du modèle manuellement si l'outil ne récupère pas de liste. Certains éditeurs valident la clé contre un fournisseur fixe et refusent les valeurs personnalisées, auquel cas recherchez un paramètre qui active le mode personnalisé ou compatible OpenAI en premier. L'article sur l'utilisation d'une clé API de style Kimi dans Cursor passe en détail un tel outil.

Ce qui change lorsque vous changez de fournisseur

Un format correspondant ne signifie pas un comportement correspondant. Avant de déplacer le trafic de production, vérifiez ces points un par un :

  • Style de sortie. Un modèle différent écrit différemment. Exécutez vos vrais prompts, pas un exemple simpliste.
  • Taille du contexte. L'endpoint ici a une fenêtre de 100 000 tokens pour le prompt plus la réponse. Si votre configuration actuelle envoie des prompts plus longs, réduisez-les d'abord.
  • Limites. Une clé complète permet 8 requêtes simultanées et 300 par minute. Au-delà de l'une ou l'autre limite, vous obtenez HTTP 429, avec rate_limited ou concurrency comme code.
  • Fonctionnalités. Le streaming via SSE, l'appel de fonctions et le mode JSON sont pris en charge. La génération d'images, d'audio et de vidéo, les embeddings et l'ajustement fin ne le sont pas ; il s'agit d'une API textuelle uniquement.
  • Nom. Le service exécute un seul modèle à poids ouverts choisi pour répondre sans refus de contenu pour une utilisation adulte légale. Ce n'est pas l'API officielle de Moonshot et ce n'est pas un routeur entre fournisseurs.

Une méthode neutre pour comparer consiste à journaliser les mêmes dix prompts via les deux endpoints et à lire les réponses côte à côte. Cela prend quelques minutes et évite les suppositions.

Erreurs sur l'URL de base et leur apparence

La plupart des échecs après un changement proviennent de l'adresse, pas de la clé. Voici comment chaque erreur se manifeste et comment la réparer.

ErreurSymptômeCorrection
Hôte uniquement, sans /v1404 sur chaque appelAjoutez /v1 à la fin
Chemin complet collé404 avec un chemin doublé dans l'erreurRéduisez l'adresse à /v1
Barre oblique finale plus jointure de chemin manuelleDouble barre oblique dans l'URLLaissez le SDK assembler le chemin
Ancienne clé, nouvelle URL401Utilisez la clé délivrée par le nouveau fournisseur
Ancienne URL, nouvelle clé401 de l'ancien fournisseurRecherchez le dépôt et le shell pour l'ancienne adresse
http:// au lieu de https://Erreur de redirection ou de connexionUtilisez https partout

Une méthode rapide pour trouver les restes est de rechercher dans votre projet et vos paramètres de déploiement l'ancien nom d'hôte. Recherchez dans les fichiers .env, les variables CI, les fichiers Docker compose et les paramètres de l'éditeur, car une seule copie oubliée suffit à envoyer du trafic vers l'ancien fournisseur.

Streaming et outils après le changement

Définissez stream: true et la réponse arrive sous forme d'événements envoyés par le serveur, avec l'utilisation des tokens rapportée à la fin. L'appel de fonctions utilise les champs habituels tools et tool_choice, le streaming tool_calls et les résultats renvoyés en tant que messages avec role: "tool". Si votre code gère déjà cela pour l'ancien fournisseur, il devrait continuer à fonctionner ; confirmez en exécutant un appel en streaming et un appel de fonction avant de basculer complètement. N'oubliez pas qu'une requête en streaming occupe son slot de concurrence jusqu'à la fin du flux.

Vérification des coûts avant de changer

La facturation ici est par token : $0,15 par 1M de tokens d'entrée et $0,50 par 1M de tokens de sortie, prélevés sur le crédit prépayé, sans abonnement. Les requêtes échouées ou refusées ne sont pas facturées, et le crédit n'expire pas. Pour les tarifs d'un autre fournisseur, consultez leur page de tarification actuelle, car ceux-ci changent.

Un exemple concret. Supposons qu'une requête ait 2 000 tokens d'entrée et 500 tokens de sortie :

  • Entrée : 2 000 / 1 000 000 x $0,15 = $0,0003
  • Sortie : 500 / 1 000 000 x $0,50 = $0,00025
  • Total : $0,00055 par requête, donc 1 000 requêtes coûtent $0,55

Le rechargement minimum est de $20, et les rechargements plus importants ajoutent un bonus : +5 % à partir de $50, +10 % à partir de $100 et +15 % à partir de $200. Seule la crypto (USDT sur TRC20, USDC sur Base) est acceptée. Les détails complets sont sur la page de tarification, et la répartition axée sur Kimi est dans Tarification de la clé API Kimi.

Obtenez une clé et effectuez le premier appel

Inscrivez-vous avec Google ou avec email et mot de passe, puis ouvrez la page clé API. Les nouveaux utilisateurs peuvent réclamer $0,50 de crédit d'essai en un clic, une fois par personne, valable 7 jours et sans carte requise. Les clés d'essai sont limitées à 2 requêtes simultanées et 60 par minute, ce qui est largement suffisant pour un test.

Collez la clé dans l'extrait Python ci-dessus, exécutez-le et vérifiez que vous recevez bien du texte. La page documentation liste tous les paramètres, et les en-têtes de réponse X-Request-Id et X-Balance-USD aident au débogage et au suivi du solde. Les prompts envoyés au service ne sont pas utilisés pour l'entraînement.

Questions fréquemment posées

Le modèle est-il le même que le Kimi officiel de Moonshot ?
Non, nous hébergeons un modèle à poids ouverts qui est ajusté pour être sans censure. Il ne s'agit pas de GPT, Claude, Gemini, Grok, DeepSeek ou de tout autre modèle d'un autre fournisseur. C'est un modèle distinct exécuté sur nos propres serveurs.

Entraînez-vous sur mes données ?
Non. Vos prompts et vos réponses ne sont pas utilisés pour l'entraînement. Nous valorisons la confidentialité et la transparence, vos données vous restent donc propres.

Quelles sont les limites de débit ?
Vous êtes limité à 300 requêtes par minute par clé. La taille maximale du corps de la requête est de 8 MB. Ces limites sont conçues pour garantir des performances stables pour tous les utilisateurs.

Quelle est la politique en matière de contenu ?
Le modèle est sans censure concernant les sujets pour adultes, controversés et créatifs. Cependant, nous bloquons le contenu sexuel impliquant des mineurs. Il s'agit d'une limite stricte qui s'applique toujours, quel que soit votre niveau d'abonnement.

Questions et réponses

Dois-je modifier mon code lorsque je change l'URL de base ?

Généralement, trois valeurs seulement : l'URL de base, la clé API et l'ID du modèle. Le format des messages, le streaming et l'appel d'outils restent identiques tant que le nouveau fournisseur les prend en charge.

L'URL de base doit-elle se terminer par /v1 ?

Oui pour cet endpoint : https://api.kimiapikey.com/v1. Le SDK ajoute /chat/completions lui-même, donc ne l'incluez pas.

S'agit-il de l'API officielle de Moonshot ?

Non. Il s'agit d'un modèle à poids ouverts hébergé de manière indépendante derrière une API compatible OpenAI. Ce n'est pas le service de Moonshot et ce n'est pas un routeur entre fournisseurs.

Où puis-je trouver l'ID du modèle ?

Appelez GET /v1/models avec votre clé. Sur cet endpoint, l'ID du modèle est uncensored.

Votre clé est à un formulaire de distance

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé APILire la documentation