Для рабочего процесса обработки изображений через API Seedream 5 сначала проверьте точную модель, указанную в документации вашей платформы. Документ OdiRouter содержит информацию о товаре Seedream 5.0 Lite под идентификатором модели seedream-5.0-lite. В его документации перечислены генерация текста в изображение, преобразование изображения в изображение, генерация с несколькими референсами, генерация серий изображений, размеры 2K/3K, вывод PNG/JPEG, потоковый вывод и опциональный веб-поиск. Перед подключением производственного приложения снова проверьте актуальную страницу модели.
Подтвердите точную модель перед интеграцией
«Seedream 5» может обозначать семейство моделей, а не единую взаимозаменяемую конечную точку. На OdiRouter на странице модели указаны Seedream 5.0 Lite и его API-маршрут. Эта деталь влияет на выбор параметров, проверку ответа и любое сравнение с другой моделью изображений.
Прочтите Seedream 5.0 Lite API reference перед написанием интеграции. Это актуальный источник сведений о поддерживаемых полях и поведении ответов. Для более широкого поиска просмотрите модели изображений OdiRouter, вместо того чтобы предполагать, что вариант с похожим названием принимает те же входные данные.
Изучите асинхронный поток запросов
В документированном примере OdiRouter используется следующая конечная точка асинхронной очереди:
https://api.odirouter.ai/model/v1/queue/seedream-5.0-liteЗапрос изображения имеет жизненный цикл задачи, а не возвращает изображение немедленно. Документированный ответ включает идентификатор запроса и URL-адреса для проверки статуса, получения результата и отмены. Сохраните идентификатор запроса, опрашивайте конечную точку статуса с ограниченным числом повторных попыток и получайте результат только после того, как задача достигнет успешного конечного состояния.
Такой подход также упрощает анализ сбоев. Запишите собственный идентификатор корреляции, метку времени запроса, идентификатор выбранной модели и идентификатор возвращенной задачи. Если запрос не удался, безопасно покажите оператору ответ поставщика, не записывайте ключи API в журналы и решите, можно ли повторить попытку, прежде чем отправлять следующее задание.
Продуманно подготовьте запрос на генерацию изображения
В официальной документации указано, что Seedream 5.0 Lite поддерживает работу по схеме «текст в изображение» и «изображение в изображение». Чётко укажите в промпте объект, композицию, освещение, материал и все важные ограничения. Если вы используете референсное изображение, перед отправкой проверьте в приложении его URL-адрес, права владения и формат.
Выбирайте настройки вывода в соответствии с задачей. Работы, чувствительные к деталям, могут требовать иного процесса проверки, чем черновые концепции, поэтому сохраняйте выбор модели и настройки запроса вместе с заданием.
Отправьте минимально оформленный запрос.
В этом примере используется описанный шаблон конечной точки и поля. Замените ключ-заполнитель и пример URL-адреса изображения в собственной защищённой среде. Не размещайте настоящий ключ в клиентском коде или публичном репозитории.
curl --request POST 'https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite' \
--header 'Authorization: Bearer YOUR_ODIROUTER_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "A product photo of a reusable water bottle on a pale stone surface, soft daylight, clean commercial composition.",
"image": "https://example.com/reference-image.png",
"sequential_image_generation": "disabled",
"stream": false,
"size": "2K"
}'Для задач «текст в изображение» отправляйте только те поля, которые требуются актуальной справочной документацией по модели. Для задач «изображение в изображение» или работы с несколькими референсами перед отправкой файлов или URL-адресов подтвердите актуальные правила ввода. Страница модели надёжнее скопированного фрагмента, поскольку поддерживаемые параметры могут меняться.
Внедрите в рабочую среду проверки результата
Принятый API-запрос — это лишь начало рабочего процесса. После завершения задачи убедитесь, что URL-адрес результата присутствует, получите ресурс в соответствии с собственными правилами хранения и доступа и проверьте основные параметры, такие как MIME-тип, размеры и доступность файла. Держите политики обработки промптов и ресурсов отдельно от вызова генерации, чтобы некорректный ввод не проходил незамеченным.
Для пакетной обработки явно определите поведение при параллельном выполнении и повторных попытках. Установите короткий ограниченный интервал опроса, общий крайний срок и четкий порядок проверки по истечении этого срока. При изменении шаблона запроса или размера выходных данных сохраните это изменение вместе с заданием, чтобы последующие результаты оставались сопоставимыми.
Перед запуском проверьте актуальные цены и документацию
Наличие моделей и цены могут меняться. В документации в настоящее время указаны варианты размера 2K и 3K, а также PNG и JPEG в качестве поддерживаемых форматов вывода. Перед подтверждением рабочего процесса ознакомьтесь с текущими версиями OdiRouter pricing page, Seedream 5.0 Lite API reference и OdiRouter getting-started documentation. На этих страницах можно подтвердить модель, схему запроса и настройки учётной записи, применимые при развёртывании.
Часто задаваемые вопросы
Какая модель задокументирована?
В сохранённой документации OdiRouter указаны Seedream 5.0 Lite и идентификатор модели seedream-5.0-lite. Прежде чем полагаться на конкретный вариант или параметр, проверьте актуальную справочную информацию о модели.
Поддерживает ли описанная в документации модель работу «изображение в изображение»?
Да. На странице модели OdiRouter указано, что Seedream 5.0 Lite поддерживает рабочие процессы «текст в изображение» и «изображение в изображение», а также генерацию с несколькими референсами и серий изображений. Перед реализацией подтвердите актуальные поля ввода и ограничения в официальной справочной документации.
Почему приложению следует выполнять опрос, а не предполагать, что результат изображения будет доступен сразу?
Документированная конечная точка возвращает поля ответа, ориентированные на задачу, включая идентификатор запроса и URL-адреса для получения статуса и результата. Ограниченный по времени процесс опроса позволяет приложению отслеживать завершение, останавливаться по истечении срока и целенаправленно обрабатывать сбои.
С чего начать работу с OdiRouter?
Начните с OdiRouter documentation, ознакомьтесь с каталогом моделей, а затем используйте официальную справочную документацию по модели, чтобы выбрать структуру запроса. Затем откройте OdiRouter, чтобы продолжить интеграцию.
Следующий шаг
Используйте Seedream 5.0 Lite API reference, чтобы проверить актуальную схему запроса, затем протестируйте небольшой наблюдаемый рабочий процесс с OdiRouter. Храните технические литералы, идентификаторы задач и учётные данные отдельно от локализованного содержимого и журналов приложения.