Wan 2.7 Image Pro API | OdiRouter

Редакция OdiRouter

API Wan 2.7 Image Pro предоставляет командам документированный способ генерации изображений и асинхронный поток задач, который можно протестировать до внедрения в продукт. OdiRouter указывает маршрут wan2.7-image-pro для генерации и редактирования изображений. Вы создаёте задачу, получаете идентификатор запроса и используете его для отслеживания выполнения задачи до получения результата.

Это руководство по внедрению OdiRouter. Оно опирается на актуальную документацию маршрута: доступные конечные точки, документированные настройки изображений и проверки, которые стоит выполнить перед запуском в production.

Что говорится в документации OdiRouter

OdiRouter описывает Wan 2.7 Image Pro как профессиональную модель изображений для высококачественной творческой работы. В документации отмечаются обработка сложных инструкций, несколько референсных изображений и точное редактирование. Идентификатор маршрута — wan2.7-image-pro.

API использует асинхронный поток выполнения. Отправьте POST /v1/queue/wan2.7-image-pro, чтобы создать задачу. Возвращённый идентификатор запроса позволяет проверить статус, получить результат или отменить запрос. Это гораздо полезнее, чем держать запрос клиента открытым, пока изображение еще находится в процессе генерации.

Создайте небольшую тестовую задачу

Используйте базовый URL модели OdiRouter и собственный API-ключ. Начните с компактного запроса, чтобы подтвердить подключение и изучить результат, прежде чем создавать более крупный конвейер промптов.

curl --location "https://api.odirouter.ai/model/v1/queue/wan2.7-image-pro" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            { "text": "A clean product photograph of a ceramic coffee cup on a wooden table." }
          ]
        }
      ]
    },
    "parameters": {
      "size": "2K",
      "n": 1,
      "watermark": false,
      "seed": 12345
    }
  }'

В ответе на запрос о создании задачи содержится идентификатор запроса и URL-адреса для отображения статуса, получения ответа и отмены. Сохраните этот идентификатор запроса вместе с записью о задаче в вашем приложении. Затем обработчик или клиент сможет продолжить выполнение той же задачи, а не создавать её заново.

Проверьте статус, затем получите результат

После создания задачи вызывайте URL статуса, пока задача не достигнет конечного состояния. Затем вызовите URL-адрес ответа, чтобы получить полный результат. Если пользователь выходит из процесса или поставленная в очередь задача больше не нужна, используйте задокументированную конечную точку отмены вместо того, чтобы считать отсутствие ответа успехом.

Эти состояния также полезны как записи на уровне приложения: создана, ожидает, завершена, результат получен, отменена или завершилась с ошибкой. Сохраняйте их вместе с версией промпта и идентификатором корреляции на уровне приложения. Затем вы сможете сравнивать изменения параметров или промпта, не обещая, что два сгенерированных изображения будут точно совпадать.

Выберите размер и количество выходных изображений для отправляемой задачи

Для запросов преобразования текста в изображение без входных изображений и без последовательного режима OdiRouter документирует варианты размеров 1K, 2K и 4K. Сценарии с входными изображениями и другие задокументированные сценарии имеют иные ограничения. Проверяйте актуальную справку по модели для отправляемого режима, а не предполагайте, что каждый размер применим везде.

Параметр n влияет на стоимость, поскольку он контролирует количество успешно сгенерированных изображений. Начните с одного изображения и репрезентативного вопроса. Проверяйте композицию, следование инструкциям и задержку в вашей собственной среде. Затем расширьте тестовый набор, включив в него размеры и количество, которые действительно необходимы для данного продукта.

Перед запуском производства

  • Сохраняйте идентификатор запроса и обрабатывайте состояния статуса, результата, отмены и ошибки.

  • Убедитесь, что промпты и входные данные референс-изображений соответствуют текущим задокументированным ограничениям.

  • Выберите размер, поддерживаемый отправляемым режимом задачи.

  • Осознанно выбирайте количество выходных изображений, поскольку оно влияет на стоимость сгенерированных изображений.

  • Протестируйте небольшой воспроизводимый набор промптов, прежде чем расширять нагрузку.

  • Прежде чем полагаться на сведения о доступности или ценах, ознакомьтесь с текущей документацией по маршрутам и каталогом моделей.

Продолжить с OdiRouter

Прочитайте Wan 2.7 Image Pro API reference, чтобы ознакомиться с актуальными спецификациями конечной точки и параметров. Просмотрите OdiRouter models catalog, чтобы узнать о доступных маршрутах. Если вы настраиваете более широкую интеграцию, начните с OdiRouter getting-started guide.

Источники

#API Wan 2.7 Image Pro#API для преобразования текста в изображение#API для работы с изображениями OdiRouter#генерация изображений.