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": "viduq3-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "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": "viduq3-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "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 permintaan:
Authorization: Bearer YOUR_API_KEY

​
Parameter Permintaan

​
model
string
wajib
Nama model pembuatan videoModel yang didukung:
  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
​
prompt
string
wajib
Prompt teks, maksimum 2000 karakterWajib untuk teks-ke-video. Opsional untuk mode gambar-ke-video dan frame pertama-terakhir.Contoh: "A cat playing piano, camera slowly zooms in"
​
duration
integer
default:"5"
Durasi video (detik)Rentang: 1 hingga 16Default: 5
​
resolution
string
default:"720p"
Resolusi videoOpsi:
  • 540p - Definisi standar
  • 720p - HD (default)
  • 1080p - Full HD
Default: 720p
​
aspect_ratio
string
Rasio aspek video (hanya untuk mode teks-ke-video)Opsi:
  • 16:9 - Lanskap
  • 9:16 - Potret
  • 4:3 - Tradisional
  • 3:4 - Potret tradisional
  • 1:1 - Persegi
Parameter ini hanya tersedia dalam mode teks-ke-video (saat image_urls tidak disediakan).
​
image_urls
array<url>
Array URL gambar untuk pembuatan gambar-ke-videoSistem otomatis menentukan mode pembuatan berdasarkan jumlah gambar:
  • 0 gambar (tidak disediakan): Mode teks-ke-video
  • 1 gambar: Mode gambar-ke-video (gambar digunakan sebagai frame awal)
  • 2 gambar: Mode frame pertama-terakhir (gambar pertama = frame pertama, gambar kedua = frame terakhir)
Contoh: ["https://example.com/photo.jpg"]
  • Maksimum 2 gambar didukung
  • Untuk mode frame pertama-terakhir, tepat 2 gambar harus disediakan
  • Saat image_urls disediakan (baik 1 atau 2 gambar), parameter aspect_ratio tidak dapat digunakan — rasio aspek video akan ditentukan otomatis oleh gambar
​
audio
boolean
default:"true"
Apakah membuat audio (dialog, efek suara)Default: trueAtur ke false jika Anda membutuhkan video tanpa suara.
​
seed
integer
Seed integer untuk mengontrol keacakan konten yang dihasilkanRentang: integer antara -1 dan 2^32-1
  • Dengan permintaan yang sama, nilai seed berbeda (termasuk tidak ditentukan atau -1 yang menggunakan angka acak) akan menghasilkan hasil yang berbeda
  • Dengan permintaan yang sama, nilai seed yang sama akan menghasilkan hasil yang serupa, namun reproduktifitas persis tidak dijamin

​
Perutean Otomatis

Sistem otomatis menentukan mode pembuatan berdasarkan jumlah gambar dalam image_urls:
Jumlah GambarModeDeskripsi
0 (tidak disediakan)Teks-ke-VideoBuat dari deskripsi teks saja
1Gambar-ke-VideoGunakan gambar sebagai frame awal
2Frame Pertama-TerakhirGambar pertama = frame pertama, gambar kedua = frame terakhir

​
Matriks Dukungan Parameter

ParameterTeks-ke-VideoGambar-ke-VideoFrame Pertama-Terakhir
model✅ Wajib✅ Wajib✅ Wajib
prompt✅ WajibOpsionalOpsional
image_urls-✅ 1 gambar✅ 2 gambar
duration✅ 1-16 dtk✅ 1-16 dtk✅ 1-16 dtk
resolution✅✅✅
aspect_ratio✅--
audio✅✅✅
seed✅✅✅

​
Respons

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

​
Kasus Penggunaan

​
Kasus 1: Teks-ke-Video

{
  "model": "viduq3-pro",
  "prompt": "A cat playing piano, camera slowly zooms in",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
Kasus 2: Gambar-ke-Video (Gambar Tunggal)

{
  "model": "viduq3-pro",
  "prompt": "The person slowly turns and smiles",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
Kasus 3: Video Frame Pertama-Terakhir

{
  "model": "viduq3-pro",
  "prompt": "The person gradually sits down from standing",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
Kasus 4: Video Tanpa Suara (Audio Dinonaktifkan)

{
  "model": "viduq3-pro",
  "prompt": "Sunset seascape timelapse photography",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.