Bruk Hailuo Pro via Rivya Public API v1 med modell-ID hailuo-pro, støttede inndata, parametere, Files API-regler, kreditter og svareksempler.

Tilgjengelig via APITekst eller URL er klar; referansemoduser bruker Files APIVideo

API-modell-ID

hailuo-pro

Inndata

text, file

Files API

Kreves for referansemoduser

Basiskreditter

Egenskap

Video

Fakturering

FIXED

Promptgrense

1500 tegn

Forespørselskontrakt

Send modell-ID-en på toppnivå. Modellspesifikke kontroller hører hjemme i params.

Nøkkel	Type	Påkrevd	Standard	Beskrivelse
model	string	Ja	hailuo-pro	Bruk API-modell-ID-en hailuo-pro.
prompt	string	Ja	-	Maksimalt 1500 tegn for denne modellen.
params	object	Nei	-	Modellspesifikt parameterobjekt. Bruk radene nedenfor for tillatte nøkler.
client_request_id	string	Nei	-	Valgfri klient-ID for sporing av forespørsler i systemet ditt.

Modellparametere

Nøkkel	Type	Påkrevd	Standard	Område	Alternativer	Beskrivelse
prompt_optimizer	select	Nei	false	-	false, true	Lar Hailuo omskrive og optimalisere prompten din før generering. Slå den av når du vil at kjøringen skal holde seg nærmere den rå formuleringen din.

Opplastingspolicy

Last opp referansefiler først, og plasser deretter returnert URL og varighetstoken i params.referenceMediaItems.

Referanseregel

Referansebilder: Bildemodus godtar opptil 2 bilder, og det andre bildet blir siste bilde.

Maks filer

Godtatte filtyper

image

Varighetstoken

Video- og lydreferanser bør ha durationToken fra /api/v1/files når varighetsverifisering kreves.

kind	Maks størrelse	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp

Minimal forespørsel

{
  "model": "hailuo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "prompt_optimizer": "false"
  }
}

Referansefilforespørsel

{
  "model": "hailuo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "prompt_optimizer": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Opprettelsessvar

Create-endepunktet returnerer en offentlig oppgave-ID. Poll statusendepunktet til oppgaven lykkes eller mislykkes.

{
  "id": "task_hailuo_pro_example",
  "status": "queued",
  "model": "hailuo-pro",
  "reserved_credits": 57,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Vanlige feil

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Noen moduser krever referanseopplastinger via Files API.

Hailuo Pro API-integrasjon