API последовательного создания изображений Seedream 5.0 Lite предоставляет разработчику документированный способ запросить группу связанных изображений через асинхронную очередь. OdiRouter предоставляет конечную точку очереди и URL-адреса возвращаемых задач. Сначала ознакомьтесь со справочником модели и используйте указанные в нём URL-адреса, не предполагая, что изображение готово немедленно.
Что включает в себя обозначение OdiRouter
OdiRouter документирует модель создания и редактирования изображений. В справочнике Seedream 5.0 Lite перечислена поддержка преобразования текста в изображение, изображения в изображение, множественных референсов и последовательного создания. В нём также перечислены несколько вариантов размера и выходного формата, а также жизненный цикл асинхронной очереди.
В приведенном ниже примере запроса показана документированная конечная точка очереди. Успешная отправка возвращает request_id. Справочник также содержит URL-адреса для проверки состояния, получения результата и отмены задачи. Сохраните идентификатор вместе с записью задания, чтобы приложение могло отслеживать выполнение задачи, не рассматривая запрос из очереди как завершенное изображение.
Осознанно включайте группу последовательных изображений
Поле sequential_image_generation управляет созданием группы. Значение по умолчанию — disabled. Установите auto, когда запрос должен допускать группу связанных изображений. Объект параметров задаёт максимальное количество выходных изображений для запроса.
Используйте max_images, чтобы задать верхнюю границу для запроса. В справочнике указаны фиксированные нижний и верхний пределы для этого поля, а также общий лимит для референсных и созданных изображений. Модель может решить, возвращать ли группу и сколько изображений в неё включать, поэтому код должен обрабатывать ответ, а не обещать пользователям фиксированное количество изображений.
Отправьте запрос через OdiRouter
Храните API-ключ в переменной окружения и вызывайте конечную точку очереди из серверного кода. В этом примере в качестве максимального размера группы используется три, а также запрашивается непотоковый вывод JPEG.
# max_images accepts values from 1 through 15.
# Reference images plus generated images must not exceed 15.
curl --request POST "https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite" \
--header "Authorization: Bearer ${ODIROUTER_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
"prompt": "Create three related editorial images of a coastal bookstore at sunrise.",
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
"max_images": 3
},
"size": "2K",
"stream": false,
"output_format": "jpeg"
}'В качестве входных данных для эталонного изображения в рабочем процессе также принимается image в виде URL-адреса или значения Base64. Проверяйте URL-адреса и ограничения для изображений в своём приложении перед отправкой задачи.
Проверяйте состояние задачи перед получением результата
Успешная отправка данных позволяет определить URL-адрес состояния задачи. Он также указывает URL-адрес для результата и URL-адрес для отмены. Опрашивайте URL-адрес состояния, используя тот же заголовок авторизации. Когда задача достигнет состояния завершения, запросите URL-адрес ответа для выходных данных модели. Если пользователь отказывается от задания, используйте документированную конечную точку отмены, чтобы состояние приложения оставалось понятным.
Рабочий процесс очереди прост: отправьте запрос один раз, сохраните идентификатор задачи, проверьте состояние задачи, затем получите результат. Это также даёт команде продукта чёткое место для добавления повторных попыток, тайм-аутов и обновлений прогресса.
Проверяйте сведения о модели перед использованием в продакшене
Параметры и доступность могут измениться. Перед выпуском ознакомьтесь с текущим Seedream 5.0 Lite API reference, следуйте OdiRouter Quick start для настройки API-ключа и используйте каталог моделей, чтобы подтвердить текущие варианты.