Запрос Seedream V4 Edit Sequential API актуален, когда команда хочет отредактировать изображение и оценить поведение сгруппированных изображений в рамках документированного API-процесса. В настоящее время в документации OdiRouter указаны seedream-4.0, его конечная точка очереди, элементы управления последовательными изображениями и URL-адреса, используемые для проверки отправленного запроса. Прежде чем внедрять этот процесс в продукт, подтвердите актуальную запись модели и цену в OdiRouter.
Перед интеграцией проверьте доступность.
Пример кода не может сообщить вам, что доступно вашей учётной записи сегодня. Проверьте OdiRouter models catalog, затем ознакомьтесь с current pricing перед отправкой рабочего трафика. Эти страницы являются источником достоверной информации о доступности и стоимости модели.
В официальной документации Seedream 4.0 API reference указаны идентификатор модели seedream-4.0 и конечная точка очереди https://api.odirouter.ai/model/v1/queue/seedream-4.0. Аутентифицируйте запросы с помощью API-ключа OdiRouter. Храните ключ в хранилище секретов или переменной среды, но никогда не в коде браузера, репозитории или промпте.
Начните с небольшого последовательного запроса
Документированное тело запроса включает входное изображение, промпт, sequential_image_generation и параметры управления выводом. В справочной документации описаны auto и disabled для sequential_image_generation. При использовании auto параметр sequential_image_generation_options.max_images задаёт максимальное количество изображений для запроса.
curl --request POST "https://api.odirouter.ai/model/v1/queue/seedream-4.0" \
--header "Authorization: Bearer $ODIROUTER_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "Create three product variations with the same composition and a warm studio background.",
"image": "https://example.com/reference.png",
"sequential_image_generation": "auto",
"sequential_image_generation_options": { "max_images": 3 },
"stream": false,
"response_format": "url"
}'В собственной интеграции используйте доступный URL-адрес изображения или документированный формат входных данных. Начав с небольшого количества изображений, вы упростите проверяющему сравнение набора до расширения кампании или пакетной задачи.
Рассматривайте max_images как ограничение
Согласно актуальной справочной документации OdiRouter, фактическое количество изображений также зависит от числа входных референсных изображений. max_images помогает ограничить запрос, но не гарантирует, что каждый запрос вернёт именно такое количество материалов. Фиксируйте в собственном рабочем процессе запрошенное количество, входные ссылки, версию промпта и возвращённое количество.
Сделайте первый набор тестов небольшим и воспроизводимым:
Выберите одно исходное изображение с деталями, которые проверяющий сможет распознать, например силуэтом продукта, макетом или утверждённым элементом бренда.
Меняйте по одной инструкции за раз, чтобы причина различий в результатах была понятна.
Проверяйте в каждом результате запрошенное редактирование и любые нежелательные изменения деталей исходного изображения.
Повторите тест после внесения изменений в модель, подсказки или обработку ресурсов, прежде чем запускать рабочий процесс в производство.
Это предоставит вашей команде доказательства соответствия собственным критериям приемки. Это не гарантирует качество, количество выходных изображений или бизнес-результаты, которые дает использование типового примера изображения.
Следуйте ответу очереди
Документированный ответ включает request_id, response_url, status_url, cancel_url и queue_position. Сохраните идентификатор запроса и используйте возвращённые URL-адреса статуса и ответа в жизненном цикле задачи, которым управляет ваше приложение. Это связывает исходную отправку с последующими проверками статуса и получением результатов.
Считайте недоступный или неудавшийся запрос состоянием приложения. HTTP-ответ на отправку не означает, что графические ресурсы готовы. Сообщайте идентификатор запроса, показывайте соответствующий статус и используйте данные ответа только тогда, когда документированный жизненный цикл указывает, что результат доступен.
Решите, как клиент будет получать результаты
Официальный справочник также документирует stream и response_format в примере запроса. Определите, как клиент будет использовать результаты, прежде чем добавлять модель в интерфейс. Ответ в виде URL может подойти для рабочего процесса, в котором сгенерированные ресурсы сохраняются или проверяются после завершения запроса в очереди. Протестируйте streaming с той конфигурацией клиента и модели, которую вы планируете развернуть.
Первый запрос должен быть узким. Исходное изображение, четкие инструкции по редактированию, преднамеренная настройка последовательной генерации и известный формат ответа упрощают отладку по сравнению с большим запросом, содержащим множество изменяемых частей. После того как этот путь заработает, протестируйте ограничения, важные для вашей команды, включая доступ к ресурсам, тайм-ауты, повторные попытки и утверждение проверяющим.
Перейдите от оценки к интеграции OdiRouter
OdiRouter от getting-started documentation охватывает API-ключи, авторизацию, идентификаторы моделей, первые запросы и настройку SDK. Используйте его вместе со справочником для конкретной модели, а не вместо него. Перед запуском в производственной среде снова проверьте каталог и цены, поскольку на этих страницах содержится актуальная информация о продукте.
Создайте аккаунт OdiRouter, проверьте запись модели и выполните небольшой контролируемый запрос. Документированный запрос в очереди в сочетании с воспроизводимым набором для проверки даёт команде практическую основу для решения, соответствует ли рабочий процесс её потребностям в редактировании изображений.