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": "wan2.7-r2v",
    "prompt": "This person walks down the street surrounded by heavy traffic",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

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

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": "wan2.7-r2v",
    "prompt": "This person walks down the street surrounded by heavy traffic",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

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

​
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 permintaan:
Authorization: Bearer YOUR_API_KEY

​
Parameter Permintaan

​
model
string
wajib
Nama model pembuatan video, tetap sebagai wan2.7-r2v
​
prompt
string
wajib
Deskripsi konten video, hingga 5000 karakterUntuk beberapa gambar/video, gunakan “gambar 1”, “gambar 2”, “video 1”, dll. untuk merujuk ke aset referensi terkait (sesuai urutan input)Contoh: "The character in image 1 enters the scene in image 2 and looks around"
​
image_with_roles
array<object>
Array gambar dengan role; setidaknya salah satu dari field ini dan video_urls harus disediakanField untuk setiap objek:
  • url (string): URL gambar
  • role (string): role gambar
    • reference_image - gambar referensi (default)
    • first_frame - bingkai pertama yang ditentukan (saat disediakan, size diabaikan dan rasio aspek mengikuti gambar bingkai pertama)
  • reference_voice (string, opsional): URL sampel audio suara untuk karakter referensi tersebut, digunakan untuk mengontrol suara karakter dalam video yang dihasilkan
Contoh:
[
  {
    "url": "https://cdn.example.com/character.jpg",
    "role": "reference_image",
    "reference_voice": "https://cdn.example.com/voice_sample.mp3"
  },
  { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
]
​
video_urls
array<string>
Array URL video referensi, hingga 5 video (total gambar + video ≤ 5)Setidaknya salah satu dari field ini dan image_with_roles harus disediakan
Batasan video:
  • Format: mp4, mov
  • Durasi: 1–30 detik
  • Resolusi: lebar dan tinggi dalam rentang [240, 4096] piksel
  • Rasio aspek: 1:8 – 8:1
  • Ukuran file: hingga 100MB
​
negative_prompt
string
Prompt negatif yang menjelaskan konten yang tidak diinginkan, hingga 500 karakter
​
resolution
string
default:"1080P"
Resolusi videoOpsi:
  • 720P - Standar
  • 1080P - Definisi tinggi (default)
​
duration
integer
default:"5"
Durasi video (detik)Rentang yang didukung: 2 ~ 15 detikDefault: 5
Ketika aset referensi mencakup video: bilangan bulat antara [2, 10].Ketika aset referensi tidak mencakup video: bilangan bulat antara [2, 15].
​
size
string
default:"16:9"
Rasio aspekFormat yang didukung:
  • 16:9 - Lanskap layar lebar (default)
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Saat first_frame disediakan melalui image_with_roles, parameter ini diabaikan dan rasio aspek mengikuti gambar frame pertama
​
prompt_extend
boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt pendek, namun menambah waktu pemrosesanDefault: true
​
watermark
boolean
default:"false"
Apakah akan menambahkan watermark “AI Generated” ke video yang dihasilkan
  • true: tambahkan watermark
  • false: tanpa watermark (default)
​
seed
integer
Seed bilangan bulat yang digunakan untuk mengontrol keacakan konten yang dihasilkanRentang nilai: bilangan bulat ≥0
  • Untuk permintaan yang identik, model menghasilkan hasil yang berbeda saat menerima nilai seed yang berbeda (misalnya, menghilangkan seed)
  • Untuk permintaan yang identik, model menghasilkan hasil yang serupa saat menerima nilai seed yang sama, namun konsistensi yang tepat tidak dijamin

​
Respons

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

​
Kasus Penggunaan

​
Kasus 1: Satu Gambar Referensi (Paling Sederhana)

{
  "model": "wan2.7-r2v",
  "prompt": "This person walks down the street surrounded by heavy traffic",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" }
  ]
}

​
Kasus 2: Beberapa Gambar Referensi

{
  "model": "wan2.7-r2v",
  "prompt": "The character in image 1 enters the scene in image 2 and mimics the pose in image 3",
  "image_with_roles": [
    { "url": "https://cdn.example.com/person.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/background.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/pose.jpg", "role": "reference_image" }
  ],
  "resolution": "1080P",
  "duration": 8,
  "size": "16:9"
}

​
Kasus 3: Pembuatan Berdasarkan Video Referensi

{
  "model": "wan2.7-r2v",
  "prompt": "Generate a beach sunset scene in the style of the reference video",
  "video_urls": ["https://cdn.example.com/style_reference.mp4"],
  "resolution": "720P",
  "duration": 8
}

​
Kasus 4: Bingkai Pertama Ditentukan + Gambar Referensi

{
  "model": "wan2.7-r2v",
  "prompt": "The reference character starts from this position and walks forward",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
  ],
  "resolution": "1080P",
  "duration": 8
}

​
Kasus 5: Gambar Referensi + Suara Referensi (Presisi)

{
  "model": "wan2.7-r2v",
  "prompt": "This person walks down the street while speaking",
  "image_with_roles": [
    {
      "url": "https://cdn.example.com/character.jpg",
      "role": "reference_image",
      "reference_voice": "https://cdn.example.com/voice_sample.mp3"
    }
  ],
  "resolution": "1080P",
  "duration": 10
}

​
Aturan Referensi Gambar

Dengan beberapa gambar referensi, gunakan indeks numerik dalam prompt untuk merujuknya:
  • Gambar ke-1 → “gambar 1” atau “gambar pertama”
  • Video ke-1 → “video 1” atau “video pertama”
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.