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-3.0-turbo",
    "prompt": "Seekor corgi berlari di tepi pantai, sinematik, cahaya senja",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-3.0-turbo",
    "prompt": "Seekor corgi berlari di tepi pantai, sinematik, cahaya senja",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

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

​
Autentikasi

​
Authorization
string
wajib
Semua antarmuka memerlukan autentikasi menggunakan Bearer TokenMendapatkan API Key:Kunjungi halaman pengelolaan API Key untuk mendapatkan API Key AndaSaat digunakan, tambahkan pada header permintaan:
Authorization: Bearer YOUR_API_KEY

​
Parameter Permintaan

​
model
string
wajib
Nama model pembuatan videoModel yang didukung:
  • kling-3.0-turbo - Kling 3.0 Turbo
​
prompt
string
wajib
Prompt teksBatas hulu tidak melebihi 3072 karakter, disarankan tidak melebihi 2500 karakter.Contoh: "Seekor corgi berlari di tepi pantai, sinematik, cahaya senja"
​
first_frame_image
string
Mendukung URL gambar atau Base64.
Batas hulu gambar bingkai pertama:
  • Format: .jpg / .jpeg / .png
  • Ukuran: ≤ 50MB
  • Lebar dan tinggi: ≥ 300px
  • Rasio aspek: 1:2.5 ~ 2.5:1
​
aspect_ratio
string
default:"16:9"
Rasio aspek videoNilai yang tersedia:
  • 16:9 - Layar horizontal
  • 9:16 - Layar vertikal
  • 1:1 - Persegi
Nilai default: 16:9
Hanya berlaku untuk teks ke video. Saat gambar ke video, field ini tidak berlaku, rasio video ditentukan oleh gambar bingkai pertama.
​
resolution
string
default:"720p"
Kejernihan videoNilai yang tersedia:
  • 720p
  • 1080p
Nilai default: 720p
​
duration
integer
default:"5"
Durasi video (detik)Rentang nilai: 3-15 (paling singkat 3 detik, paling lama 15 detik)Nilai default: 5⚠️ Perhatian: Harus memasukkan angka murni (seperti 6), jangan menambahkan tanda kutip, jika tidak akan menyebabkan kesalahan
​
watermark
boolean
Apakah menambahkan watermarkHanya dikirim ke hulu jika diberikan secara eksplisit; jika tidak diberikan, watermark tidak ditambahkan.

​
Teks ke Video vs Gambar ke Video

Sistem akan menentukan secara otomatis mode pembuatan berdasarkan apakah first_frame_image disediakan: jika ada gambar bingkai pertama akan menggunakan gambar ke video, jika tidak ada gambar bingkai pertama akan menggunakan teks ke video, pengguna tidak perlu mendeklarasikannya secara eksplisit.
ParameterTeks ke VideoGambar ke Video
prompt✅ Wajib✅ Opsional (jika dikosongkan, dibuat murni berdasarkan gambar bingkai pertama)
first_frame_image❌ Tidak dikirim✅ Wajib
aspect_ratio✅ Opsional❌ Tidak berlaku (rasio ditentukan oleh gambar bingkai pertama)
resolution✅ Opsional✅ Opsional
duration✅ Opsional (3-15)✅ Opsional (3-15)
watermark✅ Opsional✅ Opsional

​
Respons

​
code
integer
Kode status respons, 200 saat berhasil
​
data
array
Array data yang dikembalikan

​
Skenario Penggunaan

​
Skenario 1: Teks ke video (1080P)

{
  "model": "kling-3.0-turbo",
  "prompt": "Seekor corgi berlari di tepi pantai, sinematik, cahaya senja",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

​
Skenario 2: Teks ke video (layar vertikal 720P)

{
  "model": "kling-3.0-turbo",
  "prompt": "Persimpangan Shibuya Tokyo, lampu neon malam hujan terpantul di tanah yang basah, pejalan kaki melintas dengan payung",
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "duration": 10
}

​
Skenario 3: Gambar ke video (gambar bingkai pertama)

{
  "model": "kling-3.0-turbo",
  "prompt": "Kamera perlahan mendekat, tokoh tersenyum",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "720p",
  "duration": 5
}

​
Skenario 4: Gambar ke video murni dari bingkai pertama (tanpa prompt)

{
  "model": "kling-3.0-turbo",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "1080p",
  "duration": 5
}

​
Skenario 5: Pengaturan multi-bidikan (teks ke video)

{
  "model": "kling-3.0-turbo",
  "prompt": "Bidikan 1,2,corgi berlari di tepi pantai；Bidikan 2,3,kamera mendekat tokoh tersenyum；",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}
Mengkueri hasil tugasPembuatan video adalah tugas asinkron, setelah dikirim akan mengembalikan task_id. Gunakan antarmuka Dapatkan status tugas untuk mengkueri progres dan hasil pembuatan.