Documentation KiApi : Intégration en 5 minutes

Premiers pas : URL de base et authentification

La KiApi est entièrement compatible avec l'API OpenAI. Vous pouvez utiliser l'écosystème existant de SDK et de clients en modifiant la base_url. L'URL de base pour toutes les requêtes est https://api.kiapis.com/v1. L'authentification se fait uniquement via une clé API, que vous obtenez après l'inscription sur votre page de tableau de bord. Cette clé doit être transmise dans l'en-tête HTTP Authorization: Bearer <IHR_API_SCHLÜSSEL>. Vous pouvez générer une nouvelle clé à tout moment, ce qui rend l'ancienne invalide.

Contrairement à d'autres services, nous ne proposons pas d'endpoints complexes pour les embeddings ou le fine-tuning. Notre focus est la génération de texte pure. KiApi est votre connexion directe à un modèle optimisé pour des réponses sans censure. Assurez-vous de configurer correctement votre environnement avant d'envoyer votre première requête.

POST /v1/chat/completions : Génération de texte

Le cœur de l'API est l'endpoint POST /v1/chat/completions. Vous y envoyez une liste de messages (système, utilisateur, assistant) et recevez une réponse textuelle. Le paramètre model doit être défini sur uncensored. La réponse est synchrone et contient immédiatement le fragment de texte généré ainsi que les métadonnées d'utilisation des tokens.

La structure de la requête suit le format standard. Vous pouvez définir des rôles pour structurer clairement le contexte. Le système traite l'entrée et génère une réponse basée sur le comportement appris du modèle. C'est la méthode principale pour presque toutes les applications textuelles, des chatbots à l'analyse de texte.

Kopierencurl https://api.kiapis.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."}]
  }'

La réponse contient un objet JSON avec le contenu généré. Assurez-vous d'extraire la zone content de la réponse pour l'utiliser dans votre application. Aucune métadonnée supplémentaire comme le coût par requête n'est retournée dans la réponse standard ; consultez le tableau de bord.

Streaming avec les Server-Sent Events (SSE)

Pour les applications nécessitant une sortie immédiate, KiApi prend en charge le streaming via les Server-Sent Events (SSE). Activez-le en définissant "stream": true dans le corps de la requête. Au lieu d'attendre une réponse complète, vous recevez un flux de patches JSON contenant progressivement le texte généré.

C'est particulièrement utile pour les interfaces de chat où le feedback immédiat améliore l'expérience utilisateur. L'API KiApi en streaming vous permet de réduire la latence et de simuler une conversation en temps réel. Le client doit analyser le flux et assembler les fragments jusqu'à la fin du stream.

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

Lors du streaming, les statistiques d'utilisation des tokens sont souvent retournées à la fin du flux dans le dernier événement. Cela permet une facturation précise basée sur la longueur réelle de la génération. Assurez-vous que votre code client gère la fin du flux pour libérer correctement les ressources.

Appel de fonctions et tool calling

Le modèle prend en charge le tool calling, également appelé function calling. Cela permet au LLM de retourner des données JSON structurées représentant des fonctions ou actions spécifiques dans votre application. Vous définissez les outils disponibles dans le corps de la requête, et le modèle décide en fonction de l'entrée utilisateur quand appeler un outil.

La structure des définitions d'outils suit le standard OpenAI. Vous pouvez spécifier plusieurs outils, et le modèle choisit le plus approprié. La réponse contient une liste d'appels d'outils que vous pouvez exécuter dans votre logique backend. Cela élargit considérablement les possibilités de KiApi au-delà de la simple génération de texte.

Kopierenfrom openai import OpenAI

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

Utilisez le tool calling pour automatiser des workflows complexes. Le modèle fournit les paramètres de l'outil directement au format JSON. Vous n'avez pas besoin de parsers externes pour la réponse, car la structure provient directement du modèle. Cela rend l'intégration dans les systèmes existants beaucoup plus simple et fiable.

GET /v1/models : Modèles disponibles

L'endpoint GET /v1/models liste les modèles disponibles accessibles via l'API. Cela est utile pour vérifier dynamiquement quels modèles sont disponibles ou confirmer l'ID du modèle. Vous recevrez généralement une liste contenant le modèle uncensored.

La réponse contient des métadonnées sur le modèle, comme l'ID, le propriétaire et la date de création. Contrairement à certaines autres APIs, la réponse standard ne contient pas directement la longueur maximale de la fenêtre de contexte ou les prix spécifiques. Ces informations doivent être extraites de la documentation ou du tableau de bord. Cet endpoint est cependant indispensable pour la configuration automatique des clients.

Kopierenimport OpenAI from "openai";

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

Utilisez cet endpoint pour adapter votre application aux futures modifications. Si de nouveaux modèles sont ajoutés, ils apparaîtront automatiquement dans cette liste. Le modèle actuel uncensored est le seul modèle disponible et est décrit comme un grand modèle de langage optimisé pour le contenu sans censure.

Limites de débit et codes d'erreur

Pour garantir la stabilité du service, certaines limites s'appliquent. 300 requêtes par minute sont autorisées par clé API. Le corps de la requête maximal est de 8 Mo. Si vous dépassez ces limites, vous recevez le code de statut HTTP 429 Too Many Requests. Planifiez votre application pour mettre en œuvre des tentatives avec backoff exponentiel.

D'autres codes d'erreur courants sont 401 Unauthorized si la clé API est invalide, et 402 Payment Required si votre crédit est épuisé. KiApi utilise un modèle prépayé, donc les requêtes sans crédit sont immédiatement refusées. Assurez-vous de vérifier régulièrement votre solde de compte.

La fenêtre de contexte est de 100 000 tokens pour l'entrée et la sortie combinées. Si vous dépassez cette limite, un message d'erreur est retourné. KiApi est une solution fiable pour les développeurs qui apprécient des règles claires et des limites transparentes.