Video
kling-3.0-turboAPI
Gunakan ID model kling-3.0-turbo yang tepat melalui perutean video asinkron Modelflare.
Gunakan ID model yang tepat kling-3.0-turbo. Bidang model harus sama persis dengan halaman ini.
Parameter: duration=5resolution=1080pratio=16:9
Prompt: A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.
{ "model": "kling-3.0-turbo", "prompt": "A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.", "seconds": "5", "duration": 5, "resolution": "1080p", "ratio": "16:9", "aspect_ratio": "16:9"}Otentikasi dan titik akhir
Section titled “Otentikasi dan titik akhir”Gunakan kunci API Modelflare dengan https://modelflare.dev/v1. Titik masuk gateway adalah POST /v1/videos.
Authorization: Bearer YOUR_MODELFLARE_API_KEYBuat tugas
Section titled “Buat tugas”curl https://modelflare.dev/v1/videos \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "kling-3.0-turbo", "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot", "settings": {"duration": 5, "resolution": "720p"} }'Poll and download
Section titled “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.
curl https://modelflare.dev/v1/videos/TASK_ID \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"Minta catatan
Section titled “Minta catatan”Kling menggunakan kolom model_name, prompt, mode, duration, image_list, atau contents / settings khusus keluarga; JSON asli dipertahankan dan diteruskan.
Parameter permintaan
Section titled “Parameter permintaan”Kling 3.0 Turbo memilih model di jalur URL; jangan masukkan model_name ke dalam badan. Teks-ke-video dan gambar-ke-video bingkai pertama menggunakan jalur resmi yang berbeda.
| Bidang | Wajib diisi | Catatan |
|---|---|---|
prompt |
Ya | Perintah teks-ke-video; gunakan batas panjang resmi |
contents[] |
Bersyarat | Untuk gambar-ke-video, sertakan prompt dan first_frame |
settings.resolution |
Tidak | 720p / 1080p |
settings.aspect_ratio |
Tidak | 16:9 / 9:16 / 1:1 |
settings.duration |
Tidak | 3–15 detik |
options.watermark_info |
Tidak | Konfigurasi tanda air |
Batas masukan dan keluaran
Section titled “Batas masukan dan keluaran”Teks-ke-video dan gambar-ke-video bingkai pertama masing-masing menggunakan prompt dan contents[]. Outputnya 720p atau 1080p selama 3–15 detik; perintah multi-shot mendukung hingga enam pengambilan gambar.
Contoh alur kerja yang terdokumentasi
Section titled “Contoh alur kerja yang terdokumentasi”Turbo menggunakan envelope contents/settings/options yang ditingkatkan. ID model tetap berada di bidang model Modelflare dan panggilan masuk melalui /v1/videos.
curl https://modelflare.dev/v1/videos \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "kling-3.0-turbo", "contents": [{"type": "prompt", "text": "列车缓慢驶过雨夜城市"}], "settings": {"resolution": "1080p", "aspect_ratio": "16:9", "duration": 5}, "options": {"watermark_info": {"enabled": false}} }'curl https://modelflare.dev/v1/videos \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "kling-3.0-turbo", "contents": [{"type": "prompt", "text": "角色转身看向窗外"}, {"type": "first_frame", "url": "https://example.com/first.png"}], "settings": {"resolution": "1080p", "duration": 5} }'Kesalahan dan tugas yang gagal
Section titled “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
Section titled “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
Section titled “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.
Kontrak media · v1
Sumber resmi: Kuaishou Kling
Parameter kontrak
| Bidang maksud | Kontrol | Pilihan |
|---|---|---|
ratio | select | 16:9 / 9:16 / 1:1 |
resolution | select | 720p / 1080p |
duration | select | 3 / 5 / 8 / 10 / 15 |
Kemampuan yang didukung
allowed_values·ratio· 16:9, 9:16, 1:1allowed_values·resolution· 720p, 1080pallowed_values·duration· 3, 5, 8, 10, 15max_assets·reference_asset_ids· 1
Contoh permintaan terstruktur
text
Maksud
{
"duration": 3,
"prompt": "A red paper kite over a quiet harbour at dusk.",
"ratio": "16:9",
"resolution": "720p"
}Permintaan penyedia
{
"contents": [
{
"text": "A red paper kite over a quiet harbour at dusk.",
"type": "prompt"
}
],
"settings": {
"aspect_ratio": "16:9",
"duration": 3,
"resolution": "720p"
}
}reference
Maksud
{
"duration": 3,
"prompt": "A red paper kite over a quiet harbour at dusk.",
"ratio": "16:9",
"resolution": "720p"
}Permintaan penyedia
{
"contents": [
{
"text": "A red paper kite over a quiet harbour at dusk.",
"type": "prompt"
},
{
"type": "first_frame",
"url": "https://example.com/reference.png"
}
],
"settings": {
"aspect_ratio": "16:9",
"duration": 3,
"resolution": "720p"
}
}