HappyHorse 1.0
Pembuatan Video HappyHorse 1.0
- Model pembuatan video Alibaba Cloud Bailian HappyHorse 1.0 (entry terpadu, routing otomatis satu model)
- Melakukan routing otomatis berdasarkan parameter: T2V (hanya prompt) / I2V (first_frame_image) / R2V (image_urls) / EDIT (video_url)
- Mendukung resolusi 720P/1080P dan durasi bilangan bulat apa pun dari 3 hingga 15 detik
- Ditagih hanya berdasarkan resolusi × durasi (detik), terlepas dari kemampuan
POST
Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Otorisasi
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.0 adalah entry terpadu untuk Teks-ke-Video / Gambar-ke-Video / Gambar-Referensi-ke-Video / Video Edit. Backend secara otomatis menentukan mode berdasarkan parameter yang masuk. Semua mode ditagih dengan aturan yang sama (hanya resolusi × detik):
| Field yang Anda kirim | Diarahkan Ke | Deskripsi Mode |
|---|---|---|
hanya prompt | Teks-ke-Video (T2V) | Membuat video murni dari teks |
prompt + first_frame_image | Gambar-ke-Video (I2V) | Menganimasikan dari gambar frame pertama |
prompt + image_urls (1–9 gambar) | Gambar-Referensi-ke-Video (R2V) | Membuat adegan baru dari gambar referensi |
prompt + video_url (opsional image_urls 0–5 sebagai referensi gaya / audio_setting) | Video Edit (EDIT) | Menulis ulang / mengubah gaya video sumber |
video_url > first_frame_image > image_urls > hanya prompt.
Aturan saling eksklusif: tiga field media (first_frame_image / image_urls / video_url) saling eksklusif secara berpasangan. Satu-satunya kombinasi valid adalah video_url + image_urls (mode EDIT + gambar referensi). Mengirim dua field yang saling eksklusif akan mengembalikan 400 mixed_media_not_allowed.
Parameter Request
Nama model pembuatan video, tetap sebagai
happyhorse-1.0Deskripsi konten video, hingga 2500 karakter; tidak boleh berisi token khusus
- Mode T2V / R2V / EDIT: wajib
- Mode I2V: opsional, tetapi direkomendasikan untuk memandu gerakan kamera dan aksi
"A little girl walking down the road, cinematic feel"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 / video_urlPersyaratan gambar frame pertama:
- Format: JPEG / JPG / PNG / BMP / WEBP
- Sisi pendek: ≥ 300px
- Rasio aspek:
1:2.5hingga2.5:1 - Ukuran file: ≤ 10MB
Array gambar:
- Mode R2V (hanya
image_urlsyang diberikan): 1–9 gambar, digunakan sebagai referensi subjek/gaya untuk membuat adegan baru - Mode EDIT (diberikan bersama
video_url): 0–5 gambar, digunakan sebagai referensi gaya
first_frame_image; dapat digabungkan dengan video_urlPersyaratan gambar referensi:
- Format: JPEG / JPG / PNG / BMP / WEBP
- Sisi pendek: direkomendasikan ≥ 720p
- Rasio aspek: sisi pendek / sisi panjang ≥ 0.4
- Ukuran file: ≤ 10MB
- Jumlah: R2V harus 1–9; EDIT hingga 5
URL video sumber, memicu EDIT (Video Edit). Base64 tidak didukung — berikan link langsung HTTP/HTTPSSaling eksklusif dengan
first_frame_image; dapat digabungkan dengan image_urls (≤ 5)Persyaratan video sumber:
- Durasi: 3–60 detik (> 15 dtk akan otomatis dipotong oleh upstream dari 0 hingga 15 dtk)
- Resolusi: minimum 480p, sisi pendek ≥ 360
- Rasio aspek:
1:8hingga8:1 - Format: MP4 / MOV (H.264 direkomendasikan)
- Frame rate: > 8 fps
- Ukuran file: ≤ 100MB
Pengaturan audio, hanya efektif dalam mode EDIT (harus mengirim
video_url)Opsi:auto- Buat audio otomatis (default)origin- Pertahankan trek audio video sumber
Resolusi video (memengaruhi penagihan)Opsi:
720P- Standar1080P- Definisi tinggi (default)
Durasi video dalam detik (memengaruhi penagihan)Rentang yang didukung: bilangan bulat apa pun dari
3 hingga 15Default: 5Rasio aspekFormat yang didukung:
16:9- Lanskap widescreen (default)9:16- Potret1:1- Persegi4:3- Lanskap3:4- Potret
Apakah menambahkan watermark ke video yang dibuat
true: Tambahkan watermarkfalse: Jangan tambahkan watermark (default)
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
Kode status respons, 200 jika berhasil
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: Edit Video EDIT (pertahankan audio asli + referensi gaya)
Kasus 6: 720P untuk Menghemat Biaya
Panduan Pemilihan Mode
| Kebutuhan | Pendekatan yang Direkomendasikan |
|---|---|
| Membuat video hanya dari teks | Kirim hanya prompt (T2V) |
| Membuat gambar “hidup” (menggunakannya sebagai frame pertama) | Kirim first_frame_image (I2V) |
| Membuat adegan baru dari sekumpulan gambar referensi | Kirim image_urls (1–9, R2V) |
| Menulis ulang / mengubah gaya video yang ada | Kirim video_url (EDIT), opsional gabungkan dengan image_urls (0–5) sebagai referensi gaya |
| Menghemat biaya | Gunakan resolution: "720P" |
Tips Penggunaan
- Logika entry terpadu: field input menentukan mode. Perhatikan bahwa tiga field media (
first_frame_image/image_urls/video_url) saling eksklusif secara berpasangan sizehanya efektif di T2V/R2V: dalam mode I2V / EDIT,sizediabaikan — rasio aspek output ditentukan oleh media input- Durasi: 5–10 detik adalah rentang yang ideal. Terlalu pendek menyebabkan gerakan patah-patah; terlalu panjang meningkatkan waktu pemrosesan upstream secara signifikan
- Kualitas gambar frame pertama: jelas, komposisi baik, subjek berada di tengah — sangat meningkatkan output I2V
- Penulisan prompt: jelaskan gerakan / kamera / suasana (mis. “slow push-in, cinematic, warm tones”) untuk hasil yang lebih baik daripada deskripsi adegan statis saja
- Video input EDIT: > 15 detik akan otomatis dipotong oleh upstream dari 0 hingga 15 dtk. Jika memerlukan segmen lain, potong video terlebih dahulu sendiri
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan
task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.