Guide de démarrage pour les utilisateurs de Kimicode

Prérequis

Avant d'écrire du code, créez un compte sur kimicode.cc avec Google ou e-mail. Vous recevez immédiatement une seule clé API. Aucune vérification par téléphone n'est requise et aucune carte bancaire n'est nécessaire. Votre compte démarre avec $0,50 de crédit d'essai valable sept jours. Si vous avez besoin de plus de capacité, rechargez via crypto (USDT sur TRC20 ou USDC sur Base) à partir de 10 $. Le crédit n'expire jamais et les erreurs ou refus ne consomment pas de tokens.

Assurez-vous que votre environnement de développement dispose de Node.js (v18+) ou de Python 3.8+. Cette API suit strictement la spécification du client openai, ce qui signifie que vous pouvez remplacer notre endpoint sans modifier la logique de votre bibliothèque. Nous servons un seul modèle sans censure sous l'ID uncensored.

Installer le SDK

Installez le SDK officiel d'OpenAI pour votre langage préféré. Cela garantit la compatibilité avec nos fonctionnalités de streaming, d'appel de fonctions et de mode JSON.

Pour Python, utilisez pip pour installer la bibliothèque standard :

• pip install openai

Pour Node.js, installez le package npm :

• npm install openai

Ces bibliothèques gèrent automatiquement le formatage HTTP. Vous n'avez pas besoin d'un client spécifique au fournisseur. L'API kimicode accepte les paramètres standard tels que temperature, top_p et max_tokens.

Initialisez le client

Configurez votre objet client avec l'URL de base kimicode et votre clé API. L'URL de base est https://api.kimicode.cc/v1. Définissez api_key avec la valeur que vous avez reçue lors de l'inscription. Cette configuration remplace l'endpoint par défaut api.openai.com.

• URL de base : https://api.kimicode.cc/v1
• Modèle : uncensored
• Auth : Token Bearer via api_key

Ne mélangez pas cette clé avec d'autres fournisseurs. Elle fonctionne exclusivement avec l'endpoint kimicode. Le client vérifiera la clé lors de la première requête. Si la clé est invalide, vous recevrez une erreur 401 immédiatement.

Faire une requête

Envoyez une requête standard de complétion de chat. L'ID du modèle doit être uncensored. Vous pouvez ajuster max_tokens jusqu'à 32 000. Si omis, la valeur par défaut est 2 048. La fenêtre de contexte est de 100 000 tokens au total pour le prompt et la complétion combinés.

• Entrée : Messages texte dans le tableau messages.
• Sortie : Réponse texte dans choices[0].message.content.

Cet endpoint prend en charge le mode JSON via response_format: {"type": "json_object"}. Il ne prend pas en charge les embeddings, les images ou l'audio. Concentrez-vous sur la génération de texte de haute qualité sans refus de contenu pour les sujets adultes licites.

Réponses en streaming

Activez le streaming en définissant stream: true. L'API retourne des Server-Sent Events (SSE). Chaque chunk contient du texte partiel. Les statistiques d'utilisation des tokens sont incluses dans le dernier chunk du flux. Cela permet l'affichage en temps réel de la sortie sans attendre la réponse complète.

• Indicateur de flux : Défini sur true dans le corps de la requête.
• Type d'événement : chat.completion.chunk
• Données : Contient delta.content pour les parties de texte.

Le streaming ne modifie pas la tarification. Vous payez pour le nombre total de tokens traités. Les erreurs pendant le streaming sont gérées correctement. Si la connexion est interrompue, vous pouvez relancer la requête. Le modèle sans censure conserve sa cohérence même sur de longs streams dans la limite de 100 000 tokens.

Limites, erreurs et contexte

Surveillez vos limites d'utilisation : 300 requêtes par minute par clé, 8 requêtes simultanées et un corps de requête de 8 Mo. Si vous dépassez la limite de débit, vous recevez une erreur 429. Si votre crédit prépayé est épuisé, vous recevez une erreur 402 ; rechargez via crypto pour reprendre. Une erreur 401 indique une clé API invalide ou manquante. Notez que les requêtes échouées et les refus ne consomment pas de tokens. La limite stricte de contenu bloque les contenus sexuels impliquant des mineurs. Tous les autres contenus adultes licites sont autorisés.

Appel de fonctions

Définissez des outils dans le paramètre tools. Le modèle retourne des appels d'outils dans la réponse. Utilisez tool_choice pour imposer un comportement spécifique. Cette fonctionnalité fonctionne identiquement à la norme OpenAI. Analysez les appels d'outils dans votre code et exécutez-les. Envoyez les résultats dans les messages suivants. L'API kimicode gère efficacement les définitions d'outils. Assurez-vous que votre schéma JSON est valide. L'appel de fonctions ne nécessite pas de crédits supplémentaires au-delà de l'utilisation des tokens. Il est idéal pour créer des agents ou des workflows d'extraction de données structurées.

cURL

Copycurl https://api.kimicode.cc/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

Copyfrom openai import OpenAI

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