Kling V4 Flash

Kontrak APIMaster kling-v4-flash, diperiksa 2026-11-07. Kanal 317 mendukung teks, bingkai awal, referensi, penyuntingan, dan perpanjangan. Hanya 720p, 24 fps, 3–20 detik; berbeda dari Kling V4.

Kling V4 Flash

Endpoint dan autentikasi

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Parameter

Gunakan JSON dan Authorization: Bearer YOUR_API_KEY; model=kling-v4-flash. prompt wajib kecuali satu gambar awal. duration/seconds: bilangan bulat JSON 3–20, bawaan 5; null berarti tidak dikirim, 0 ditolak. Jika keduanya ada, harus valid dan sama. Penyuntingan tanpa durasi menggunakan panjang aliran video yang dibulatkan ke atas. resolution hanya 720p. aspect_ratio atau alias size: 16:9, 9:16, 1:1, 21:9; auto hanya referensi. Bawaan teks 16:9, referensi auto, penyuntingan mengikuti sumber. Gambar awal dan perpanjangan menolak aspect_ratio/size yang tidak kosong. audio hanya true, watermark hanya false.

Parameter	Tipe JSON	Wajib	Default	Fungsi dan batasan
model	string	Ya	kling-v4-flash	Selalu kling-v4-flash untuk kelima operasi; kling-v4 adalah model berbeda.
prompt	string	Sesuai mode	—	Jelaskan adegan, gerakan, atau perubahan. Hanya boleh dihilangkan untuk satu gambar awal. @Image1 dan @Video1 bernomor terpisah mulai 1 sesuai urutan array; video yang diedit adalah @Video1.
duration	integer / null	Tidak	5	Bilangan bulat JSON 3–20 detik, umumnya 5. Edit tanpa kedua kolom durasi membulatkan ke atas durasi stream video sumber; ekstensi berarti panjang segmen BARU. null dianggap tidak dikirim; 0, pecahan, dan string angka ditolak.
seconds	integer / null	Tidak	—	Alias duration dengan batas yang sama. Sebaiknya kirim satu saja; bila keduanya ada, harus valid dan sama, jika tidak 400.
resolution	string	Tidak	720p	Hanya 720p. Ini tingkat kualitas, bukan jaminan sisi pendek selalu 720px. Tidak mendukung 1080p atau pilihan kualitas melalui mode.
aspect_ratio	string	Tidak	Sesuai mode	Teks/referensi/edit menerima 16:9, 9:16, 1:1, 21:9; auto hanya untuk referensi. Default teks 16:9, referensi auto, edit mengikuti sumber. Gambar awal/ekstensi menolak nilai tidak kosong; string kosong diabaikan.
size	string	Tidak	—	Alias aspect_ratio, bukan resolusi atau ukuran piksel. Jika kedua kolom dikirim harus sama; hilangkan keduanya untuk gambar awal dan ekstensi.
image_urls	string[]	Sesuai mode	—	Array URL gambar publik. Auto menerima satu gambar awal; referensi gambar saja memerlukan reference eksplisit. Referensi/edit maksimal 10 gambar termasuk peran reference_image. Jangan campur representasi gambar awal; ekstensi tidak menerima gambar.
first_frame_image	string	Sesuai mode	—	URL publik satu gambar awal. Alternatif satu item image_urls atau peran first_frame, bukan tambahan. Lebar dan tinggi ≥300px, rasio 2:5–5:2; pangkas lebih dulu bila perlu.
image_with_roles	{url, role}[]	Sesuai mode	—	Setiap objek membutuhkan url publik dan role. first_frame untuk satu gambar awal, reference_image untuk referensi/edit. Bingkai akhir/tengah/keyframe tidak didukung. Total gambar referensi≤10, gambar dan video referensi≤15.
video_url	string	Sesuai mode	—	URL satu video sumber hanya dengan edit/extend eksplisit, tidak bersama video_urls. Edit: MP4/MOV, stream 3–20s, setiap dimensi 700–4553px. Ekstensi mulai dari bingkai terakhir dan hanya mengembalikan segmen baru, bukan menerima ID tugas/percakapan.
video_urls	string[]	Sesuai mode	—	Maksimal 5 MP4/MOV referensi, tiap stream≥3s, tiap dimensi 700–4553px, total≤20s. Edit/extend eksplisit dapat memakai tepat satu item sebagai pengganti video_url. Durasi berlebih ditolak, tidak dipotong; array memilih referensi secara otomatis.
omni_reference_task_type	string	Tidak	auto	auto menentukan teks/gambar awal/referensi; reference membutuhkan materi referensi; edit/extend membutuhkan satu video. video_url tanpa mode eksplisit dan dua gambar biasa dalam auto tidak valid.
audio_setting	string	Tidak	auto	Hanya referensi DENGAN VIDEO. auto membuat suara baru; origin mempertahankan suara video PERTAMA, tanpa track sumber berarti tanpa track keluaran. Hilangkan untuk edit, ekstensi, teks, atau referensi gambar saja.
audio	boolean	Tidak	true	Boolean kompatibilitas: hilangkan atau true, false ditolak. Gunakan audio_setting untuk suara asli pada mode yang mendukung; referensi audio terpisah tidak didukung.
watermark	boolean	Tidak	false	Boolean kompatibilitas: hilangkan atau false, true ditolak. Bukan layanan penghapus watermark sumber.

Gunakan URL HTTP(S) publik langsung tanpa kredensial; bukan base64/path lokal/ID tugas. Format dan batas byte gambar tidak dipublikasikan terpisah. Batas baca 100MiB berlaku per video referensi/edit yang diperiksa, bukan batas unggah umum penyedia.

Mode dan media

Operasi	Pemilihan dan materi wajib	Default dan pengecualian
Teks ke video	Tanpa materi, prompt wajib, jenis auto atau dihilangkan.	5s, 16:9; tanpa audio_setting.
Gambar awal ke video	Satu gambar melalui SATU dari tiga representasi; prompt opsional.	5s, rasio gambar; tanpa aspect_ratio/size dan bingkai akhir.
Referensi ke video	reference + gambar, peran reference_image atau video_urls; prompt wajib.	5s, auto; gambar≤10, video≤5, total≤15; pengaturan suara membutuhkan video.
Edit video	edit + satu video, prompt wajib; maksimal 10 gambar referensi.	Durasi sumber dibulatkan ke atas, rasio sumber; tanpa peran bingkai/audio_setting.
Ekstensi video	extend + satu video, prompt wajib.	5 detik BARU; tanpa gambar, penggantian rasio/audio_setting; tanpa pemeriksaan dimensi/durasi minimum edit/referensi.

omni_reference_task_type: auto, reference, edit, extend. Satu image_urls, first_frame_image, atau peran first_frame menjadi gambar awal. Beberapa gambar membutuhkan reference atau peran reference_image; dua image_urls dalam auto ditolak. video_urls memilih referensi kecuali edit/extend dinyatakan. video_url memerlukan edit/extend dan tidak boleh bersama video_urls. Penyuntingan/perpanjangan membutuhkan satu video. Penyuntingan menerima gambar referensi; perpanjangan menolak gambar/audio_setting dan mengembalikan segmen BARU saja. Gunakan URL video sumber publik, bukan ID tugas atau percakapan.

URL HTTP(S) publik langsung tanpa kredensial tertanam. Maksimal 10 gambar, 15 referensi gambar/video total. Gambar minimal 300×300, rasio 2:5–5:2. Maksimal 5 MP4/MOV, masing-masing minimal 3 detik, total sampai 20; penyuntingan satu video 3–20 detik. Lebar DAN tinggi masing-masing 700–4553 piksel. Gateway membaca maksimal 100 MiB per video dan mengukur aliran video, bukan kontainer/audio. Pemeriksaan dimensi/durasi minimal ini tidak berlaku untuk masukan perpanjangan. Pemasok juga memvalidasi gambar. audio_setting=origin mempertahankan suara video referensi pertama atau hening; auto menghasilkan suara. Hanya referensi DENGAN video. Penyuntingan membuat suara baru. Tanpa URL audio, bingkai akhir/tengah, keyframes, negative_prompt, mode, seed, banyak adegan atau daftar tokoh/suara.

Piksel keluaran dan laju bingkai

Rasio / operasi	Piksel menurut dokumentasi	Laju bingkai
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Gambar awal ke video	Mengikuti rasio gambar, sekitar 0,92MP; misalnya 604×1516 untuk 2:5.	24 fps

Ukuran keluaran bukan syarat sumber. Tinggi 21:9 adalah 628px, di bawah minimum 700px untuk referensi/edit; siapkan sumber sesuai. Minimum ini tidak berlaku pada ekstensi. File bisa lebih panjang sekitar satu bingkai.

Contoh tanpa eksekusi

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Penagihan

Tarif dasar resmi nominal: $0.094 per detik keluaran (720P), $0.0628 per detik tertagih dengan video (720P-input). Teks, gambar, referensi tanpa video dan perpanjangan: keluaran/segmen baru. Referensi video dan penyuntingan: keluaran + max(masukan, keluaran). Jumlahkan dahulu durasi seluruh aliran masukan, lalu bulatkan total ke atas. Masukan 3.04 detik, keluaran 3: 3+max(4,3)=7 detik tertagih. Satu bingkai tambahan tidak mengubah durasi bulat yang diminta. Diskon paket dan pengali akun terpisah; lihat kartu serta biaya akhir log. Kegagalan terkonfirmasi mengembalikan cadangan. Berhenti memeriksa tidak membatalkan tugas; timeout ambigu tidak membenarkan generasi baru.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Status, kesalahan, dan percobaan ulang aman

Penerimaan pertama: HTTP 200, task_id publik, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed, toleransi unknown sementara. url dan metadata.url perlu Bearer; juga GET /v1/videos/{task_id}/content. Gagal: error.code=generation_failed dengan pesan tersanitasi; parameter salah: HTTP 400. Idempotency-Key: 8–128 karakter ASCII terlihat tanpa spasi. Akun/kunci/permintaan sama: HTTP 202 tanpa generasi/cadangan kedua; perubahan: 409. GET /v1/video-submissions/by-key membaca tanda terima. accepted+task_ready=true: periksa task_id; pending/submitting atau belum siap: tunggu. acceptance_unknown: simpan kunci dan hubungi dukungan, jangan kirim ulang otomatis. 404 bukan bukti tidak diterima. Disimpan minimal 30 hari; perlindungan gateway, bukan pencarian pemasok. Biaya akhir pada konsumsi melalui other.task_id; respons tugas tidak menjamin faktur. /v1/videos/quote tidak didukung. Contoh tidak dijalankan: ganti URL dan gunakan kunci baru setiap operasi baru.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI