Kling 4.0 API

Referensi API lengkap untuk model pembuatan video Kling 4.0 dari Kuaishou.

Varian Model

API ini mendukung lima varian model:

Perbandingan Singkat

Rasio Aspek yang Didukung

Text-to-Video, Image-to-Video, Reference-to-Video, dan Video Edit mendukung:

16:9, 9:16, 1:1, 21:9

Nilai default adalah 16:9. Video Extend tidak mendukung parameter aspect_ratio; hasilnya mengikuti rasio aspek video sumber.

Pilihan Resolusi

Kelima model mewajibkan resolution dan duration. Sertakan resolution secara eksplisit meskipun nilai default-nya adalah 720p. duration tidak memiliki nilai default.

Kling 4.0 Text to Video

Titik Akhir

POST /api/v1/video/task

Parameter Permintaan

Wajib

Opsional

Contoh Permintaan

javascriptSalin
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Kling 4.0 Image to Video

Parameter Permintaan

Wajib

Opsional

Jika image_url dan image_end_url sama-sama disertakan, key_frames dapat berisi maksimal 8 gambar. Bingkai perantara digunakan sesuai urutan larik; waktu kemunculannya ditentukan oleh model.

Contoh Permintaan

javascriptSalin
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

Parameter Permintaan

Wajib

Opsional

Gambar, video, dan audio referensi semuanya opsional. Sertakan salah satu jenis media, gabungkan beberapa jenis media, atau jangan sertakan ketiganya.

duration keluaran diatur secara terpisah antara 3-30 detik dan tidak dihitung dalam batas total durasi video referensi.

Contoh Permintaan

javascriptSalin
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

Parameter Permintaan

Wajib

Opsional

Contoh Permintaan

javascriptSalin
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

Parameter Permintaan

Wajib

Opsional

Jangan kirim aspect_ratio; hasilnya mengikuti rasio aspek video sumber. Hasil berisi video lengkap, termasuk video sumber dan perpanjangannya. Total durasinya adalah durasi video sumber ditambah duration.

Contoh Permintaan

javascriptSalin
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

Aturan Penagihan

Biaya Text-to-Video dan Image-to-Video dihitung berdasarkan resolusi keluaran dan durasi video yang dihasilkan. Biaya Video Extend dihitung berdasarkan resolusi dan durasi segmen tambahan, bukan durasi penuh video yang dikembalikan.

Permintaan Reference-to-Video yang menyertakan video referensi dan permintaan Video Edit memperhitungkan durasi video masukan maupun keluaran pada resolusi yang dipilih. Durasi video masukan yang ditagihkan minimal 3 detik dan maksimal 30 detik. Untuk beberapa video referensi, batas ini berlaku pada total durasinya, bukan pada setiap video secara terpisah. Batas durasi penagihan tidak menentukan batas unggahan.

Tanpa video referensi, Reference-to-Video menggunakan aturan penagihan yang sama dengan Text-to-Video, baik gambar atau audio referensi disertakan maupun tidak. Untuk permintaan dengan masukan video, gambar referensi, audio referensi, dan keep_original_sound yang didukung tidak menimbulkan biaya terpisah.

Format Respons

Respons Awal

Semua model mengembalikan task_id untuk pemeriksaan berkala:

jsonSalin
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Lakukan pemeriksaan berkala menggunakan GET /api/v1/video/{task_id} untuk memeriksa status dan mengambil video yang dihasilkan.

Nilai Status

• submitted: Tugas diterima dan menunggu diproses
• processing: Pembuatan video sedang berlangsung
• succeed: Pembuatan video selesai
• failed: Pembuatan video gagal

Praktik Terbaik

1. Parameter Wajib: Selalu sertakan resolution dan duration, termasuk saat menggunakan resolusi default 720p
2. Jumlah Bingkai: Pastikan jumlah gabungan bingkai pertama, akhir, dan perantara tidak melebihi 10
3. Media Referensi: Pastikan jumlah dan durasi media referensi tidak melebihi batas yang didokumentasikan
4. Suara Asli: Gunakan keep_original_sound hanya untuk Reference-to-Video atau Video Edit
5. Perpanjangan Video: Atur duration ke durasi tambahan dan jangan sertakan aspect_ratio