Použijte Hailuo 2.3 přes Rivya Public API v1 s model id hailuo-2-3, podporovanými vstupy, parametry, pravidly Files API, kredity a příklady odpovědí.

Dostupné přes APIPřipravenostVideo

ID API modelu

hailuo-2-3

Vstupy

file

Files API

Vyžadováno pro referenční režimy

Základní kredity

per_video · standard_768P_6=25 · standard_768P_10=40 · standard_1080P_6=40 · pro_768P_6=40 · pro_768P_10=80 · pro_1080P_6=70 · ⌈total⌉

Schopnost

Video

Fakturace

FIXED

Limit promptu

5000 znaků

Kontrakt požadavku

Model id posílejte na horní úrovni. Model-specific controls patří do params.

Klíč	Typ	Povinné	Výchozí	Popis
model	string	Ano	hailuo-2-3	Použijte API model id hailuo-2-3.
prompt	string	Ano	-	Maximum 5000 znaků pro tento model.
params	object	Ne	-	Objekt parametrů specifických pro model. Povolené klíče najdete v řádcích níže.
client_request_id	string	Ne	-	Volitelné client-side id pro trasování požadavků ve vašem systému.

Parametry modelu

Klíč	Typ	Povinné	Výchozí	Rozsah	Možnosti	Popis
quality	select	Ne	standard	-	standard, pro	Úroveň kvality
resolution	select	Ne	768P	-	768P, 1080P	Rozlišení
duration	select	Ne	6	-	6, 10	Délka
nsfw_checker	select	Ne	true	-	false, true	Filtr obsahu

Pravidla nahrávání

Nejprve nahrajte referenční soubory a potom vložte vrácenou URL a duration token do params.referenceMediaItems.

Pravidlo reference

Referenční obrázek: Nahrajte až 1 obrazový soubor pro obrazové projekty. JPG / PNG / WebP · ≤ 10 MB · 1 image.

Max. souborů

Přijímané typy souborů

image

Token délky trvání

Video a audio reference by měly nést durationToken z /api/v1/files, když je vyžadováno ověření délky.

kind	Max. velikost	MIME typy
image	10 MB	image/jpeg, image/png, image/webp

Minimální požadavek

{
  "model": "hailuo-2-3",
  "params": {
    "quality": "standard",
    "resolution": "768P",
    "duration": "6",
    "nsfw_checker": "true"
  }
}

Požadavek s referenčním souborem

{
  "model": "hailuo-2-3",
  "params": {
    "quality": "standard",
    "resolution": "768P",
    "duration": "6",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Odpověď vytvoření

Create endpoint vrátí public task id. Pollujte status endpoint, dokud úloha neuspěje nebo neselže.

{
  "id": "task_hailuo_2_3_example",
  "status": "queued",
  "model": "hailuo-2-3",
  "reserved_credits": 25,
  "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
}

Běžné chyby

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Některé režimy vyžadují referenční nahrání přes Files API.

API integrace Hailuo 2.3