Rivya AI-dokumentation
Modellsidor för API

Hailuo Standard API-integration

Använd Hailuo Standard via Rivyas publika API v1 med modell-ID hailuo-standard, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIText eller URL klar; referenslägen använder Files APIVideo
API-modell-ID

hailuo-standard

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

30

Förmåga

Video

Fakturering

FIXED

Promptgräns

1500 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

NyckelTypObligatorisktStandardBeskrivning
modelstringJahailuo-standardAnvänd API-modell-ID:t hailuo-standard.
promptstringJa-Högst 1500 tecken för den här modellen.
paramsobjectNej-Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_idstringNej-Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

NyckelTypObligatorisktStandardIntervallAlternativBeskrivning
durationselectNej6-6, 10Längd
resolutionselectNej512P-512P, 768PUpplösning
prompt_optimizerselectNejfalse-false, trueLåter Hailuo skriva om och optimera din prompt före generering. Stäng av den när du vill att körningen ska ligga närmare din råa formulering.

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Referensbilder: Bildläge accepterar upp till 2 bilder, och den andra bilden blir sista bildrutan.

Max filer

2

Godkända filtyper

image

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kindMax storlekMIME-typer
image10 MBimage/jpeg, image/png, image/webp

Minimal begäran

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

Begäran med referensfil

{
  "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"
      }
    ]
  }
}

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

{
  "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
}

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.