Langsung ke konten utama
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-v2-6",
    "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-v2-6",
    "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
Otorisasi

​
Authorization
string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header request:
Authorization: Bearer YOUR_API_KEY

​
Parameter Request

​
model
string
wajib
Nama model pembuatan videoModel yang didukung:
  • kling-v2-6 - Kling v2.6 (direkomendasikan)
​
prompt
string
wajib
Prompt teks, maksimum 2500 karakterJelaskan adegan, aksi, dan gaya secara detail untuk hasil pembuatan yang lebih baikContoh: "A golden cat running on a sunlit meadow, slow motion, cinematic quality"
​
mode
string
default:"std"
Mode pembuatanOpsi:
  • std - Mode standar (720P, hanya video tanpa suara)
  • pro - Mode profesional (1080P, mendukung pembuatan audio otomatis)
Default: std
Batasan mode standar: Mode std hanya mendukung video tanpa suara. Parameter audio memerlukan mode pro.
​
duration
integer
default:"5"
Durasi video (detik)Opsi: 5 atau 10Default: 5
​
aspect_ratio
string
default:"16:9"
Rasio aspek videoOpsi:
  • 16:9 - Lanskap
  • 9:16 - Potret
  • 1:1 - Persegi
Default: 16:9
​
negative_prompt
string
Prompt negatif untuk mengecualikan konten yang tidak diinginkanContoh: "blurry, low quality, distorted"
​
image_urls
array<url>
Array URL gambar untuk pembuatan gambar-ke-video
  • Berikan 1 gambar: digunakan sebagai bingkai pertama
  • Berikan 2 gambar: secara otomatis ditetapkan sebagai bingkai pertama + bingkai terakhir (memerlukan mode: "pro")
Maksimum 2 gambar didukungContoh: ["https://example.com/first.jpg"]
  • Maksimum 2 gambar yang didukung
  • Bingkai terakhir (2 gambar) hanya memerlukan mode pro; mode std hanya mendukung bingkai pertama (1 gambar)
  • Bingkai terakhir dan audio saling eksklusif: Dalam mode pro, bingkai terakhir (2 gambar) dan audio (audio: true) tidak dapat digunakan bersamaan
  • Dalam mode gambar-ke-video, aspect_ratio dapat ditimpa oleh rasio gambar aktual
​
audio
boolean
default:"false"
Apakah membuat audio secara otomatisDefault: false
  • Hanya tersedia dalam mode: "pro"
  • Saling eksklusif dengan bingkai terakhir: Audio tidak dapat digunakan bersamaan dengan bingkai terakhir (2 gambar)
​
watermark
boolean
Apakah menambahkan watermark

​
Matriks Dukungan Fitur

TypeFiturstd 5sstd 10spro 5spro 10s
Teks-ke-VideoPembuatan✅ (hanya tanpa suara)✅ (hanya tanpa suara)✅✅
Teks-ke-VideoAudio Otomatis--✅✅
Gambar-ke-VideoPembuatan✅ (hanya tanpa suara)✅ (hanya tanpa suara)✅✅
Gambar-ke-VideoBingkai Pertama✅✅✅✅
Gambar-ke-VideoBingkai Terakhir--✅✅
Gambar-ke-VideoAudio Otomatis--✅✅
Catatan: Dalam mode pro, kontrol bingkai terakhir dan audio saling eksklusif dan tidak dapat digunakan bersamaan.

​
Teks-ke-Video vs Gambar-ke-Video

Sistem otomatis menentukan mode berdasarkan apakah image_urls disediakan: tanpa gambar berarti teks-ke-video, dengan gambar berarti gambar-ke-video.
ParameterTeks-ke-VideoGambar-ke-Video
prompt✅ Wajib✅ Wajib
image_urls❌ Tidak digunakan✅ Wajib (1-2 gambar, bingkai terakhir memerlukan pro)
negative_prompt✅ Opsional✅ Opsional
mode✅ Opsional✅ Opsional
duration✅ Opsional✅ Opsional
aspect_ratio✅ Opsional⚠️ Dapat ditimpa oleh rasio gambar
audio✅ Opsional (memerlukan pro)✅ Opsional (memerlukan pro)
watermark✅ Opsional✅ Opsional

​
Respons

​
code
integer
Kode status respons, 200 jika berhasil
​
data
array
Array data respons

​
Kasus Penggunaan

​
Kasus 1: Teks-ke-Video (Mode Standar)

{
  "model": "kling-v2-6",
  "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Kasus 2: Teks-ke-Video (Mode Pro + Prompt Negatif)

{
  "model": "kling-v2-6",
  "prompt": "Tokyo Shibuya crossing at night, neon lights reflected on wet ground, people walking with umbrellas",
  "negative_prompt": "blurry, low quality, distorted",
  "mode": "pro",
  "duration": 10,
  "aspect_ratio": "16:9"
}

​
Kasus 3: Gambar-ke-Video (Frame Pertama)

{
  "model": "kling-v2-6",
  "prompt": "The person in the frame turns and smiles",
  "image_urls": ["https://example.com/portrait.jpg"],
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Kasus 4: Gambar-ke-Video (Kontrol Frame Pertama + Terakhir)

{
  "model": "kling-v2-6",
  "prompt": "City timelapse transitioning from day to night",
  "image_urls": ["https://example.com/day-city.jpg", "https://example.com/night-city.jpg"],
  "mode": "pro",
  "duration": 5
}

​
Kasus 5: Mode Pro + Audio Otomatis

{
  "model": "kling-v2-6",
  "prompt": "Waves crashing against rocks, seagulls circling in the sky, lighthouse in the distance",
  "mode": "pro",
  "duration": 10,
  "audio": true,
  "aspect_ratio": "16:9"
}
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.