Kimicode : première requête en cinq minutes

URL de base et authentification

Commencez par pointer votre client vers notre URL de base : https://api.kimicode.top/v1. Vous avez besoin d'une clé API pour chaque requête. Générez-en une en cliquant sur Obtenir la clé API sur le site. Connectez-vous avec Google ou par e-mail et mot de passe. Aucun numéro de téléphone n'est requis. La clé s'affiche immédiatement après la création. Conservez-la en sécurité ; un compte ne dispose que d'une clé active. Si vous en générez une nouvelle, l'ancienne cessera de fonctionner. Transmettez la clé dans l'en-tête Authorization en tant que jeton Bearer.

Première requête

Envoyez votre premier prompt à l'endpoint de chat completions. Utilisez l'ID de modèle uncensored. L'API accepte les formats standard compatibles OpenAI. L'entrée est le prompt, la sortie est du texte. Les erreurs et refus sont gratuits, vous ne payez que pour l'utilisation de tokens réussie. Testez la connectivité avec un prompt simple.

Copiercurl https://api.kimicode.top/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."}]
  }'

Si la clé est invalide, vous obtenez une erreur 401. Si vous n'avez pas de crédit, vous obtenez une 402. Vérifiez le solde de votre compte si les requêtes échouent de manière inattendue.

Intégration SDK Python

Utilisez le SDK Python officiel OpenAI. Définissez l'URL de base sur notre endpoint. Transmettez votre clé API. Le client gère automatiquement le format de la requête. Cela fonctionne pour tout langage supportant les clients compatibles OpenAI. Installez la bibliothèque via pip. Configurez le client avec votre URL de base et votre clé. Envoyez un message en utilisant l'endpoint de chat completions. La réponse contient le texte généré. Vous pouvez analyser le contenu directement depuis l'objet de réponse.

Copierfrom openai import OpenAI

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

Assurez-vous que votre code gère les exceptions correctement. Les problèmes réseau ou les limites de débit peuvent nécessiter des tentatives de réessai.

Utilisation du SDK Node.js

Le SDK Node.js fonctionne de manière identique. Importez le client. Configurez l'URL de base et la clé API. Appelez la méthode de chat completions. Transmettez l'ID de modèle et le tableau de messages. La structure de la réponse correspond au format OpenAI. Extrayez le contenu du message de l'assistant. Cette approche fonctionne pour la génération côté serveur ou les fonctions edge. Aucune configuration supplémentaire n'est nécessaire au-delà du changement d'URL de base.

Copierimport OpenAI from "openai";

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

Gérez les erreurs en vérifiant le code de statut. Les limites de débit retournent 429. Le solde insuffisant retourne 402.

Réponses en streaming

Activez le streaming en définissant stream: true. L'API renvoie des Server-Sent Events (SSE). Chaque fragment contient du contenu partiel. Les détails d'utilisation des tokens apparaissent dans le dernier fragment. Cela réduit la latence perçue pour les sorties longues. Gérez correctement la fin du flux. Fermez la connexion lorsque le flux se termine ou en cas d'erreur. Le streaming fonctionne avec tous les clients standards qui prennent en charge le SSE.

Copierstream = 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)

Assurez-vous que votre client met en mémoire tampon les fragments correctement. Concaténez le contenu pour former la réponse finale.

Limites, erreurs et contexte

La fenêtre de contexte est de 100 000 tokens au total. Le maximum de sortie est de 32 000 tokens par requête. Définissez 2 048 si max_tokens n'est pas défini. La limite de débit est de 300 requêtes par minute par clé. La limite de concurrence est de 8 requêtes simultanées. Le corps de la requête maximum est de 8 Mo. Les erreurs incluent 401 pour les clés invalides, 402 pour l'absence de crédit et 429 pour les limites de débit. Le crédit n'expire jamais. Les erreurs sont gratuites. Pas de pièges d'abonnement.