Використовуйте 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

Потрібно для референсних режимів

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

per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉

Можливість

Зображення

Білінг

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 МБ.

Максимум файлів

Прийняті типи файлів

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": "A clean editorial product image on a soft studio background",
  "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": "A clean editorial product image on a soft studio background",
  "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.

API-інтеграція для Qwen Image 3.0