URL de base et endpoints

Pour les SDK et outils compatibles avec OpenAI, utilisez cette URL de base :

https://getrouter.ai/v1

Pour les requêtes HTTP directes, ajoutez le chemin d’endpoint indiqué ci-dessous.

Endpoints courants

FonctionnalitéMéthodeEndpoint complet
Lister les modèles au format OpenAIGEThttps://getrouter.ai/v1/models
Chat CompletionsPOSThttps://getrouter.ai/v1/chat/completions
ResponsesPOSThttps://getrouter.ai/v1/responses
Contexte Responses compactéPOSThttps://getrouter.ai/v1/responses/compact
EmbeddingsPOSThttps://getrouter.ai/v1/embeddings
Génération d’imagesPOSThttps://getrouter.ai/v1/images/generations
Modification d’imagesPOSThttps://getrouter.ai/v1/images/edits
Transcription audioPOSThttps://getrouter.ai/v1/audio/transcriptions
Traduction audioPOSThttps://getrouter.ai/v1/audio/translations
Synthèse vocalePOSThttps://getrouter.ai/v1/audio/speech
Création d’une tâche vidéoPOSThttps://getrouter.ai/v1/videos
État d’une tâche vidéoGEThttps://getrouter.ai/v1/videos/{task_id}
RerankPOSThttps://getrouter.ai/v1/rerank
Claude MessagesPOSThttps://getrouter.ai/v1/messages
Modèles au format GeminiGEThttps://getrouter.ai/v1beta/models
generateContent de GeminiPOSThttps://getrouter.ai/v1beta/models/{model}:generateContent

URL de base et endpoint complet

Les SDK demandent généralement une URL de base et ajoutent eux-mêmes le chemin de l’opération :

Base URL entered in an OpenAI SDK:
https://getrouter.ai/v1

SDK sends the request to:
https://getrouter.ai/v1/chat/completions

Certains outils demandent plutôt un endpoint complet. Lisez l’intitulé du champ et le guide d’intégration avant d’ajouter manuellement /chat/completions, /responses ou /messages.

Éviter les chemins dupliqués

Un chemin dupliqué est une cause fréquente d’erreurs 404 Not Found.

Correct OpenAI Base URL:
https://getrouter.ai/v1

Incorrect when the tool already appends /v1:
https://getrouter.ai/v1/v1

Incorrect when the tool already appends /chat/completions:
https://getrouter.ai/v1/chat/completions/chat/completions
Tip

Si un outil propose des champs distincts pour API Host, API Version et Endpoint, suivez le guide d’intégration propre à cet outil plutôt que de deviner le chemin qu’il ajoute.

Authentification

Sauf indication contraire dans un guide d’intégration, envoyez :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Les endpoints multipart, comme la transcription audio et la création vidéo, définissent automatiquement leur propre délimiteur Content-Type lorsque vous utilisez curl -F ou un SDK.

Étapes suivantes