kling-3.0-omniAPI

Gunakan ID model yang tepat kling-3.0-omni. Bidang model harus sama persis dengan halaman ini.

Contoh keluarankling-3.0-omniPOST /v1/videos5.0s

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

Prompt: One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "kling-3.0-omni",
  "prompt": "One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

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_name": "kling-3.0-omni",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "duration": "5", "mode": "std"
  }'

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

Kling menggunakan kolom model_name, prompt, mode, duration, image_list, atau contents / settings khusus keluarga; JSON asli dipertahankan dan diteruskan.

Parameter permintaan

Kling Omni/O1 menggunakan model_name, prompt, dan daftar media. Ikuti batasan resmi setiap model saat menggabungkan image_list, video_list, element_list, multi_shot, dan sound.

Bidang	Wajib diisi	Catatan
model_name	Ya	kling-3.0-omni
prompt	Bersyarat	Diperlukan ketika multi-shot dinonaktifkan
mode	Tidak	std / pro
aspect_ratio	Bersyarat	16:9 / 9:16 / 1:1
duration	Tidak	3–15 detik (string)
image_list	Tidak	Referensi bingkai pertama/akhir, pemandangan, atau gaya; Omni/O1 mengizinkan beberapa item dalam batas model
video_list	Tidak	Pengeditan video atau referensi gaya
element_list	Tidak	ID elemen Kling; integrasi ini tidak menyediakan manajemen elemen
multi_shot	Tidak	Aktifkan storyboard multi-shot
sound	Tidak	Apakah akan menghasilkan suara yang disinkronkan

Batas masukan dan keluaran

Omni mendukung 720p/1080p/4k, 3–15 detik, referensi gambar/video/elemen, dan hingga enam pengambilan gambar storyboard. Matikan sound bila ada video referensi.

Contoh alur kerja yang terdokumentasi

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0-omni",
    "prompt": "让图 1 中的人物在雨中向镜头挥手",
    "image_list": [{"image_url": "https://example.com/character.png"}],
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

Video referensi, elemen, dan kombinasi multi-shot harus mengikuti batasan halaman ini; matikan sound ketika ada video referensi.

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.