RouterShift fournit des interfaces compatibles OpenAI, Anthropic et Gemini pour les modèles actifs pour votre clé. Routage, failover, facturation et preuves d’audit sont appliqués derrière la frontière de protocole.
Toutes les requêtes API utilisent l'URL de base suivante. L'API est entièrement compatible avec les bibliothèques clientes OpenAI — changez simplement l'URL de base et utilisez votre clé API RouterShift.
https://api.routershift.com/v1Pour le SDK Anthropic ou Claude Code. Note : pas de suffixe /v1 — le SDK ajoute automatiquement /v1/messages.
https://api.routershift.comLes clients OpenAI, Anthropic et Gemini se connectent généralement en changeant l’URL de base et l’identifiant. Les champs et routes sont définis par l’OpenAPI actuel; les extensions upstream ne sont pas automatiquement portables.
GET /v1/models fait autorité pour les modèles disponibles avec votre clé. La disponibilité dépend aussi du produit, de la santé des routes, des permissions, du solde, de la région et de l’accès privé.
Si vous rencontrez des problèmes ou avez des questions, consultez les sections ci-dessous pour des guides détaillés. Pour les questions de facturation, contactez le support via la console. Pour les mises à jour de statut en temps réel, visitez la page Statut.
Le tableau est un index lisible du plan de données public. Le contrat machine est /api/openapi.yaml et la référence interactive /api/docs; les portées de clé restent applicables.
/v1/versionVersion et compatibilité de l’API de données
/v1/modelsListe des modèles
/v1/chat/completionsComplétions de chat (compatible OpenAI)
/v1/messagesAPI Messages (compatible Anthropic)
/v1/models/gemini/:model/generateContentGénération de contenu Gemini
/v1/models/gemini/:model/streamGenerateContentGénération de contenu en flux Gemini
/v1/embeddingsEmbeddings de texte
/v1/rerankReclassement
/v1/chat/completions/estimateEstimation préalable des tokens et du coût
/v1/images/generationsGénération d'images
/v1/audio/transcriptionsTranscription audio
/v1/audio/speechSynthèse vocale
/v1/ttsSynthèse vocale étendue
/v1/transcriptionsTranscription étendue
/v1/midjourney/imagineGénération d'images Midjourney
/v1/suno/generateGénération de musique Suno
/v1/video/generationsTâche de génération vidéo
/v1/video/tasks/:task_idÉtat de la tâche vidéo
/v1/chat/completions/asyncTâche asynchrone — Soumettre
/v1/chat/completions/async/:task_idTâche asynchrone — Vérifier le statut
/v1/chat/completions/async/:task_id/resultTâche asynchrone — Obtenir le résultat
/v1/batchTraitement par lots
/v1/batch/:batch_idÉtat du traitement par lot
/v1/batch/:batch_id/resultsTéléchargement des résultats du lot
/v1/batch/:batch_id/cancelAnnuler un traitement par lot
/v1/mcp/Passerelle d'outils MCP JSON-RPC
/v1/mcp/sseTransport SSE MCP
/v1/a2a/Passerelle JSON-RPC A2A
/v1/a2a/sseFlux d’événements SSE A2A
| Méthode | Chemin | Description |
|---|---|---|
| GET | /v1/version | Version et compatibilité de l’API de données |
| GET | /v1/models | Liste des modèles |
| POST | /v1/chat/completions | Complétions de chat (compatible OpenAI) |
| POST | /v1/messages | API Messages (compatible Anthropic) |
| POST | /v1/models/gemini/:model/generateContent | Génération de contenu Gemini |
| POST | /v1/models/gemini/:model/streamGenerateContent | Génération de contenu en flux Gemini |
| POST | /v1/embeddings | Embeddings de texte |
| POST | /v1/rerank | Reclassement |
| POST | /v1/chat/completions/estimate | Estimation préalable des tokens et du coût |
| POST | /v1/images/generations | Génération d'images |
| POST | /v1/audio/transcriptions | Transcription audio |
| POST | /v1/audio/speech | Synthèse vocale |
| POST | /v1/tts | Synthèse vocale étendue |
| POST | /v1/transcriptions | Transcription étendue |
| POST | /v1/midjourney/imagine | Génération d'images Midjourney |
| POST | /v1/suno/generate | Génération de musique Suno |
| POST | /v1/video/generations | Tâche de génération vidéo |
| GET | /v1/video/tasks/:task_id | État de la tâche vidéo |
| POST | /v1/chat/completions/async | Tâche asynchrone — Soumettre |
| GET | /v1/chat/completions/async/:task_id | Tâche asynchrone — Vérifier le statut |
| GET | /v1/chat/completions/async/:task_id/result | Tâche asynchrone — Obtenir le résultat |
| POST | /v1/batch | Traitement par lots |
| GET | /v1/batch/:batch_id | État du traitement par lot |
| GET | /v1/batch/:batch_id/results | Téléchargement des résultats du lot |
| POST | /v1/batch/:batch_id/cancel | Annuler un traitement par lot |
| POST | /v1/mcp/ | Passerelle d'outils MCP JSON-RPC |
| GET | /v1/mcp/sse | Transport SSE MCP |
| POST | /v1/a2a/ | Passerelle JSON-RPC A2A |
| GET | /v1/a2a/sse | Flux d’événements SSE A2A |
RouterShift est compatible avec plusieurs protocoles API. Le tableau ci-dessous montre l'URL de base et la configuration SDK pour chacun.
Compatible OpenAI
https://api.routershift.com/v1
Models: <available-model-code>
Authorization: Bearer / x-api-key
Compatible Anthropic
https://api.routershift.com
Models: <available-model-code>
x-api-key: sk-xxx
Gemini natif
https://api.routershift.com/v1
Models: <available-model-code>
Authorization: Bearer
| URL de base | Exemple de paramètre de modèle | En-tête d'authentification |
|---|---|---|
https://api.routershift.com/v1 SDK OpenAI standard — changez simplement base_url | <available-model-code> | Authorization: Bearer / x-api-key |
https://api.routershift.com SDK Anthropic standard — changez simplement base_url | <available-model-code> | x-api-key: sk-xxx |
https://api.routershift.com/v1 Format natif Gemini, appelez generateContent directement | <available-model-code> | Authorization: Bearer |
Tous les points de terminaison utilisent la même authentification. Les deux formats d'en-tête fonctionnent de manière identique :
Format compatible OpenAI
Authorization: Bearer sk-xxxFormat compatible Anthropic
x-api-key: sk-xxx