API для редактирования изображений с использованием ИИ позволяет приложению создавать или редактировать изображения с помощью OdiRouter без промежуточного этапа ручного редактирования между запросом и результатом. В документе OdiRouter указан идентификатор модели wan2.7-image-pro. В каждом запросе используется одно сообщение user, которое может сочетать текстовый запрос с входными изображениями, если для редактирования нужны референсы.
Что поддерживает конечная точка модели OdiRouter
Официальное справочное руководство по модели OdiRouter охватывает генерацию изображений, редактирование изображений, несколько референсных изображений, варианты вывода в высоком разрешении и подробные инструкции. Запрос содержит один элемент в input.messages; content этого сообщения может содержать элемент text, элементы image или и то и другое.
Запросы могут быть на китайском или английском языке и содержать до 5,000 символов. Укажите, что необходимо изменить, что должно оставаться узнаваемым и как должна выглядеть итоговая композиция. Если в задании используются ссылки, присвойте каждому изображению отдельный элемент image. Это позволяет чётко сохранить порядок входных данных.
Подготовьте входные и референсные изображения
API принимает общедоступный URL изображения по HTTP или HTTPS либо URL данных Base64. Он поддерживает форматы JPEG, JPG, PNG без альфа-канала, BMP и WEBP. Входное изображение должно иметь размер 20 MB или меньше, а его ширина и высота должны составлять от 240 до 8,000 пикселей. Поддерживаемый диапазон соотношений сторон — от 1:8 до 8:1.
Вы можете отправить от нуля до девяти изображений. При нескольких входных данных модель получает их в том же порядке, что и в массиве content. Проверьте этот порядок в своём рабочем процессе, если запрос назначает каждому референсу отдельную роль.
Выберите размер результата и параметры генерации
Для подходящих запросов преобразования текста в изображение задокументированные значения size: 1K, 2K и 4K. Запрос с входными изображениями сохраняет соотношение сторон входного изображения. При нескольких входных данных, согласно документации, API использует соотношение сторон последнего входного изображения перед масштабированием до выбранного размера.
Вместо этого можно передать явные значения ширины и высоты в пределах задокументированных ограничений по пикселям и соотношению сторон. Выбирайте один метод для каждого запроса: именованный уровень размера или явные размеры. Параметр n определяет, сколько изображений может сгенерировать сервис, а за успешно сгенерированные изображения взимается плата за каждое изображение. Значение seed может сделать повторные запуски относительно стабильными, однако генерация изображений вероятностна, поэтому совпадающие seed не гарантируют идентичный результат.
Отправьте асинхронный запрос на изображение
Отправьте задачу на конечную точку очереди API модели OdiRouter. Храните ключ API в серверной среде, а не в клиентской сборке.
curl --location "https://api.odirouter.ai/model/v1/queue/wan2.7-image-pro" \
--header "Authorization: Bearer $ODIROUTER_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"input": {
"messages": [
{
"role": "user",
"content": [
{ "text": "Create a clean product image from the supplied reference." },
{ "image": "https://example.com/reference.png" }
]
}
]
},
"parameters": {
"size": "2K",
"n": 1,
"watermark": false,
"seed": 12345
}
}'В ответе содержатся следующие данные: request_id, status_url, response_url и cancel_url. Сохраните идентификатор запроса вместе с записью о вашей задаче. Рабочий процесс может проверить статус задачи, получить результат после завершения или отменить поставленную в очередь задачу, которая больше не нужна.
Проверка интеграции перед запуском рабочего процесса в работу.
Перед созданием задачи проверьте формат изображения, размеры, размер файла и общедоступность.
Сохраняйте стабильный порядок референсных изображений и поясняйте роль каждого референса в запросе.
Выбирайте
1K,2Kили4Kтолько там, где это поддерживается типом запроса.Сохраните идентификатор запроса OdiRouter, чтобы при повторах, проверках статуса и получении результата использовалась одна и та же задача.
Используйте фиксированный seed для упрощения итераций, а не как гарантию попиксельно идентичного результата.
Продолжите с документацией OdiRouter
Ознакомьтесь с Wan 2.7 Image Pro API reference, чтобы узнать текущий контракт конечной точки и сведения о параметрах. Для настройки ключа API и первого запроса используйте OdiRouter introduction.