Guides

Démarrage rapide

Appelez les modèles de langage RunAPI via un protocole synchrone ou de streaming pris en charge.

RunAPI expose les modèles de langage via des interfaces de protocoles publics familiers. Pointez un client compatible existant vers https://runapi.ai, utilisez un identifiant de modèle RunAPI et authentifiez-vous avec une clé API standard.

Choisir un protocole

Chat Completions compatible OpenAI utilise POST /v1/chat/completions.
Responses compatible OpenAI utilise POST /v1/responses.
Messages compatible Anthropic utilise POST /v1/messages.
La génération de contenu compatible Gemini utilise /v1beta/models/{model}:generateContent ou :streamGenerateContent.

Choisissez le protocole qui correspond le mieux à votre client existant et à votre flux applicatif. Le catalogue de modèles identifie les protocoles publics pris en charge par chaque modèle.

Envoyer une requête

Cette requête Chat Completions retourne une réponse synchrone :

SHELL

curl "https://runapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "Summarize why idempotency matters."}]
  }'

Conservez la forme de la requête et de la réponse dans le protocole sélectionné. Utilisez la référence API de l’opération pour les champs exacts, l’appel d’outils, la sortie structurée et les contraintes spécifiques au modèle.

Sortie en flux

Définissez l’option de streaming du protocole et consommez les événements server-sent retournés de manière incrémentielle. Pour Chat Completions, ajoutez "stream": true ; pour les appels compatibles Gemini, utilisez l’opération :streamGenerateContent. Fermez le flux lorsque votre client reçoit l’événement terminal du protocole.

Inspecter la fidélité de la livraison

Chaque réponse LLM acceptée inclut X-RunAPI-Fidelity. Une valeur de full signifie que la requête a été transmise sans omission. Une valeur de lossy signifie que RunAPI a omis des contrôles optionnels pour compléter la requête ; X-RunAPI-Omitted-Fields contient leurs noms de champs séparés par des virgules. Les requêtes dont la sémantique requise de cycle de vie, de continuation, d’outil ou d’élément typé ne peut pas être préservée sont rejetées avant qu’une tâche soit créée.

Les deux en-têtes sont exposés via CORS, de sorte que les clients navigateur peuvent les inspecter. Enregistrez-les avec l’identifiant de requête lorsque le comportement exact de livraison est important pour l’application.

Gérer les erreurs et l'utilisation

Traitez 401 comme un échec d’authentification, les réponses 4xx comme des problèmes de requête ou de politique, et ne relancez que les défaillances transitoires de serveur ou de réseau. Lisez l’utilisation des tokens dans la réponse finale ou l’événement de flux terminal dans la forme de protocole sélectionnée, et conservez les identifiants de requête dans les journaux applicatifs pour le support.