Gunakan HappyHorse 1.1 melalui Rivya Public API v1 dengan id model happyhorse-1-1, 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

happyhorse-1-1

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

Tarif kredit: 22,5–29 / detik keluaran Biaya akhir tugas dibulatkan ke atas ke kredit utuh.

Kapabilitas

Video

Tagihan

METERED

Batas prompt

4999 karakter

Kontrak request

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

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	happyhorse-1-1	Gunakan happyhorse-1-1 sebagai id model API.
prompt	string	Tidak	-	Maksimum 4999 karakter untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
resolution	select	Tidak	1080p	-	720p, 1080p	Resolusi yang dipilih menetapkan tarif kredit per detik.
aspect_ratio	select	Tidak	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	Digunakan untuk proses hanya dari prompt dan multi-referensi; proses satu gambar mengikuti bingkai pertamanya.
duration	number	Tidak	5	min 3 / max 15 / step 1	-	Pilih durasi output bilangan bulat dari 3 hingga 15 detik.

Kebijakan unggahan

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

Aturan referensi

Bingkai pertama atau gambar referensi: Unggah satu gambar JPEG, PNG, atau WebP untuk animasi bingkai pertama, atau 2 hingga 9 gambar untuk video berbasis referensi. Setiap berkas dapat berukuran hingga 20 MB.

File maksimum

Jenis file yang diterima

image

Duration token

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

kind	Ukuran maksimum	Tipe MIME
image	20 MB	image/jpeg, image/png, image/webp

Request minimal

{
  "model": "happyhorse-1-1",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}

Request file referensi

{
  "model": "happyhorse-1-1",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Response create

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

{
  "id": "task_happyhorse_1_1_example",
  "status": "queued",
  "model": "happyhorse-1-1",
  "reserved_credits": 145,
  "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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.

Integrasi API HappyHorse 1.1