Wan 2.7 Image Pro
wan2.7-image-pro
Wan 2.7 Image Pro — профессиональная модель изображений для высококачественной креативной работы с улучшенным выводом в высоком разрешении, следованием сложным инструкциям, поддержкой нескольких референсных изображений и точным редактированием для визуалов коммерческого уровня.
Эндпоинты
POST /v1/queue/wan2.7-image-pro # Создать задачуGET /v1/queue/wan2.7-image-pro/requests/{request_id}/status # Проверить статусGET /v1/queue/wan2.7-image-pro/requests/{request_id}/response # Получить результатPUT /v1/queue/wan2.7-image-pro/requests/{request_id}/cancel # Отменить задачуПараметры запроса
Заголовок раздела «Параметры запроса»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 photo of a ceramic coffee cup on a wooden table." } ] } ] }, "parameters": { "size": "2K", "n": 1, "watermark": false, "seed": 12345 } }'Основная входная информация.
Массив содержимого запроса. Сейчас поддерживается только один раунд диалога: передается один набор параметров role и content. Многораундовый диалог не поддерживается.
Роль сообщения. Этот параметр должен быть установлен в user.
Массив содержимого сообщения.
Пользовательский промпт. Поддерживаются китайский и английский языки. Максимальная длина — 5000 символов; каждый китайский иероглиф, буква, цифра или символ считается одним символом. Содержимое сверх лимита автоматически обрезается.
URL входного изображения или строка Base64.
Ограничения изображения:
Форматы: JPEG, JPG, PNG без прозрачного канала, BMP, WEBP.
Разрешение: ширина и высота должны быть в диапазоне [240, 8000] пикселей; диапазон соотношения сторон — [1:8, 8:1].
Размер файла: не более 20MB.
Ограничения количества изображений:
Можно передать от 0 до 9 изображений.
При передаче нескольких изображений добавьте несколько объектов image в массив content; порядок изображений определяется порядком в массиве.
Поддерживаемые форматы ввода:
Публично доступный URL: поддерживаются HTTP и HTTPS. Пример: http://wanx.alicdn.com/material/xxx.jpeg.
Строка изображения в Base64. Формат: data:{MIME_type};base64,{base64_data}.
Пример: data:image/jpeg;base64,GDU7MtCZzEbTbmRZ.... Это только пример; в реальном запросе передавайте полную строку.
Конфигурация параметров модели.
Управляет режимом генерации.
false: значение по умолчанию.
true: включает режим вывода серии изображений.
Разрешение выходного изображения. Поддерживаются два способа, их нельзя смешивать.
Способ 1: указать разрешение выходного изображения (рекомендуется). Поддерживаются 1K, 2K (по умолчанию) и 4K.
Область применения: text-to-image без входных изображений и без режима серии изображений поддерживает 1K, 2K и 4K; остальные сценарии поддерживают 1K и 2K.
Общее число пикселей по уровням: 1K — 1024*1024, 2K — 2048*2048, 4K — 4096*4096.
Соотношение сторон: при наличии входного изображения выходное соотношение сторон совпадает с входным изображением; при нескольких входных изображениях — с последним входным изображением, затем масштабируется до выбранного разрешения. Если входных изображений нет, результат будет квадратным.
Способ 2: указать ширину и высоту генерируемого изображения в пикселях. Для text-to-image общее число пикселей должно быть в диапазоне [768*768, 4096*4096], а соотношение сторон — [1:8, 8:1]. Для остальных сценариев общее число пикселей должно быть в диапазоне [768*768, 2048*2048], а соотношение сторон — [1:8, 8:1].
Фактические пиксельные размеры выходного изображения могут немного отличаться от указанных.
Важно: n напрямую влияет на стоимость. Стоимость = цена за единицу × количество успешно сгенерированных изображений.
Когда режим серии изображений выключен, это количество генерируемых изображений. Диапазон: 1 - 4. По умолчанию: 1.
Когда режим серии изображений включен, это максимальное количество генерируемых изображений. Диапазон: 1 - 12. По умолчанию: 12. Фактическое количество определяется моделью и не превышает n.
Включать ли режим размышления. По умолчанию: true. Действует только при выключенном режиме серии изображений и отсутствии входных изображений. При включении модель усиливает рассуждение для повышения качества изображения, но генерация занимает больше времени.
Пользовательская цветовая тема: массив объектов с цветом (hex) и долей (ratio). Требуется от 3 до 10 цветов; рекомендуется 8 цветов.
Доступно только при выключенном режиме серии изображений (enable_sequential=false).
Цветовое значение в шестнадцатеричном формате (HEX).
Процентная доля цвета с точностью до двух знаков после запятой, например "25.00%". Сумма всех значений ratio должна быть 100.00%.
Добавлять ли водяной знак. Водяной знак расположен в правом нижнем углу изображения, фиксированный текст — «AI生成».
false: значение по умолчанию, не добавлять водяной знак.
true: добавить водяной знак.
Случайное зерно, диапазон: [0,2147483647].
Использование одного и того же значения seed может сделать результат относительно стабильным. Если параметр не передан, алгоритм автоматически использует случайное зерно.
Примечание: генерация имеет вероятностный характер. Даже при одинаковом seed полное совпадение результата не гарантируется.
Параметры ответа
Заголовок раздела «Параметры ответа»{ "request_id": "mmsu_01hxyz...", "response_url": "https://api.odirouter.ai/model/v1/queue/wan2.7-image-pro/requests/mmsu_01hxyz.../response", "status_url": "https://api.odirouter.ai/model/v1/queue/wan2.7-image-pro/requests/mmsu_01hxyz.../status", "cancel_url": "https://api.odirouter.ai/model/v1/queue/wan2.7-image-pro/requests/mmsu_01hxyz.../cancel", "queue_position": 0}| Поле | Тип | Описание |
|---|---|---|
request_id | string | Идентификатор задачи для последующей проверки статуса, получения результата и отмены |
response_url | string | URL для получения итогового результата |
status_url | string | URL для проверки статуса задачи |
cancel_url | string | URL для отмены задачи |
queue_position | int | Текущая позиция в очереди |