Используйте Qwen Image 3.0 через Rivya Public API v1: ID модели qwen-image-3, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIТекст или URL готовы; референсные режимы используют Files APIИзображение

ID модели API

qwen-image-3

Входные данные

text, file

Files API

Требуется для референсных режимов

Базовые кредиты

Кредиты зависят от входных данных и настроек. Проверьте оценку перед генерацией. Итоговая стоимость задачи округляется вверх до целых кредитов.

Возможность

Изображение

Биллинг

FIXED

Лимит промпта

800 символов

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

Ключ	Тип	Обязательно	По умолчанию	Описание
model	string	Да	qwen-image-3	Используйте qwen-image-3 как ID модели API.
prompt	string	Да	-	Максимум 800 символов для этой модели.
params	object	Да	-	Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_id	string	Нет	-	Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

Ключ	Тип	Обязательно	По умолчанию	Диапазон	Варианты	Описание
resolution	select	Да	1K	-	1K, 2K	Разрешение
image_size	select	Нет	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Размер изображения
output_format	select	Нет	png	-	png, jpeg	Формат результата
prompt_extend	select	Нет	true	-	true, false	Позвольте модели переписать простой позитивный промпт перед генерацией или отключите функцию для более строгого контроля формулировки.
nsfw_checker	select	Нет	false	-	false, true	Включите необязательный фильтр контента модели. Ни один автоматический фильтр не может гарантировать полное обнаружение.
negative_prompt	text	Нет	-	-	-	Негативный промпт
seed	number	Нет	1	min 0 / max 2147483647 / step 1	-	Оставьте поле пустым, чтобы каждый раз получать новый случайный результат. Повторное использование одного и того же целого числа упрощает воспроизведение или точную настройку предыдущего результата. Результат будет ближе только если промпт и другие ключевые настройки тоже остаются похожими, и это не гарантирует совпадение 1:1.

Политика загрузки

Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.

Правило референсных материалов

Референсные изображения: Загрузите до трех изображений JPEG, PNG, WebP, BMP, GIF или TIFF размером не более 10 MB каждое.

Макс. файлов

Принимаемые типы файлов

image

Токен длительности

Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.

kind	Макс. размер	MIME-типы
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Минимальный запрос

{
  "model": "qwen-image-3",
  "prompt": "Флакон продукта на светло-сером фоне с мягким освещением слева.",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "Необязательные элементы или нежелательные особенности, которых следует избежать; до 5,000 символов.",
    "seed": 1
  }
}

Запрос с референсным файлом

{
  "model": "qwen-image-3",
  "prompt": "Флакон продукта на светло-сером фоне с мягким освещением слева.",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "Необязательные элементы или нежелательные особенности, которых следует избежать; до 5,000 символов.",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Ответ создания

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_qwen_image_3_example",
  "status": "queued",
  "model": "qwen-image-3",
  "reserved_credits": 5,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Распространенные ошибки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Некоторым режимам нужны референсные файлы, загруженные через Files API.

Интеграция Qwen Image 3.0 API