Kling 4.0

Kemampuan

Harga & kredit

Pembuatan video dikenakan biaya dalam bentuk kredit berdasarkan durasi tagihan dalam hitungan detik. Tanpa input video, durasi tagihan adalah durasi output; dengan input video, durasi tagihan juga mencakup durasi video referensi.

Tabel di bawah ini mencantumkan biaya kredit yang dikenakan per detik, bukan total biaya dari suatu tugas. Tarif bergantung pada model, resolusi output, dan apakah video referensi disediakan dalam mode reference-to-video. Lihat rumus dan contoh di bawah tabel untuk perhitungan total biaya.

• Tanpa input video: detik output × tarif tanpa-video.
• Jika ada masukan video, T adalah total durasi video referensi dalam detik yang diukur server. Jumlah kredit akhir dibulatkan ke atas. ceil((duration + max(duration, T)) × rate)
• Referensi gambar atau audio saja menggunakan tarif tanpa-video. Tarif penagihan video referensi hanya berlaku dalam mode referensi-ke-video saat referensi video disertakan.

Kredit dicadangkan saat pengiriman dan didebit setelah berhasil. Tugas yang gagal atau habis waktu (timeout) akan masuk ke alur pengembalian dana. Status penagihan refund_failed berarti pengembalian dana tidak selesai; periksa log API atau hubungi dukungan.

Autentikasi

Buat kunci API di dasbor. Kunci lengkap hanya akan ditampilkan sekali. Simpan di server Anda dan kirimkan sebagai Bearer token pada setiap permintaan.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Atur variabel lingkungan SEEVIO_API_KEY sebelum menjalankan contoh ini. Contoh JavaScript dijalankan di server Anda menggunakan Node.js; contoh Python menggunakan paket requests.

Mulai cepat

Kirim permintaan minimal ini, simpan taskId yang dikembalikan, lalu gunakan contoh kueri tugas di bawah ini. Nilai kredit dalam respons pembuatan adalah jumlah yang dicadangkan.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling-4-0",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video"
  }
}'

Contoh respons pembuatan tugas

Setelah permintaan di atas diterima, API akan mengembalikan respons JSON ini. taskId adalah pengenal tugas yang digunakan untuk kueri status berikutnya; credits adalah jumlah kredit yang dicadangkan untuk tugas ini. Respons ini hanya mengonfirmasi pembuatan tugas, bukan berarti video telah siap. Anda perlu melakukan polling status tugas atau menggunakan Webhook untuk menerima hasil video.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 65
}

Buat tugas

Kirim objek JSON yang berisi model dan input, serta callback_url opsional. Selalu tentukan ID model yang ditampilkan di halaman ini; jika model tidak ditentukan, sistem otomatis memilih seedance-2-0.

Isi permintaan

Parameter input

Respons pembuatan

HTTP 200 mengembalikan taskId (string) dan credits (number). Ini menyatakan diterimanya pembuatan tugas, bukan penyelesaiannya. Jumlah di bawah ini sesuai dengan mulai cepat 720p berdurasi 5 detik.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 65
}

Mode pembuatan & contoh

Teks ke video

Hasilkan dari prompt teks. URL media tidak diteruskan dalam mode ini.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling-4-0",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video"
  }
}'

Bingkai pertama

Sediakan satu gambar sebagai bingkai pertama, lalu deskripsikan gerakannya dalam prompt Anda.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling-4-0",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first.jpg"
    ]
  }
}'

Bingkai pertama dan terakhir

Untuk video dari gambar, kirim bingkai pertama lalu bingkai terakhir jika perlu. Mode referensi menerima hingga 10 gambar.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling-4-0",
  "input": {
    "prompt": "",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first.jpg",
      "https://example.com/last.jpg"
    ]
  }
}'

Contoh bingkai kunci: mawar mekar

Buat video selang waktu 8 detik dari empat foto dengan sudut yang sama. Di image_urls, masukkan kuncup tertutup lalu mawar yang mekar penuh sebagai bingkai awal dan akhir. Di keyframe_urls, masukkan kelopak yang mulai terbuka lalu bunga yang setengah mekar. Video bergerak dari kuncup melalui kedua tahap tersebut hingga mekar penuh. Urutan larik menentukan urutan bingkai, sedangkan model menentukan waktunya.

Ganti URL media example.com dengan file HTTPS Anda sendiri yang dapat diakses publik. URL contoh ini hanya menunjukkan struktur permintaan dan bukan aset sampel yang dapat diunduh.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling-4-0",
  "input": {
    "prompt": "A time-lapse of a rose opening. Keep the camera still and the light soft as the petals unfold.",
    "duration": 8,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/rose-bud.jpg",
      "https://example.com/rose-full-bloom.jpg"
    ],
    "keyframe_urls": [
      "https://example.com/rose-opening.jpg",
      "https://example.com/rose-half-open.jpg"
    ]
  }
}'

Referensi multimodal

Gabungkan referensi gambar, video, dan audio. Prompt tetap wajib diisi. Input video referensi akan mengubah formula penagihan.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling-4-0",
  "input": {
    "prompt": "Animate @Image1 with the movement of @Video1 and ambience from @Audio1.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/motion.mp4"
    ],
    "audio_urls": [
      "https://example.com/surf.mp3"
    ],
    "keep_original_sound": false
  }
}'

Kueri tugas

Ganti ID contoh dengan taskId yang dikembalikan oleh pembuatan. Kueri hanya mengembalikan tugas milik pengguna dari kunci API tersebut; ID yang tidak dapat diakses atau tidak dikenal akan mengembalikan HTTP 404.

Lakukan polling setiap 10–20 detik sebagai permulaan, kurangi frekuensi pada HTTP 429, dan hentikan saat status telah selesai atau gagal. Gunakan webhook untuk produksi. Setiap contoh kode di bawah ini melakukan satu kueri.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"

Tugas selesai: respons kueri dengan hasil video

Ketika kueri mengembalikan status=completed, pembuatan video telah selesai. Ambil URL video dari data.results dan unduh sebelum data.video_expires_at. billing_status=charged menunjukkan bahwa kredit yang dicadangkan telah terpotong.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "kling-4-0",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 65,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Tugas gagal: respons kueri dengan detail kegagalan dan penagihan

Ketika kueri mengembalikan status=failed, proses pembuatan video gagal. Lihat failed_reason untuk mengetahui penyebabnya dan billing_status untuk hasil pengembalian dana. Pada contoh ini, refunded berarti kredit telah dikembalikan. credits tetap menampilkan jumlah awal yang dicadangkan, dan respons tidak menyertakan data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "kling-4-0",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 65,
  "failed_reason": "provider_failed"
}

Webhook

Atur callback_url dalam permintaan buat untuk menerima POST JSON saat tugas selesai atau gagal. Kembalikan respons 2xx dalam waktu 15 detik. Pengiriman yang gagal akan dicoba kembali; proses pengiriman berulang secara idempoten berdasarkan ID tugas.

Endpoint callback Anda harus menerima permintaan POST dengan body permintaan JSON (Content-Type: application/json).

Buat tugas dengan callback

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling-4-0",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video"
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Tugas selesai: payload callback sukses

Saat pembuatan berhasil, callback akan berisi status=completed. Gunakan id untuk mengidentifikasi tugas dan data.results untuk mengambil URL video. Unduh dan simpan hasilnya sebelum data.video_expires_at.

created_at adalah waktu pembuatan peristiwa; task_created_at adalah waktu pembuatan tugas, dalam detik Unix. Contoh menampilkan kolom yang disarankan; respons dapat memuat kolom tambahan.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "kling-4-0",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 65,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Tugas gagal: payload callback gagal

Saat pembuatan gagal, callback akan berisi status=failed. Gunakan id untuk mengidentifikasi tugas, failed_reason untuk melihat alasan kegagalan, dan credits_refunded untuk melihat jumlah kredit yang dikembalikan.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "kling-4-0",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 65,
  "failed_reason": "provider_failed",
  "credits_refunded": 65
}

Contoh penerima

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Contoh Next.js ini membaca body callback JSON dan menangani tugas yang berhasil serta gagal secara langsung. Tambahkan persistensi dan deduplikasi ID tugas untuk aplikasi Anda; antrekan pekerjaan yang lambat sebelum mengonfirmasi callback.

Persyaratan & batasan media

• Semua media dan URL callback harus berupa URL HTTPS publik. Hindari localhost, IP privat, dan file yang memerlukan cookie atau masuk log. URL referensi video/audio harus mengarah ke media yang dapat dibaca secara langsung.
• Ukuran setiap video tidak boleh lebih dari 100 MB.
• Ukuran setiap file audio tidak boleh lebih dari 15 MB.
• Hingga total 15 file referensi