API Reference
Обзор
Конечные точки и соглашения асинхронного API изображений.
SeedRouter предоставляет модели для изображений, видео, аудио и текста через один API и один API-ключ. Модели изображений, видео и аудио работают как асинхронные задачи: вы отправляете запрос, получаете ID задачи и опрашиваете её, чтобы забрать результат. Текстовые модели отвечают сразу, в формате запросов поставщика модели.
Базовый URL
https://api.seedrouter.aiИспользуйте HTTPS и отправляйте тела запросов в JSON. Аудиоэндпоинты вместо этого принимают загрузку файла в multipart/form-data.
Аутентификация
Передавайте ключ как Bearer-токен в каждом запросе, включая запросы статуса задачи:
Authorization: Bearer YOUR_API_KEYЭндпоинт Anthropic Messages также принимает ключ в x-api-key вместе с заголовком anthropic-version. Подробнее в разделе Аутентификация.
Эндпоинты медиазадач
| Метод | Путь | Назначение |
|---|---|---|
| POST | /v1/images/generations | Отправляет задачу на генерацию или редактирование изображения: GPT Image, Nano Banana и Midjourney. |
| POST | /v1/videos/generations | Отправляет видеозадачу: Seedance 2.5 и 2.0 (тело запроса ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 и SD Video. |
| POST | /v1/audio/transcriptions | Отправляет аудиофайл на транскрибацию с помощью Whisper-1. |
| POST | /v1/audio/translations | Отправляет аудиофайл на перевод на английский с помощью Whisper-1. |
| GET | /v1/tasks/{id} | Возвращает состояние и результат задачи для изображения, видео или аудио. |
Референсные изображения, видео и аудио передаются как URL в теле запроса. Запрос изображения становится редактированием, если в нём есть входные изображения. Параметры каждой модели перечислены в её справочнике.
Текстовые эндпоинты
| Метод | Путь | Формат запроса |
|---|---|---|
| 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, потоковая передача |
| GET | /v1/models | Возвращает список доступных моделей |
Не каждая текстовая модель поддерживает все форматы. В справочнике API модели указано, какие форматы она принимает: например, Claude Opus 5.5 принимает Chat Completions, Responses и Messages, а текстовые модели Gemini используют пути /v1beta.
Жизненный цикл запроса
Медиазадачи
- Отправьте запрос. В ответ приходит задача, а не готовый файл: сохраните её
id. - Опрашивайте задачу, пока она не перейдёт в конечное состояние. Задачи на
/v1/tasks/{id}сообщаютprocessing, затемcompletedилиfailed. - Заберите результат. Изображения находятся в
output.data[].url, видео — вoutput.video_url, результат Whisper — вoutput.url. Все ссылки на результаты ведут в хранилище SeedRouter.
При сбое изучите error.code и error.message. Неуспешные задачи не тарифицируются. Webhook о завершении нет: опрашивайте задачу, как описано в разделе Webhooks.
Текстовые запросы
Текстовый запрос возвращает ответ модели в том же ответе, в официальной структуре ответа поставщика. Установите stream в true или используйте :streamGenerateContent для Gemini, чтобы получать server-sent events (SSE). Текстовые модели тарифицируются за токены.