Passer au contenu principal
YouRouter expose les API modèle via une passerelle unique. La plupart des intégrations doivent commencer par le point de terminaison Chat Completions compatible OpenAI.

​
URL de base

https://api.yourouter.ai/v1
Tous les chemins d’API modèle de cette référence sont relatifs à cette URL de base.

​
Authentification

Envoyez votre clé API YouRouter en jeton Bearer : 
Authorization: Bearer <YOUR_YOUROUTER_API_KEY>
Pour les requêtes JSON, envoyez aussi : 
Content-Type: application/json
Utilisez les clés API uniquement depuis du code serveur, des services backend, des jobs CI ou des outils internes de confiance. Ne placez pas de clés API dans du code navigateur ou des clients mobiles.

​
Premier appel API

curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'
Lisez le texte généré dans : 
choices[0].message.content

​
Concepts clés

ConceptUtilisation
Choix du modèleDéfinissez le champ model dans le corps de la requête.
Entrée multimodaleBlocs texte et image dans messages[].content, ou points de terminaison multimodaux natifs.
Routage automatiqueOmettez l’en-tête vendor, ou envoyez vendor: auto.
Fixation du fournisseurEn-têtes vendor: openai, vendor: anthropic, vendor: google, etc.
StreamingDéfinissez stream: true pour des fragments au format server-sent events.
API natives/messages pour Anthropic, chemins generateContent Google pour Gemini.

​
Principaux points de terminaison

Point de terminaisonRôle
POST /chat/completionsAppels modèle texte et entrée image au format compatible OpenAI. Recommandé pour la plupart des intégrations.
POST /embeddingsGénération d’embeddings texte avec des modèles compatibles.
POST /messagesAppels au format Messages d’Anthropic.
POST /projects/.../models/{model}:generateContentAppels au format generateContent Google Gemini.
POST /api/v3/contents/generations/tasksGénération vidéo par tâches.

​
Codes d’état

StatutSignification
200Requête réussie.
400Corps de requête, modèle ou format de paramètre invalide.
401Clé API manquante ou invalide.
429Limite de débit ou de concurrence atteinte côté fournisseur.
500Erreur interne de la passerelle ou du fournisseur amont.
Voir Créer une complétion de chat pour le format de requête principal, ou Multimodal pour les exemples image et vidéo.