Alibaba
Qwen Image 3.0
qwen-image-3.0-pro/image-to-image
Модель третьего поколения Alibaba для генерации и редактирования изображений, отличается плотной вёрсткой текста при длинных промптах и многоязычным рендерингом, поддерживает редактирование по референсному изображению
Попробовать qwen-image-3.0-pro/image-to-image
Ввод
Работы
Все работыВывод
imageЦены
qwen-image-3.0-pro/image-to-image per image
| Характеристики | Цена за единицу |
|---|---|
| 1K | $0.0497 |
| 2K | $0.0993 |
Краткое описание
Линейка редактирования изображений Qwen Image 3.0 Pro позволяет управляемо изменять изображение на основе 1–3 референсных изображений, сохраняя ключевые детали оригинала при замене сцены, стиля, одежды или текста на изображении. Подходит дизайнерским, e-commerce и контент-командам, которым нужна многократная итерация одного и того же материала: через единый интерфейс HiAPI.ai достаточно описать в промпте, что сохранить, а что изменить, чтобы получить готовое изображение. Удобно для превращения существующих визуальных активов в многовариантные материалы.
Ключевые особенности
- Итерация по референсу, а не перерисовка — в качестве основы используются 1–3 референсных изображения, а указанное содержимое изменяется с сохранением ключевых деталей оригинала.
- Ориентация на информационно насыщенные изображения — промпт может описывать плотное содержимое: вёрстку, элементы и текст, — а результат ближе к реальным рабочим материалам.
- Управляемые параметры вывода — разрешение, соотношение сторон, формат вывода и случайное зерно можно задавать, что удобно для пакетного производства материалов единого формата.
Возможности
Редактирование с несколькими референсами: принимает 1–3 референсных изображения в распространённых форматах, включая JPEG, PNG, WEBP, BMP, GIF и TIFF; каждое не более 10 МБ. Может использоваться для направленных изменений сцены, стиля и одежды.
Длинные промпты для описания изменений: позитивный промпт до 18000 символов, в нём можно отдельно указать, что нужно сохранить, а что изменить; негативный промпт отдельно управляет нежелательным содержимым.
Настройка вёрстки и текста: для насыщенных элементами изображений можно менять компоновку и текстовое содержимое — подходит для создания новых версий существующих постеров, макетов интерфейсов и изображений товаров.
Управление параметрами вывода: доступны разрешение 1K или 2K, восемь соотношений сторон и форматы вывода png и jpeg, а также фиксированное зерно для воспроизведения результата.
Автоматическая оптимизация промпта: по умолчанию включено расширение промпта, которое дополняет детали при коротком описании; его можно отключить, чтобы выполнять запрос строго по исходному тексту.
Сценарии использования
- Обновление постеров и баннеров дизайн-командой — на вход подаются текущий макет и описание изменений, на выходе получается новая версия с обновлёнными размерами и текстом, готовая к размещению и замене материалов.
- Переработка изображений товаров для e-commerce — на основе существующего изображения товара заменяются фон, сцена или одежда модели, создаётся несколько комплектов изображений для карточек товара и промостраниц.
- Итерация концептов UI — на вход подаётся эскиз интерфейса или текущий макет, по промпту изменяются компоновка и отображение элементов; результат используется как высокодетализированный прототип для обсуждения решений.
- Локализация материалов для разных языков — на основе одного исходного материала заменяются текст и язык изображения, пакетно создаются версии для разных рынков для локализованных кампаний.
Ограничения и рекомендации по выбору
Максимум 3 референсных изображения, поэтому сложные сценарии с композицией из многих изображений ограничены; ввод SVG не поддерживается, одно референсное изображение не должно превышать 10 МБ. Читаемость вёрстки и текста зависит от плотности компоновки и языка; мелкий плотный текст всё равно нужно проверять выборочно. Эта линейка работает только в режиме «изображение в изображение»; если нужно генерировать изображение только по тексту, следует использовать линейку «текст в изображение» той же серии. Для пакетных задач с высокими требованиями к стабильности результата рекомендуется фиксировать зерно и сохранять версии промптов для воспроизведения.
Новости
Смотреть changelog →- Новая модель Новая модель: qwen-image-3.0-pro/text-to-image
- Новая модель Запущена модель преобразования изображений qwen-image-3.0-pro
- Новая модель Добавлена документация для qwen-image-3.0/text-to-image…
Частые вопросы
Все частые вопросы →-
Сколько референсных изображений поддерживает редактирование изображений в Qwen Image 3.0?
Поддерживается от 1 до 3 референсных изображений. Требуется как минимум одно, поле API — input.image_urls.
-
В чём разница между редактированием изображений в Standard и Pro?
Стандартная версия делает акцент на более низкой стоимости и быстрой итерации; Pro лучше подходит для точной замены текста, сложных материалов и финальной вёрстки.
-
Как тарифицируются 1K, 2K и референсные изображения?
1K и 2K используют один и тот же тарифный уровень вывода, за каждое референсное изображение взимается дополнительная плата; конкретные суммы указаны в актуальных ценах на этой странице.
-
Как уменьшить смещение субъекта, макета или текста?
В Prompt отдельно перечислите то, что нужно изменить, и то, что необходимо сохранить: субъект, текст, положение, материалы, ракурс камеры и освещение; если нужен точный текст, заключите целевой текст в кавычки.
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: qwen-image-3.0-pro/image-to-image
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для qwen-image-3.0-pro/image-to-image и маршрута default — см. таблицу параметров ниже.
seedintegerНеобязательноmin 0max 2147483647Случайное зерно, управляющее случайностью результата генерации; при одинаковом зерне и прочих равных параметрах можно воспроизвести похожий результат изображения.
promptstringОбязательноminLength 1maxLength 18000Позитивный промпт, описывающий содержимое изображения, которое нужно сохранить и которое нужно изменить; является основным управляющим входом для генерации изображения по изображению.
image_urlsarrayОбязательноminItems 1maxItems 3Массив URL референсных изображений, задающий входные изображения, на которых основана генерация изображения по изображению; требуется предоставить 1–3 изображения в форматах JPEG, PNG, WEBP, BMP, GIF, TIFF, каждое не более 10 MB, SVG не поддерживается.
Array [ string ]
resolutionstringНеобязательноПо умолчанию: "1K"Уровень разрешения выходного изображения, управляющий степенью чёткости генерируемой картинки; по умолчанию 1K.
1K2Kaspect_ratiostringНеобязательноПо умолчанию: "1:1"Соотношение сторон выходного изображения, управляющее размерами композиции генерируемой картинки; по умолчанию 1:1.
1:13:22:34:33:416:99:1621:9output_formatstringНеобязательноПо умолчанию: "png"Формат файла генерируемого изображения, управляющий типом файла возвращаемого результата; по умолчанию png.
pngjpegprompt_extendbooleanНеобязательноПо умолчанию: trueАвтоматически ли оптимизировать промпт; при включении модель расширяет и дорабатывает входной промпт; по умолчанию true.
negative_promptstringНеобязательноПо умолчанию: ""maxLength 500Негативный промпт, описывающий содержимое, которое не должно появляться на изображении; по умолчанию пустая строка.
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-3.0-pro/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png",
"prompt_extend": true,
"negative_prompt": ""
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "qwen-image-3.0-pro/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png",
"prompt_extend": true,
"negative_prompt": ""
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "qwen-image-3.0-pro/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "png",
"prompt_extend": True,
"negative_prompt": ""
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
Похожие модели
Все модели →Тот же тип
-
FIBO 1.5 Bria $0.058 /изображение -
Recraft Creative Upscale Recraft $0.357 /изображение -
Qwen Image 2.1 Alibaba $0.020 /изображение -
FASHN Tryon v1.6 FASHN $0.107 /изображение -
FLUX 1.1 Pro Black Forest Labs $0.050 /изображение -
Grok Imagine Quality xAI $0.070 /изображение -
Qwen Image 2.0 Alibaba $0.042 /изображение -
FLUX.1 Kontext Max Black Forest Labs $0.071 /изображение -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /изображение -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /изображение -
BRIA Eraser Bria $0.058 /изображение -
Ideogram V4 Ideogram $0.050 /изображение
Тот же вендор
-
Z-Image Alibaba $0.008 /изображение -
Qwen Audio 3.0 TTS Alibaba $0.030 /1 000 символов -
Qwen Image 2.0 Alibaba $0.042 /изображение -
Qwen Image 3.0 Alibaba $0.036 /изображение -
HappyHorse 1.1 Alibaba $0.160 /секунду -
Wan 2.7 Image Alibaba $0.035 /изображение -
Wan 2.7 Video Alibaba $0.100 /секунду -
Qwen Image 2.1 Alibaba $0.020 /изображение -
HappyHorse 1.0 Alibaba $0.168 /секунду -
Wan 3.0 Video Alibaba $0.040 /секунду -
Wan 2.6 Flash Alibaba $0.043 /секунду





