API Seedream 5.0 Lite описан ниже.
В этом руководстве рассматриваются тело запроса, проверка входных данных и асинхронный процесс получения результатов.
Опубликованная документация содержит справочные сведения по этому API для конкретной модели. Перед развертыванием изменений проверьте указанный ниже исходный URL.
https://odirouter.ai/docs/api-reference/model-api/bytedance/seedream-5-0-lite
На странице модели указана конечная точка для этого API изображений.
Сначала проверьте входные данные
Подсказка обязательна. Поле image принимает общедоступный URL или URL данных Base64.
Запрос может включать несколько эталонных изображений в пределах установленных ограничений. Поддерживаются форматы JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC и HEIF.
Размер входного изображения может составлять до 30 MB. Его ширина и высота должны обе превышать 14 пикселей. Перед созданием задачи проверьте опубликованные ограничения по соотношению сторон и общему числу пикселей.
Формулируйте запрос прямо и соблюдайте документированные в справочнике модели ограничения.
Создайте задачу в очереди
При отправке задачи в очередь используйте документированный базовый URL мультимодального API и ключ API Bearer.
curl --request POST \
'https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "Turn the supplied product photo into a clean studio illustration.",
"image": "https://example.com/input-image.png",
"sequential_image_generation": "disabled",
"stream": false,
"size": "2K"
}'Используйте документированный предустановленный размер. Значение «ширина × высота» также подходит, если эта пара соответствует опубликованным диапазонам пикселей и соотношений сторон.
Страница модели является источником достоверной информации о параметрах. Неподдерживаемые поля отклоняются.
Получение завершенного запроса
Генерация изображений использует асинхронную очередь. Сохраните идентификатор запроса, полученный при создании задачи. Опрашивайте маршрут статуса с ограниченным числом повторных попыток. Получите ответ после достижения конечного состояния успешного завершения.
POST https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite
GET https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite/requests/{request_id}/status
GET https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite/requests/{request_id}/response
PUT https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite/requests/{request_id}/cancelВызывайте маршрут отмены, когда приложению больше не требуется запрос из очереди. Сохраняйте идентификатор запроса вместе с записью задачи, чтобы пользователи и инструменты поддержки могли найти его позднее.
Держите справочные материалы рядом с интеграцией
На странице модели описаны генерация текста в изображение, генерация изображения в изображение, генерация по нескольким эталонным изображениям, последовательная генерация изображений, вывод в PNG/JPEG, потоковый вывод и дополнительный веб-поиск. Подтвердите актуальные поля по указанному ниже исходному URL.
https://odirouter.ai/docs/api-reference/model-api/bytedance/seedream-5-0-lite
Перед отправкой производственных запросов создайте учетную запись и ключ API. При изменении полей или ограничений модели обращайтесь к официальной документации.