Skip to main content
POST

Otorisasi

string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header request:

Routing Mode

happyhorse-1.1 adalah entry terpadu untuk Teks-ke-Video / Gambar-ke-Video / Gambar-Referensi-ke-Video. Backend secara otomatis menentukan mode berdasarkan parameter yang masuk. Semua mode ditagih dengan aturan yang sama (hanya resolusi × detik): Prioritas routing (tinggi ke rendah): first_frame_image > image_urls > hanya prompt. Aturan saling eksklusif: dua field media (first_frame_image / image_urls) saling eksklusif. Mengirim dua field yang saling eksklusif secara bersamaan akan mengembalikan 400 mixed_media_not_allowed.

Parameter Request

string
wajib
Nama model pembuatan video, tetap sebagai happyhorse-1.1
string
Deskripsi konten video, hingga 2500 karakter; tidak boleh berisi token khususContoh: "A little girl walking down the road, cinematic feel"
string
Gambar frame pertama, memicu I2V (Gambar-ke-Video). Mendukung URL atau base64 (data:image/<mime>;base64,<payload>, gateway mengunggahnya ke OSS secara otomatis)Saling eksklusif dengan image_urls
Persyaratan gambar frame pertama:
  • Format: JPEG / JPG / PNG / BMP / WEBP
  • Sisi pendek: ≥ 300px
  • Rasio aspek: 1:2.5 hingga 2.5:1
  • Ukuran file: ≤ 10MB
array<string>
Array gambar (Mode R2V): 1–9 gambar, digunakan sebagai referensi subjek/gaya untuk membuat adegan baruMendukung URL atau base64Saling eksklusif dengan first_frame_image
Persyaratan gambar referensi:
  • Format: JPEG / JPG / PNG / BMP / WEBP
  • Sisi pendek: direkomendasikan ≥ 720p
  • Rasio aspek: sisi pendek / sisi panjang ≥ 0.4
  • Ukuran file: ≤ 10MB
  • Jumlah: 1–9 gambar
string
default:"1080P"
Resolusi video (memengaruhi penagihan)Opsi:
  • 720P - Standar
  • 1080P - Definisi tinggi (default)
integer
default:"5"
Durasi video dalam detik (memengaruhi penagihan)Rentang yang didukung: bilangan bulat apa pun dari 3 hingga 15Default: 5
string
default:"16:9"
Rasio aspekFormat yang didukung:
  • 16:9 - Lanskap widescreen (default)
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Diabaikan dalam mode I2V — rasio aspek output ditentukan otomatis oleh media input (gambar frame pertama)
boolean
default:"false"
Apakah menambahkan watermark ke video yang dibuat
  • true: Tambahkan watermark
  • false: Jangan tambahkan watermark (default)
integer
Seed acak yang digunakan untuk mengontrol keacakan konten yang dibuatRentang nilai: [0, 2147483647]. Jika dihilangkan, seed acak akan digunakan.
  • Untuk request yang identik, model menghasilkan hasil berbeda ketika menerima nilai seed berbeda (misalnya seed dihilangkan)
  • Untuk request yang identik, model menghasilkan hasil mirip ketika menerima nilai seed yang sama, tetapi konsistensi persis tidak dijamin

Respons

integer
Kode status respons, 200 jika berhasil
array
Array data respons

Kasus Penggunaan

Kasus 1: Teks-ke-Video T2V (Request Paling Sederhana)

Kasus 2: Teks-ke-Video T2V (Parameter Lengkap)

Kasus 3: Gambar-ke-Video I2V (first_frame_image)

Kasus 4: Gambar-Referensi-ke-Video R2V (beberapa referensi)

Kasus 5: 720P untuk Menghemat Biaya

Panduan Pemilihan Mode

Tips Penggunaan

  1. Logika entry terpadu: field input menentukan mode. Perhatikan bahwa dua field media (first_frame_image / image_urls) saling eksklusif
  2. size hanya efektif di T2V/R2V: dalam mode I2V, size diabaikan — rasio aspek output ditentukan oleh media input
  3. Durasi: 5–10 detik adalah rentang yang ideal. Terlalu pendek menyebabkan gerakan patah-patah; terlalu panjang meningkatkan waktu pemrosesan upstream secara signifikan
  4. Kualitas gambar frame pertama: jelas, komposisi baik, subjek berada di tengah — sangat meningkatkan output I2V
  5. Penulisan prompt: jelaskan gerakan / kamera / suasana (mis. “slow push-in, cinematic, warm tones”) untuk hasil yang lebih baik daripada deskripsi adegan statis saja
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.