О модели Qwen Image 3.0
Редактирование Qwen Image 3.0 правит или объединяет от одного до трёх референсов по промпту, включая замену уже имеющегося в кадре текста. Возвращает одно изображение в 1k или 2k, восемь соотношений сторон.
Вызывайте его по имени модели alibaba/qwen-image-3.0/edit через POST /jobs/createTask, от 5 кредитов за изображение (0,05 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · По умолчанию: 1:1 |
enable_prompt_expansion | Нет | Модель дописывает детали к короткому промпту. По умолчанию: true |
image_urls | Да | Фото для правки или объединения. В промпте укажите, что берётся из каждого. |
negative_prompt | Нет | Чего не должно быть в кадре. |
num_outputs | Нет | Сколько результатов сделать за раз. ≥ 1 · ≤ 1 · По умолчанию: 1 |
prompt | Да | Describe the subject, composition, lighting, and any text to render. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 1k · 2k · По умолчанию: 2k |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 4,5 | 0,045 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 5 кредитов за изображение (0,05 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Qwen Image 3.0 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model alibaba/qwen-image-3.0/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "2k",
"num_outputs": 1
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Qwen Image 3.0
Сколько стоит API Qwen Image 3.0?
Qwen Image 3.0 стоит от 5 кредитов (0,05 $) за изображение — на самой дешёвой задаче «Редактировать картинку». Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Qwen Image 3.0 в API?
Укажите alibaba/qwen-image-3.0/text-to-image — Создать картинку; alibaba/qwen-image-3.0/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.
Сколько текста он реально рисует внутри изображения?
Короткие строки держатся хорошо: заголовок, вывеска, этикетка товара, заголовок примерно до восьми слов. Целые абзацы по-прежнему рассыпаются. Всё, что содержит шрифт, генерируйте на ступени 2k.
Сколько изображений возвращает один запрос?
Одно. num_outputs всегда равен 1, поэтому каждый запрос возвращает одно изображение и оценивается и списывается отдельно. Чтобы получить несколько вариантов по одному брифу, отправьте параллельные запросы без seed.
Чем image-to-image отличается от text-to-image?
Редактура добавляет обязательный массив image_urls из одного-трёх источников и сохраняет все остальные поля. Скажите в prompt, что вносит каждый референс: роли модель за вас не распределит.
Читает ли он prompt по-китайски?
Да, напрямую, и параметра языка задавать не нужно. Бюджет в 5000 символов одинаков в обоих случаях, как и обработка процитированных строк.
Можно ли получить то же изображение дважды?
Фиксированный seed помогает ограничить случайные различия, но не гарантирует одинаковый результат.
Какие ограничения у API Qwen Image 3.0?
Разрешения: 1K · 2K; Соотношения сторон: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; Референсные изображения: 3; Длина промпта (символов): 5,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Qwen Image 3.0 без кода?
Да. Playground запускает Qwen Image 3.0 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Qwen Image
Qwen Image 3.0 Pro поднимает потолок для многострочной типографики и тонкой фактуры в финальном кадре.
- Qwen Image 2.1 Pro APIДо шести детальных картинок 2K по одному промптуОт 6 кредитов за изображение
- Qwen Image 2.1 Turbo APIБыстрый рендер за 8 шагов, до шести за разОт 3 кредитов за изображение
- Qwen Image 2.1 APIОткрытая модель: вывод 2K и прозрачный фонОт 4 кредитов за изображение
- Qwen Image 2.1 LoRA APIКартинки и правки Qwen Image 2.1 с тремя твоими LoRAОт 5 кредитов за изображение
- Qwen Image 3.0 Pro APIТонкая типографика и живые кожа, ткань и стеклоОт 6 кредитов за изображение
- Qwen Image 3.0 APIВывески и заголовки прямо на картинке, всё читаемоОт 5 кредитов за изображение
- Qwen Image 2 APIПростая генерация по тексту и правка одного фотоОт 6 кредитов за изображение
- Qwen Image 2512 LoRA APIРендеры и правки Qwen Image 2512 с твоими LoRAОт 5 кредитов за изображение
- Qwen Image Edit 2509 LoRA APIПравки Qwen по нескольким фото с загрузкой твоих LoRAОт 5 кредитов за изображение
- Qwen Image 1.0 LoRA APIПервый Qwen-Image: чистые надписи и твои LoRAОт 5 кредитов за изображение
