API Reference
Vue d'ensemble
Points de terminaison et conventions de l'API d'images asynchrone.
SeedRouter donne accès à des modèles d'image, de vidéo, d'audio et de texte via une seule API et une seule clé API. Les modèles d'image, de vidéo et d'audio s'exécutent en tâches asynchrones : vous soumettez une requête, recevez un identifiant de tâche, puis interrogez la tâche pour obtenir le résultat. Les modèles de texte répondent directement, au format de requête du fournisseur du modèle.
URL de base
https://api.seedrouter.aiUtilisez HTTPS et envoyez des corps de requête en JSON. Les points de terminaison audio attendent à la place un envoi de fichier en multipart/form-data.
Authentification
Envoyez votre clé sous forme de jeton Bearer dans chaque requête, y compris pour interroger une tâche :
Authorization: Bearer YOUR_API_KEYLe point de terminaison Anthropic Messages accepte aussi la clé dans x-api-key, accompagnée de l'en-tête anthropic-version. Voir Authentification.
Points de terminaison des tâches multimédias
| Méthode | Chemin | Usage |
|---|---|---|
| POST | /v1/images/generations | Soumet une tâche de génération ou de retouche d'image : GPT Image, Nano Banana et Midjourney. |
| POST | /v1/videos/generations | Soumet une tâche vidéo : Seedance 2.5 et 2.0 (corps de requête ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 et SD Video. |
| POST | /v1/audio/transcriptions | Soumet un fichier audio à transcrire avec Whisper-1. |
| POST | /v1/audio/translations | Soumet un fichier audio à traduire en anglais avec Whisper-1. |
| GET | /v1/tasks/{id} | Lit l'état et le résultat d'une tâche d'image, de vidéo ou d'audio. |
Les images, vidéos et fichiers audio de référence sont transmis sous forme d'URL dans le corps de la requête. Une requête d'image devient une retouche lorsqu'elle contient des images d'entrée. La référence de chaque modèle liste ses paramètres.
Points de terminaison texte
| Méthode | Chemin | Format de requête |
|---|---|---|
| POST | /v1/chat/completions | OpenAI Chat Completions |
| POST | /v1/responses | OpenAI Responses |
| POST | /v1/messages | Anthropic Messages |
| POST | /v1beta/models/{model}:generateContent | Google Gemini |
| POST | /v1beta/models/{model}:streamGenerateContent | Google Gemini, en streaming |
| GET | /v1/models | Liste les modèles disponibles |
Tous les modèles de texte ne prennent pas en charge tous les formats. La référence API du modèle indique ceux qu'il accepte ; par exemple, Claude Opus 5.5 accepte Chat Completions, Responses et Messages, tandis que les modèles de texte Gemini utilisent les chemins /v1beta.
Cycle de vie d'une requête
Tâches multimédias
- Soumettez la requête. La réponse est une tâche, pas le fichier final : conservez son
id. - Interrogez la tâche jusqu'à ce qu'elle atteigne un état final. Les tâches de
/v1/tasks/{id}indiquentprocessing, puiscompletedoufailed. - Lisez le résultat. Les images sont dans
output.data[].url, les vidéos dansoutput.video_urlet la sortie de Whisper dansoutput.url. Chaque lien de résultat pointe vers le stockage de SeedRouter.
En cas d'échec, examinez error.code et error.message. Les tâches échouées ne sont pas facturées. Il n'existe pas de webhook de fin de tâche ; interrogez plutôt la tâche, comme décrit dans Webhooks.
Requêtes texte
Une requête texte renvoie la réponse du modèle dans la même réponse HTTP, avec la structure de réponse officielle du fournisseur. Définissez stream sur true, ou utilisez :streamGenerateContent pour Gemini, afin de recevoir des événements envoyés par le serveur (SSE). Les modèles de texte sont facturés au token.