API Reference
Resumen
Endpoints y convenciones de la API de imágenes asíncrona.
SeedRouter ofrece modelos de imagen, vídeo, audio y texto a través de una sola API y una sola clave API. Los modelos de imagen, vídeo y audio se ejecutan como tareas asíncronas: envías una solicitud, recibes un ID de tarea y sondeas el resultado. Los modelos de texto responden directamente, con el formato de solicitud del proveedor del modelo.
URL base
https://api.seedrouter.aiUsa HTTPS y envía cuerpos de solicitud en JSON. Los endpoints de audio reciben en su lugar una subida de archivo con multipart/form-data.
Autenticación
Envía tu clave como token Bearer en cada solicitud, incluidas las consultas de tareas:
Authorization: Bearer YOUR_API_KEYEl endpoint de Anthropic Messages también acepta la clave en x-api-key, junto con el encabezado anthropic-version. Consulta Autenticación.
Endpoints de tareas multimedia
| Método | Ruta | Propósito |
|---|---|---|
| POST | /v1/images/generations | Envía una tarea de generación o edición de imagen: GPT Image, Nano Banana y Midjourney. |
| POST | /v1/videos/generations | Envía una tarea de vídeo: Seedance 2.5 y 2.0 (cuerpo de solicitud de ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 y SD Video. |
| POST | /v1/audio/transcriptions | Envía un archivo de audio para transcribirlo con Whisper-1. |
| POST | /v1/audio/translations | Envía un archivo de audio para traducirlo al inglés con Whisper-1. |
| GET | /v1/tasks/{id} | Lee el estado y el resultado de una tarea de imagen, vídeo o audio. |
Las imágenes, vídeos y audios de referencia se pasan como URL en el cuerpo de la solicitud. Una solicitud de imagen se convierte en una edición cuando incluye imágenes de entrada. La referencia de cada modelo enumera sus parámetros.
Endpoints de texto
| Método | Ruta | Formato de solicitud |
|---|---|---|
| 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 | Lista los modelos disponibles |
No todos los modelos de texto admiten todos los formatos. La referencia de API del modelo indica los que acepta; por ejemplo, Claude Opus 5.5 acepta Chat Completions, Responses y Messages, mientras que los modelos de texto de Gemini usan las rutas /v1beta.
Ciclo de vida de una solicitud
Tareas multimedia
- Envía la solicitud. La respuesta es una tarea, no el archivo terminado: guarda su
id. - Sondea la tarea hasta que llegue a un estado final. Las tareas de
/v1/tasks/{id}muestranprocessingy luegocompletedofailed. - Lee el resultado. Las imágenes están en
output.data[].url, los vídeos enoutput.video_urly la salida de Whisper enoutput.url. Todos los enlaces de resultados apuntan al almacenamiento de SeedRouter.
Si falla, revisa error.code y error.message. Las tareas fallidas no se cobran. No hay webhook de finalización; sondea la tarea como se describe en Webhooks.
Solicitudes de texto
Una solicitud de texto devuelve la respuesta del modelo en la misma respuesta, con la estructura oficial del proveedor. Pon stream en true, o usa :streamGenerateContent con Gemini, para recibir eventos enviados por el servidor (SSE). Los modelos de texto se cobran por token.