> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

> [!NOTE]
>
> **Для пользователей из материкового Китая:** используйте `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 задачи

> [!WARNING]
>
> `image_urls` принимает только общедоступные URL изображений. Base64 Data URI не поддерживаются. Локальные файлы сначала загрузите через [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md).

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

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

## Authorizations

**Authorization** `string` *required*

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

Получите ключ на [странице управления API Key](https://toapis.com/console/token):

```text theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required*

Имя модели:

* `qwen-image-3.0`
* `qwen-image-3.0-pro`

**prompt** `string` *required*

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

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

**resolution** `string` (default: 1K)

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

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

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

**n** `integer` (default: 1)

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

**image\_urls** `string[]`

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

* Максимум 3 изображения
* Только URL, base64 не поддерживается
* Для локальных файлов используйте [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md)

**client\_business\_id** `string`

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

**metadata** `object`

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

**Свойства metadata**

**metadata.prompt\_extend** `boolean` (default: true)

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

**metadata.prompt\_extend\_mode** `string`

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

**metadata.negative\_prompt** `string`

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

**metadata.seed** `integer`

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

**metadata.watermark** `boolean` (default: 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

**id** `string`

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

**object** `string`

Всегда `generation.task`.

**model** `string`

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

**status** `string`

`queued`, `in_progress`, `completed` или `failed`.

**progress** `integer`

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

**created\_at** `integer`

Время создания в формате Unix timestamp.

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

```bash cURL theme={null}
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
    }
  }'
```

```bash cURL (Несколько референсов) theme={null}
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
  }'
```

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

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

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

```bash theme={null}
curl --request GET \
  --url https://toapis.com/v1/images/generations/task_img_abc123def456 \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
```

Подробные поля ответа и рекомендации по опросу описаны в разделе [Статус задачи изображения](https://docs.toapis.com/docs/ru/api-reference/tasks/image-status.md).

```json theme={null}
{
  "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" }
    ]
  }
}
```

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

## Стоимость

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.