Passer au contenu principal
Utilisez le champ model pour choisir le modèle qui doit répondre à votre requête. YouRouter prend en charge de nombreuses familles de modèles derrière une API unique compatible OpenAI : changer de modèle revient en général à modifier uniquement la valeur de model.
Pour les derniers ID de modèle activés sur votre compte, consultez le tableau de bord YouRouter.

Appel modèle de base

Toutes les requêtes Chat Completions utilisent la même forme d’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"
      }
    ]
  }'
Pour appeler un autre modèle pris en charge, modifiez la valeur de model.
{
  "model": "claude-sonnet-4-20250514",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this request in one sentence."
    }
  ]
}

Champ modèle

ChampObligatoireDescription
modelOuiID du modèle à appeler, par ex. gpt-4o, claude-sonnet-4-20250514, ou gemini-2.5-flash.
messagesOuiMessages de conversation pour les modèles de chat.
streamNontrue pour recevoir la réponse par fragments incrémentaux.

Capacités de l’API modèle

CapacitéChemin APIPour commencer
Chat texte/v1/chat/completionsComplétions de chat
Image / vision/v1/chat/completionsMultimodal
Embeddings texte/v1/embeddingsEmbeddings
Multimodal natif Gemini/v1/projects/...:generateContentGénération de contenu Gemini
Messages natifs Claude/v1/messagesMessages Anthropic
Tâches de génération vidéo/api/v3/contents/generations/tasksArk texte vers vidéo

Familles de modèles prises en charge

YouRouter est conçu pour un accès large aux modèles. Une seule intégration API permet d’appeler des modèles chez les principaux fournisseurs et familles.
FamilleExemples d’ID de modèle
OpenAI GPTgpt-4o, gpt-4o-mini-2024-07-18, gpt-4.1-2025-04-14
OpenAI raisonnemento3-2025-04-16, o4-mini-2025-04-16, o1-2024-12-17
Anthropic Claudeclaude-sonnet-4-20250514, claude-opus-4-20250514, claude-3-7-sonnet-20250219
Google Geminigemini-2.5-pro, gemini-2.5-flash
DeepSeekdeepseek-r1-250528, deepseek-v3-250324
xAI Grokgrok-3, grok-3-mini, grok-3-fast
Volcengine Doubaodoubao-seed-1-6-250615, doubao-seed-1-6-thinking-250615, doubao-1-5-pro-32k-250115
Moonshot Kimikimi-k2-250711
La disponibilité des modèles peut varier selon le compte, l’état des fournisseurs et la configuration de routage. Gardez votre intégration souple en stockant les ID de modèle dans la configuration plutôt qu’en les codant en dur dans toute l’application.

Changer de modèle dans le code

Utilisez le même client et ne modifiez que model.
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YOUROUTER_API_KEY"],
    base_url="https://api.yourouter.ai/v1",
)

model_id = "gemini-2.5-flash"

completion = client.chat.completions.create(
    model=model_id,
    messages=[{"role": "user", "content": "Reply with exactly: connected"}],
)

print(completion.choices[0].message.content)

Router vers un fournisseur

Par défaut, YouRouter route automatiquement la requête. Si vous avez besoin d’un fournisseur amont précis, envoyez l’en-tête vendor.
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "vendor: anthropic" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'
Valeurs courantes de vendor :
FournisseurValeur vendor
Routage automatiqueauto
OpenAIopenai
Azure OpenAIazure
Anthropicanthropic
Googlegoogle
AWS Bedrockaws
DeepSeekdeepseek
Mistral AImistral
Volcenginevolcengine
xAIx
Voir le guide Routage pour le routage automatique et la fixation du fournisseur.

Modèle d’intégration recommandé

Gardez ces valeurs configurables :
ParamètreExemple
URL de base APIhttps://api.yourouter.ai/v1
Clé APIYOUROUTER_API_KEY
Modèle par défautgpt-4o
Modèle de secoursgemini-2.5-flash
Fournisseur optionnelauto
Vous pourrez ainsi ajouter, retirer ou changer de modèle sans modifier le code applicatif.

Guides associés

Démarrage rapide API

Envoyez votre premier appel API modèle.

Complétions de chat

Chat, streaming, outils et entrée multimodale.

Multimodal

Envoyez des images et appelez les API multimodales natives.

Guide routage

Routage automatique ou fixation du fournisseur.

Référence API

Détails des points de terminaison et formats de requête.