Rivya AI Docs
Сторінки API моделей

API-інтеграція для Wan 2.7 Image Pro

Використовуйте Wan 2.7 Image Pro через Rivya Public API v1 з ID моделі wan-2-7-image-pro, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.

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

wan-2-7-image-pro

Входи

text, file

Files API

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

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

12

Можливість

Зображення

Білінг

FIXED

Ліміт промпта

5000 символів

Контракт запиту

Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.

КлючТипОбов'язковоЗа замовчуваннямОпис
modelstringТакwan-2-7-image-proВикористовуйте wan-2-7-image-pro як ID моделі API.
promptstringТак-Максимум 5000 символів для цієї моделі.
paramsobjectНі-Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче.
client_request_idstringНі-Необов'язковий клієнтський ID для трасування запитів у вашій системі.

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

КлючТипОбов'язковоЗа замовчуваннямДіапазонОпціїОпис
aspect_ratioselectНі1:1-1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8Співвідношення сторін
resolutionselectНі2K-1K, 2KРоздільна здатність
watermarkselectНіfalse-false, trueWatermark
seednumberНі-min 0 / max 2147483647 / step 1-Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1.

Політика завантаження

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

Правило референсів

Референсне зображення: Завантажте до 9 файлів зображень для проєктів редагування зображень.

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

9

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

image

Токен тривалості

Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.

kindМаксимальний розмірMIME types
image20 MBimage/jpeg, image/png, image/webp

Мінімальний запит

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Запит із референсним файлом

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Відповідь створення

Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.

{
  "id": "task_wan_2_7_image_pro_example",
  "status": "queued",
  "model": "wan-2-7-image-pro",
  "reserved_credits": 12,
  "final_credits": 0,
  "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.