Rivya AI-dokumentation
Model-API-sider

Hailuo Standard API-integration

Brug Hailuo Standard via Rivya Public API v1 med model-id hailuo-standard, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekst eller URL klar; referencetilstande bruger Files APIVideo
API-model-id

hailuo-standard

Inputs

text, file

Files API

Krævet for referencetilstande

Basiscredits

30

Funktion

Video

Fakturering

FIXED

Promptgrænse

1500 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

NøgleTypeKrævetStandardBeskrivelse
modelstringJahailuo-standardBrug API-model-id'et hailuo-standard.
promptstringJa-Maksimalt 1500 tegn for denne model.
paramsobjectNej-Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_idstringNej-Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

NøgleTypeKrævetStandardIntervalValgmulighederBeskrivelse
durationselectNej6-6, 10Varighed
resolutionselectNej512P-512P, 768POpløsning
prompt_optimizerselectNejfalse-false, trueLader Hailuo omskrive og optimere din prompt før generering. Slå det fra, når kørslen skal holde sig tættere på din rå formulering.

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Referencebilleder: Billedtilstand accepterer op til 2 billeder, og det andet billede bliver den sidste frame.

Maks. filer

2

Accepterede filtyper

image

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kindMaks. størrelseMIME-typer
image10 MBimage/jpeg, image/png, image/webp

Minimal anmodning

{
  "model": "hailuo-standard",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

Referencefilanmodning

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

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

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

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.