Docs Rivya AI
Halaman API Model

Integrasi API Hailuo Standard

Gunakan Hailuo Standard melalui Rivya Public API v1 dengan id model hailuo-standard, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIVideo
ID model API

hailuo-standard

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

30

Kapabilitas

Video

Tagihan

FIXED

Batas prompt

1500 karakter

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

KeyTipeWajibDefaultDeskripsi
modelstringYahailuo-standardGunakan hailuo-standard sebagai id model API.
promptstringYa-Maksimum 1500 karakter untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
durationselectTidak6-6, 10Durasi
resolutionselectTidak512P-512P, 768PResolusi
prompt_optimizerselectTidakfalse-false, trueMemungkinkan Hailuo menulis ulang dan mengoptimalkan prompt Anda sebelum generasi. Matikan saat Anda ingin proses tetap lebih dekat dengan kata-kata mentah Anda.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Gambar referensi: Mode gambar menerima hingga 2 gambar, dan gambar kedua menjadi bingkai terakhir.

File maksimum

2

Jenis file yang diterima

image

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kindUkuran maksimumTipe MIME
image10 MBimage/jpeg, image/png, image/webp

Request minimal

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

Request file referensi

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

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

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

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.