ToAPIsToAPIs
Qwen Image 3.0

Генерация изображений Qwen Image 3.0

Генерация изображений с помощью qwen-image-3.0 и qwen-image-3.0-pro

POST
/v1/images/generations

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

  • Поддерживаются qwen-image-3.0 и qwen-image-3.0-pro
  • Поддерживаются генерация по тексту, редактирование и несколько референсных изображений
  • Можно передать до 3 референсных изображений
  • Доступны разрешения 1K и 2K и 7 соотношений сторон
  • За один запрос создаётся ровно 1 изображение, параметр n должен быть равен 1
  • Генерация выполняется асинхронно; результат доступен по ID задачи

image_urls принимает только общедоступные URL изображений. Base64 Data URI не поддерживаются. Локальные файлы сначала загрузите через API загрузки изображений.

Поддерживаемые модели

МодельТекст-в-изображениеИзображение-в-изображениеРеференсыРезультат
qwen-image-3.0ДаДаДо 3Ровно 1
qwen-image-3.0-proДаДаДо 3Ровно 1

Authorizations

Authorizationstringзаголовокобязательно

Для всех API требуется Bearer Token.

Получите ключ на странице управления API Key:

Authorization: Bearer YOUR_API_KEY

Body

modelstringтелообязательно

Имя модели:

  • qwen-image-3.0
  • qwen-image-3.0-pro
promptstringтелообязательно

Описание изображения или инструкция по редактированию. Пустая строка не допускается.

sizestringтело

Соотношение сторон результата:

1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3

Также принимается размер в пикселях WIDTH*HEIGHT или WIDTHxHEIGHT. Площадь должна быть от 512*512 до 2048*2048, а соотношение сторон — от 1:8 до 8:1. Если параметр не указан, размер выбирает модель.

resolutionstringтелопо умолчанию: 1K

Уровень разрешения при передаче соотношения сторон:

  • 1K - по умолчанию
  • 2K

Допускается также metadata.resolution, но рекомендуется верхнеуровневое поле.

nintegerтелопо умолчанию: 1

Количество изображений. Всегда равно 1. Значение больше 1 приводит к ошибке 400 invalid_request.

image_urlsstring[]тело

Массив URL референсных изображений для редактирования, image-to-image и нескольких референсов.

client_business_idstringтело

Ваш ID заказа или бизнес-задачи. После передачи его можно использовать в том же API для получения статуса.

metadataobjectтело

Расширенные параметры Qwen Image.

Свойства metadata
metadata.prompt_extendbooleanтелопо умолчанию: true

Автоматически оптимизировать и расширять запрос.

metadata.prompt_extend_modestringтело

Режим расширения: direct или agent только для текста. При наличии image_urls режим agent автоматически заменяется на direct.

metadata.negative_promptstringтело

Негативный запрос с описанием нежелательного содержания.

metadata.seedintegerтело

Случайное начальное значение. Помогает получать похожие результаты, но не гарантирует идентичность.

metadata.watermarkbooleanтелопо умолчанию: false

Добавлять ли водяной знак.

Разрешение и размеры в пикселях

Обе модели используют одинаковое преобразование соотношения сторон:

Соотношение1K2K
1:11024×10242048×2048
4:31152×8641600×1200
3:4864×11521200×1600
16:91280×7201920×1080
9:16720×12801080×1920
3:21152×7681728×1152
2:3768×11521152×1728

Response

idstring
Уникальный ID задачи.
objectstring
Всегда generation.task.
modelstring
Использованная модель.
statusstring
queued, in_progress, completed или failed.
progressinteger
Процент выполнения от 0 до 100.
created_atinteger
Время создания в формате Unix timestamp.

Пример запроса

Пример запроса

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-3.0",
    "prompt": "Древний город над облаками, золотой рассвет, композиция кинопостера, чёткий русский заголовок",
    "size": "16:9",
    "resolution": "2K",
    "n": 1,
    "metadata": {
      "prompt_extend": true,
      "negative_prompt": "размытость, низкое качество, ошибки в тексте",
      "watermark": false
    }
  }'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-3.0-pro",
    "prompt": "Сохраните человека с первого изображения и одежду со второго, создайте современную обложку журнала",
    "image_urls": [
      "https://example.com/person.png",
      "https://example.com/outfit.png"
    ],
    "size": "3:4",
    "resolution": "2K",
    "n": 1
  }'

Ответ после отправки

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "qwen-image-3.0-pro",
  "status": "queued",
  "progress": 0,
  "created_at": 1787270400
}

Получение статуса

curl --request GET \
  --url https://toapis.com/v1/images/generations/task_img_abc123def456 \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

Подробные поля ответа и рекомендации по опросу описаны в разделе Статус задачи изображения.

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "qwen-image-3.0-pro",
  "status": "completed",
  "progress": 100,
  "result": {
    "type": "image",
    "data": [
      { "url": "https://files.toapis.com/generated/qwen-image-result.png" }
    ]
  }
}
Сгенерированные изображения хранятся 30 дней. Скачайте или сохраните изображение до времени expires_at.

Стоимость

  • Успешный результат: $0.03 за запрос
  • Референсное изображение: $0.003 за изображение
  • Бесплатного лимита для референсов нет
  • Обе модели используют одинаковые правила тарификации