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.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "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.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "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.6
​
prompt
string
wajib
Deskripsi konten videoWajib untuk mode teks-ke-video. Jelaskan adegan, aksi, dan gaya secara detail untuk hasil yang lebih baikContoh: "A cute cat stretching in the sunlight"
​
image_urls
array<url>
Array URL gambar referensi (hanya 1 gambar didukung)Wajib untuk mode gambar-ke-video. Mendukung URL gambar yang dapat diakses publikContoh: ["https://example.com/image.jpg"]
Sistem otomatis memilih mode teks-ke-video atau gambar-ke-video berdasarkan apakah image_urls disertakan
​
negative_prompt
string
Prompt negatif yang menjelaskan konten yang tidak diinginkanContoh: "blurry, low quality, distorted"
​
aspect_ratio
string
default:"16:9"
Rasio aspek videoOpsi:
  • 16:9 - Lanskap (default)
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Lanskap
  • 3:4 - Potret
Default: 16:9
Tidak didukung dalam mode gambar-ke-video
​
resolution
string
default:"720p"
Resolusi videoOpsi:
  • 720p - Standar (default)
  • 1080p - Definisi tinggi
Default: 720p
Resolusi 480p tidak didukung
Ditagih per detik. Harga bervariasi berdasarkan resolusi. Silakan lihat marketplace model untuk harga spesifik
​
duration
integer
default:"5"
Durasi video (detik)Nilai yang didukung: hanya 5, 10, atau 15 detikDefault: 5
​
seed
integer
Seed acak untuk hasil yang dapat direproduksiContoh: 12345
​
prompt_extend
boolean
Apakah memperluas prompt secara otomatisJika diaktifkan, sistem akan otomatis mengoptimalkan dan memperkaya prompt Anda
​
audio
boolean
Apakah akan menambahkan audio secara otomatisJika diaktifkan, sistem akan membuat audio yang sesuai untuk video
​
audio_url
string
URL audio yang ditentukanMemiliki prioritas di atas parameter audio
Durasi audio tidak boleh melebihi durasi video. Jika audio lebih pendek dari durasi video, bagian pertama video akan memiliki suara sementara sisanya akan tanpa suara.
​
shot_type
string
Jenis shotOpsi:
  • single - Shot tunggal
  • multi - Beberapa shot
​
watermark
boolean
Apakah menambahkan watermark
​
template
string
Nama template efek untuk mode efek khusus gambar-ke-video
Saat menggunakan mode efek:
  • Hanya satu gambar yang wajib (diberikan melalui image_urls)
  • Prompt tidak diperlukan (model mengabaikan field prompt)
Efek Umum:
  • squish - Squish & Squeeze
  • rotation - Rotation
  • poke - Poke
  • inflate - Balloon Inflate
  • dissolve - Molecular Dissolve
  • melt - Heat Wave Melt
  • icecream - Ice Cream Planet
  • flying - Magic Levitation
Efek Satu Orang:
  • carousel - Time Carousel
  • singleheart - Love You
  • dance1 - Swing Moment
  • dance2 - Dance Move
Untuk efek lebih banyak, lihat Dokumentasi Template Alibaba Wanxiang

​
Kombinasi Resolusi dan Rasio Aspek

Aspek RasioDeskripsi720p Size1080p Size
16:9Lanskap (default)1280×7201920×1080
9:16Potret720×12801080×1920
1:1Persegi960×9601440×1440
4:3Lanskap1088×8321632×1248
3:4Potret832×10881248×1632

​
Respons

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

​
Kasus Penggunaan

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

{
  "model": "wan2.6",
  "prompt": "A cute cat stretching in the sunlight"
}

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

{
  "model": "wan2.6",
  "prompt": "A cute cat running on the grass",
  "negative_prompt": "blurry, low quality, distorted",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

​
Kasus 3: Gambar-ke-Video

{
  "model": "wan2.6",
  "prompt": "A kitten running on the ground",
  "image_urls": ["https://upload.apimart.ai/f/apimart-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

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

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

​
Deskripsi Mode

​
Teks-ke-Video

  • Parameter prompt wajib
  • Parameter image_urls tidak diperlukan

​
Gambar-ke-Video

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