happyhorse-1.1-i2vAPI

Gunakan ID model yang tepat happyhorse-1.1-i2v. Bidang model harus sama persis dengan halaman ini.

Contoh keluaranhappyhorse-1.1-i2vPOST /v1/videos5.2s

Parameter: duration=5resolution=1080pratio=16:9Gambar masukan

Prompt: One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.

Permintaan yang menghasilkan sampel ini, dengan URL media masukan diganti

{
  "model": "happyhorse-1.1-i2v",
  "prompt": "One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

Otentikasi dan titik akhir

Gunakan kunci API Modelflare dengan https://modelflare.dev/v1. Titik masuk gateway adalah POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Buat tugas

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {"prompt": "The cat runs across the grass as the camera follows smoothly.", "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}]},
    "parameters": {"resolution": "1080P", "duration": 5, "watermark": false}
  }'

Poll and download

Simpan ID tugas. Jajak pendapat GET /v1/videos/{task_id} dan unduh dengan GET /v1/videos/{task_id}/content. URL hasil mungkin kedaluwarsa, jadi segera transfer file.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Minta catatan

HappyHorse menggunakan input.prompt; pilih bentuk input.media yang cocok dengan ID model t2v, i2v, atau r2v.

Parameter permintaan

HappyHorse I2V menempatkan satu gambar first_frame di input.media.

Bidang	Wajib diisi	Catatan
model	Ya	happyhorse-1.1-i2v
input.prompt	Tidak	Deskripsi gerakan dan kamera opsional, hingga 5.000 karakter non-China atau 2.500 karakter China
input.media[]	Ya	Tepat satu first_frame; URL publik atau URL data Base64, di bawah 20 MB, sisi minimum 300 piksel, dan rasio lebar tinggi 1:2,5–2,5:1
parameters.resolution	Tidak	720P / 1080P, bawaan 1080P
parameters.ratio	Tidak	Tidak didukung; keluaran mengikuti rasio gambar bingkai pertama
parameters.duration	Tidak	3–15 detik, default 5
parameters.watermark	Tidak	Apakah akan menambahkan tanda air HappyHorse
parameters.seed	Tidak	Benih opsional dari 0 hingga 2.147.483.647

Batas masukan dan keluaran

I2V menggunakan satu gambar first_frame; menerima URL publik atau URL data Base64 berukuran kurang dari 20 MB dengan sisi minimum 300 piksel dan rasio aspek 1:2,5–2,5:1, dan kira-kira mempertahankan rasio masukan.

Kesalahan dan tugas yang gagal

Parameter model yang tidak valid menampilkan 4xx dengan ID permintaan. Tugas asinkron juga bisa gagal masuk setelah pembuatan berhasil; gunakan error_code dan error_message dari respon polling sebagai alasan tugas akhir. Jangan coba lagi permintaan yang sama dengan bentuk JSON yang berbeda.

Cakupan yang didukung

Halaman ini mencakup pembuatan model Modelflare dan panggilan pengeditan. Pengayaan penelusuran atau peta, pengelolaan suara, dan pengelolaan pustaka elemen merupakan API sumber daya di luar permukaan panggilan model publik ini dan bukan merupakan bidang permintaan yang wajib diisi.

Pricing and billing

Model ini menggunakan penagihan video per detik. Lihat halaman harga model untuk harga pelanggan saat ini, harga daftar referensi, dan spesifikasi lengkap.

Catatan

Halaman ini mendokumentasikan antarmuka publik Modelflare; bidang dan batasan yang ditampilkan di sini adalah kontrak saat ini.