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

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": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "progress": 123,
  "created_at": 123
}

POST

images

generations

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": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "progress": 123,
  "created_at": 123
}

Для пользователей из материкового Китая: используйте 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

string

обязательно

Для всех API требуется Bearer Token.Получите ключ на странице управления API Key:

Authorization: Bearer YOUR_API_KEY

Body

string

обязательно

Имя модели:

qwen-image-3.0
qwen-image-3.0-pro

string

обязательно

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

string

Соотношение сторон результата: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. Если параметр не указан, размер выбирает модель.

string

по умолчанию:"1K"

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

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

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

integer

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

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

string[]

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

Максимум 3 изображения
Только URL, base64 не поддерживается
Для локальных файлов используйте API загрузки изображений

string

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

object

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

Показать Свойства metadata

boolean

по умолчанию:true

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

string

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

string

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

integer

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

boolean

по умолчанию:false

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

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

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

Соотношение	1K	2K
`1:1`	1024×1024	2048×2048
`4:3`	1152×864	1600×1200
`3:4`	864×1152	1200×1600
`16:9`	1280×720	1920×1080
`9:16`	720×1280	1080×1920
`3:2`	1152×768	1728×1152
`2:3`	768×1152	1152×1728

Response

string

Уникальный ID задачи.

string

Всегда generation.task.

string

Использованная модель.

string

queued, in_progress, completed или failed.

integer

Процент выполнения от 0 до 100.

integer

Время создания в формате 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" }
    ]
  }
}

URL результата действует 24 часа. Скачайте или сохраните изображение до времени expires_at.

Стоимость

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

Обзор

Быстрый старт

Каталог моделей

API чата

API изображений

API видео

API музыки

Управление задачами

Загрузка файлов

Аккаунт

Часто задаваемые вопросы

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

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

Authorizations

Body

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

Response

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

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

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

Стоимость

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

​Authorizations

​Body

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

​Response

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

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

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

​Стоимость

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

Authorizations

Body

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

Response

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

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

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

Стоимость