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.5-preview",
    "prompt": "Sunset coastal highway, cinematic shot",
    "size": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "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.5-preview",
    "prompt": "Sunset coastal highway, cinematic shot",
    "size": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

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

​
Autentikasi

​
Authorization
string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key: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.5-preview
​
prompt
string
Deskripsi konten videoWajib untuk teks-ke-video (tanpa image_urls), opsional tetapi direkomendasikan untuk gambar-ke-videoJelaskan adegan, aksi, dan gaya secara detail untuk hasil yang lebih baikContoh: "Sunset coastal highway, cinematic shot"
​
image_urls
array<string>
Array URL gambar referensi (hanya 1 gambar didukung)Wajib untuk mode gambar-ke-video, mendukung URL gambar yang dapat diakses publik atau encoding Base64 (data:image/png;base64,...)Contoh: ["https://example.com/image.jpg"]
Sistem otomatis memilih mode teks-ke-video atau gambar-ke-video berdasarkan apakah image_urls disertakan. Jangan mengirim image_urls untuk mode teks-ke-video.
​
negative_prompt
string
Prompt negatif, menjelaskan konten yang tidak diinginkanMaksimum 500 karakterContoh: "blurry, low quality, distorted"
​
resolution
string
default:"720p"
Resolusi videoOpsi:
  • 480p - SD, mendukung size: 16:9, 9:16, 1:1
  • 720p - HD (default), mendukung size: 16:9, 9:16, 1:1, 4:3, 3:4
  • 1080p - FHD, mendukung size: 16:9, 9:16, 1:1, 4:3, 3:4
Default: 720p
Resolusi secara langsung memengaruhi harga: 1080p > 720p > 480p.
480p hanya mendukung rasio 16:9, 9:16, 1:1. Mengirim 4:3 atau 3:4 akan menyebabkan error.
​
duration
integer
default:"5"
Durasi video (detik)Hanya mendukung: 5 atau 10 detikDefault: 5
​
size
string
default:"16:9"
Rasio aspek, hanya berlaku untuk teks-ke-video (tanpa image_urls)Opsi tergantung pada resolution:480p:
  • 16:9 - Lanskap (default)
  • 9:16 - Potret
  • 1:1 - Persegi
720p / 1080p:
  • 16:9 - Lanskap (default)
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Default: 16:9
Untuk gambar-ke-video, rasio aspek ditentukan oleh gambar input. Jangan mengirim size, jika tidak error akan dikembalikan.
​
seed
integer
Random seed (≥0), menetapkan seed yang sama dapat mereproduksi hasil serupaContoh: 12345
​
prompt_extend
boolean
default:"true"
Apakah mengaktifkan penulisan ulang prompt cerdasSecara signifikan meningkatkan hasil untuk prompt yang lebih pendek, tetapi menambah waktu pemrosesanDefault: true
​
audio
boolean
default:"true"
Apakah menambahkan audio secara otomatisJika diaktifkan, sistem akan membuat audio yang sesuai untuk videoDefault: true
Model ini hanya mendukung audio=true. Mengatur ke false untuk video tanpa suara tidak didukung.
​
audio_url
string
URL audio kustom (wav/mp3, 3-30 detik, ≤ 15MB)Jika audio lebih panjang dari durasi video, audio akan dipotong secara otomatis; jika lebih pendek, bagian sisanya tanpa suara
Persyaratan file audio:
  • Format: wav, mp3
  • Durasi: 3-30 detik
  • Ukuran: ≤ 15MB
​
watermark
boolean
default:"false"
Apakah menambahkan watermark “AI Dihasilkan” (kanan bawah)Default: false

​
Kombinasi Resolusi dan Rasio Aspek

Kombinasi size dan resolution dipetakan ke dimensi piksel upstream (hanya berlaku untuk teks-ke-video):
Rasio AspekDeskripsiUkuran 480pUkuran 720pUkuran 1080p
16:9Lanskap (default)832×4801280×7201920×1080
9:16Potret480×832720×12801080×1920
1:1Persegi624×624960×9601440×1440
4:3Lanskap-1088×8321632×1248
3:4Potret-832×10881248×1632
480p hanya mendukung rasio 16:9, 9:16, 1:1. Mengirim 4:3 atau 3:4 akan menyebabkan error. 720p dan 1080p mendukung semua 5 rasio.

​
Respons

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

​
Kasus Penggunaan

​
Kasus 1: Teks-ke-Video (Sederhana)

{
  "model": "wan2.5-preview",
  "prompt": "Sunset coastal highway, cinematic shot"
}

​
Kasus 2: Teks-ke-Video (Parameter Lengkap)

{
  "model": "wan2.5-preview",
  "prompt": "City night scene, neon lights and rain-soaked streets",
  "negative_prompt": "blurry, low quality, distorted",
  "size": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "watermark": false
}

​
Kasus 3: Gambar-ke-Video

{
  "model": "wan2.5-preview",
  "prompt": "Cat running on the grass",
  "image_urls": ["https://example.com/cat.jpg"],
  "resolution": "480p",
  "duration": 5
}

​
Kasus 4: Gambar-ke-Video (Base64 Gambar)

{
  "model": "wan2.5-preview",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

​
Kasus 5: Audio Kustom

{
  "model": "wan2.5-preview",
  "prompt": "Person dancing to the music",
  "image_urls": ["https://example.com/dancer.jpg"],
  "audio_url": "https://example.com/music.mp3",
  "resolution": "720p",
  "duration": 10
}

​
Deskripsi Mode

​
Teks-ke-Video

  • Parameter prompt wajib
  • Jangan mengirim image_urls
  • Gunakan size untuk menentukan rasio aspek

​
Gambar-ke-Video

  • Parameter image_urls wajib (hanya 1 gambar didukung)
  • prompt opsional, digunakan untuk menjelaskan aksi yang diharapkan
  • Rasio aspek ditentukan oleh gambar input, jangan mengirim size
Sistem otomatis memilih mode berdasarkan apakah image_urls disertakan
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.