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-video-o1",
    "prompt": "Make the person in <<<image_1>>> wave at the camera",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230426123070-e9d6af04-cb5e-4731-8ae7-abf144cb0d29-9998230586368386-29641169-f698-4ab9-9b6d-380899e6521e-9998230593110693-c1741a3a-.webp"],
    "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-video-o1",
    "prompt": "Make the person in <<<image_1>>> wave at the camera",
    "image_urls": ["https://upload.apimart.ai/f/models/9998230426123070-e9d6af04-cb5e-4731-8ae7-abf144cb0d29-9998230586368386-29641169-f698-4ab9-9b6d-380899e6521e-9998230593110693-c1741a3a-.webp"],
    "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-video-o1 - Kling Video O1 (penalaran ditingkatkan, kualitas tertinggi)
​
prompt
string
wajib
Prompt teks positifMendukung referensi gambar dari image_urls menggunakan sintaks <<<image_N>>>, dengan N dimulai dari 1.Contoh: "Make the person in <<<image_1>>> wave at the camera"
Jika gambar diberikan tetapi prompt tidak berisi referensi <<<image_N>>>, sistem akan otomatis menambahkan <<<image_1>>> di awal prompt.
​
mode
string
default:"std"
Mode pembuatanOpsi:
  • std - Mode standar (720P)
  • pro - Mode profesional (1080P)
Default: std
​
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
​
image_urls
array<url>
Array URL gambar untuk referensi gambarReferensikan gambar yang sesuai dalam prompt menggunakan sintaks <<<image_N>>> (N dimulai dari 1)Contoh: ["https://example.png"]
  • URL gambar harus dapat diakses publik tanpa proteksi hotlink
  • Dalam mode gambar-ke-video, aspect_ratio dapat ditimpa oleh rasio gambar aktual
  • Hingga dua gambar. Item pertama dalam array adalah frame awal, dan item kedua adalah frame akhir
​
video_list
array
Daftar video referensi (berbasis URL), hingga 1 video.Gunakan refer_type untuk membedakan jenis:
  • base: video yang akan diedit (default)
  • feature: video referensi fitur
Gunakan keep_original_sound untuk mengontrol apakah audio asli dipertahankan:
  • no: jangan pertahankan (default)
  • yes: pertahankan suara asli
Format request:
"video_list":[
  { "video_url": "video_url", "refer_type": "base", "keep_original_sound": "no" }
]
  • video_url tidak boleh kosong, dan URL video harus dapat diakses
  • Saat refer_type=base:
    • Frame awal/akhir tidak dapat ditentukan
    • Video referensi harus 3-10 detik
    • Durasi video yang dibuat mengikuti video yang diunggah
  • Saat refer_type=feature dan video_url tidak kosong:
    • image_urls hanya dapat berisi gambar frame pertama
  • Persyaratan video: hanya MP4/MOV; durasi minimal 3 detik; resolusi 720px-2160px; frame rate 24-60fps (output 24fps); ukuran tidak lebih dari 200MB

​
Sintaks Referensi Gambar

Model Video O1 menggunakan sintaks <<<image_N>>> untuk merujuk gambar dalam prompt, memberikan pengalaman teks-ke-video/gambar-ke-video yang terpadu:
SintaksDeskripsi
<<<image_1>>>Merujuk gambar ke-1 dalam array image_urls
<<<image_2>>>Merujuk gambar ke-2 dalam array image_urls
Referensi Otomatis: Jika image_urls disediakan tetapi prompt tidak berisi referensi <<<image_N>>> apa pun, sistem akan otomatis menambahkan <<<image_1>>> di awal prompt.

​
Respons

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

​
Kasus Penggunaan

​
Kasus 1: Teks-ke-Video (Kualitas Tertinggi)

{
  "model": "kling-video-o1",
  "prompt": "A cinematic shot of a city skyline at golden hour",
  "mode": "pro",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Kasus 2: Referensi Gambar (Satu Gambar)

{
  "model": "kling-video-o1",
  "prompt": "Make the person in <<<image_1>>> wave at the camera",
  "image_urls": ["https://upload.apimart.ai/f/models/9998230426123070-e9d6af04-cb5e-4731-8ae7-abf144cb0d29-9998230586368386-29641169-f698-4ab9-9b6d-380899e6521e-9998230593110693-c1741a3a-.webp"],
  "mode": "pro",
  "duration": 5
}

​
Kasus 3: Beberapa Referensi Gambar

{
  "model": "kling-video-o1",
  "prompt": "The character in <<<image_1>>> walks toward the scene in <<<image_2>>>",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/scene.jpg"
  ],
  "mode": "pro",
  "duration": 5
}

​
Kasus 4: Gambar Diberikan Tanpa Referensi Eksplisit (Ditambahkan Otomatis)

{
  "model": "kling-video-o1",
  "prompt": "The person slowly turns and smiles",
  "image_urls": ["https://upload.apimart.ai/f/models/9998230426123070-e9d6af04-cb5e-4731-8ae7-abf144cb0d29-9998230586368386-29641169-f698-4ab9-9b6d-380899e6521e-9998230593110693-c1741a3a-.webp"],
  "mode": "std",
  "duration": 5
}
Sistem akan otomatis menambahkan <<<image_1>>> di awal prompt, setara dengan "<<<image_1>>>The person slowly turns and smiles".
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.