Visão geral

O SeedRouter oferece modelos de imagem, vídeo, áudio e texto por meio de uma única API e uma única chave de API. Os modelos de imagem, vídeo e áudio rodam como tarefas assíncronas: você envia uma requisição, recebe um ID de tarefa e consulta o resultado. Os modelos de texto respondem diretamente, no formato de requisição do fornecedor do modelo.

URL base

https://api.seedrouter.ai

Use HTTPS e envie corpos de requisição em JSON. Os endpoints de áudio recebem, em vez disso, um upload de arquivo em multipart/form-data.

Autenticação

Envie sua chave como token Bearer em toda requisição, inclusive nas consultas de tarefa:

Authorization: Bearer YOUR_API_KEY

O endpoint do Anthropic Messages também aceita a chave em x-api-key, junto com o cabeçalho anthropic-version. Veja Autenticação.

Endpoints de tarefas de mídia

Método	Caminho	Finalidade
POST	`/v1/images/generations`	Envia uma tarefa de geração ou edição de imagem: GPT Image, Nano Banana e Midjourney.
POST	`/v1/videos/generations`	Envia uma tarefa de vídeo: Seedance 2.5 e 2.0 (corpo de requisição do ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 e SD Video.
POST	`/v1/audio/transcriptions`	Envia um arquivo de áudio para transcrição com o Whisper-1.
POST	`/v1/audio/translations`	Envia um arquivo de áudio para tradução para o inglês com o Whisper-1.
GET	`/v1/tasks/{id}`	Lê o estado e o resultado de uma tarefa de imagem, vídeo ou áudio.

Imagens, vídeos e áudios de referência são passados como URLs no corpo da requisição. Uma requisição de imagem vira uma edição quando inclui imagens de entrada. A referência de cada modelo lista seus parâmetros.

Endpoints de texto

Método	Caminho	Formato de requisição
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, em streaming
GET	`/v1/models`	Lista os modelos disponíveis

Nem todo modelo de texto aceita todos os formatos. A referência de API do modelo informa quais ele aceita; por exemplo, o Claude Opus 5.5 aceita Chat Completions, Responses e Messages, enquanto os modelos de texto do Gemini usam os caminhos /v1beta.

Ciclo de vida da requisição

Tarefas de mídia

Envie a requisição. A resposta é uma tarefa, não o arquivo pronto: guarde o id dela.
Consulte a tarefa até que ela chegue a um estado final. As tarefas em /v1/tasks/{id} informam processing e depois completed ou failed.
Leia o resultado. As imagens ficam em output.data[].url, os vídeos em output.video_url e a saída do Whisper em output.url. Todos os links de resultado apontam para o armazenamento do SeedRouter.

Em caso de falha, verifique error.code e error.message. Tarefas que falham não são cobradas. Não há webhook de conclusão; consulte a tarefa conforme descrito em Webhooks.

Requisições de texto

Uma requisição de texto devolve a resposta do modelo na mesma resposta, com a estrutura oficial do fornecedor. Defina stream como true, ou use :streamGenerateContent no Gemini, para receber server-sent events (SSE). Os modelos de texto são cobrados por token.