> ## 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

* Поддерживаются `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 загрузки изображений](../../uploads/images).
</Warning>

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

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

## Authorizations

<ParamField header="Authorization" type="string" required>
  Для всех API требуется Bearer Token.

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

  ```text theme={null}
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## Body

<ParamField body="model" type="string" required>
  Имя модели:

  * `qwen-image-3.0`
  * `qwen-image-3.0-pro`
</ParamField>

<ParamField body="prompt" type="string" required>
  Описание изображения или инструкция по редактированию. Пустая строка не допускается.
</ParamField>

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

<ParamField body="resolution" type="string" default="1K">
  Уровень разрешения при передаче соотношения сторон:

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

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

<ParamField body="n" type="integer" default={1}>
  Количество изображений. Всегда равно `1`. Значение больше `1` приводит к ошибке `400 invalid_request`.
</ParamField>

<ParamField body="image_urls" type="string[]">
  Массив URL референсных изображений для редактирования, image-to-image и нескольких референсов.

  * Максимум 3 изображения
  * Только URL, base64 не поддерживается
  * Для локальных файлов используйте [API загрузки изображений](../../uploads/images)
</ParamField>

<ParamField body="client_business_id" type="string">
  Ваш ID заказа или бизнес-задачи. После передачи его можно использовать в том же API для получения статуса.
</ParamField>

<ParamField body="metadata" type="object">
  Расширенные параметры Qwen Image.

  <Expandable title="Свойства metadata">
    <ParamField body="metadata.prompt_extend" type="boolean" default={true}>
      Автоматически оптимизировать и расширять запрос.
    </ParamField>

    <ParamField body="metadata.prompt_extend_mode" type="string">
      Режим расширения: `direct` или `agent` только для текста. При наличии `image_urls` режим `agent` автоматически заменяется на `direct`.
    </ParamField>

    <ParamField body="metadata.negative_prompt" type="string">
      Негативный запрос с описанием нежелательного содержания.
    </ParamField>

    <ParamField body="metadata.seed" type="integer">
      Случайное начальное значение. Помогает получать похожие результаты, но не гарантирует идентичность.
    </ParamField>

    <ParamField body="metadata.watermark" type="boolean" default={false}>
      Добавлять ли водяной знак.
    </ParamField>
  </Expandable>
</ParamField>

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

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

| Соотношение | 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

<ResponseField name="id" type="string">Уникальный ID задачи.</ResponseField>
<ResponseField name="object" type="string">Всегда `generation.task`.</ResponseField>
<ResponseField name="model" type="string">Использованная модель.</ResponseField>
<ResponseField name="status" type="string">`queued`, `in_progress`, `completed` или `failed`.</ResponseField>
<ResponseField name="progress" type="integer">Процент выполнения от 0 до 100.</ResponseField>
<ResponseField name="created_at" type="integer">Время создания в формате Unix timestamp.</ResponseField>

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

<RequestExample>
  ```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
    }'
  ```
</RequestExample>

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

```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>'
```

Подробные поля ответа и рекомендации по опросу описаны в разделе [Статус задачи изображения](../../tasks/image-status).

```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`.</Warning>

## Стоимость

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