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": "doubao-seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

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": "doubao-seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

Autentikasi

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:
  • doubao-seedance-2.0 - Versi standar, mendukung teks-ke-video, gambar-ke-video, video frame pertama/terakhir, video referensi, audio referensi, dan video dengan audio
  • doubao-seedance-2.0-fast - Versi cepat, fitur sama seperti versi standar dengan kecepatan pembuatan lebih tinggi
  • doubao-seedance-2.0-face - Mendukung unggahan orang nyata, fitur sama seperti versi standar
  • doubao-seedance-2.0-fast-face - Mendukung unggahan orang nyata, fitur sama seperti versi cepat
prompt
string
Deskripsi konten videoWajib untuk teks-ke-video; opsional untuk gambar-ke-video atau video-referensi-ke-videoDisarankan untuk menentukan subjek, aksi, gerakan kamera, dan gaya dengan jelas agar hasil pembuatan lebih baik
Prompt dibatasi hingga 4000 karakter, tetapi 500 karakter direkomendasikan.
Contoh: "A kitten yawning at the camera"
duration
integer
default:"5"
Durasi video (detik)Rentang yang didukung: 4 hingga 15 detikDefault: 5
size
string
default:"16:9"
Rasio aspek videoOpsi:
  • 16:9 - Lanskap
  • 9:16 - Potret
  • 1:1 - Persegi
  • 4:3 - Rasio tradisional
  • 3:4 - Rasio tradisional vertikal
  • 21:9 - Ultra-wide
  • adaptif - Adaptif (secara otomatis menyesuaikan dengan gambar/video input)
Default: 16:9
resolution
string
default:"480p"
Resolusi videoOpsi:
  • 480p - Definisi standar
  • 720p - Definisi tinggi
  • 1080p - Full HD (hanya didukung oleh doubao-seedance-2.0-face dan doubao-seedance-2.0)
Default: 480p
seed
integer
Seed acak untuk mengontrol keacakan konten yang dibuat
  • Dengan request yang sama, nilai seed yang berbeda akan menghasilkan hasil berbeda
  • Dengan request yang sama, nilai seed yang sama akan menghasilkan hasil mirip, tetapi konsistensi persis tidak dijamin
generate_audio
boolean
default:"false"
Apakah membuat audio (video dengan audio)Saat disetel ke true, video akan menyertakan audio pengiring yang dibuat AIDefault: false
return_last_frame
boolean
default:"false"
Apakah mengembalikan gambar frame terakhirSaat disetel ke true, hasil tugas juga akan mengembalikan URL gambar frame terakhir video, yang dapat digunakan untuk pembuatan video berkelanjutanDefault: false
tools
array<object>
Daftar tool untuk kemampuan tambahan seperti web searchContoh: [{"type": "web_search"}]
image_urls
array<string>
Array URL gambar untuk gambar-ke-videoMendukung dua format:
  • URL gambar reguler: https://example.com/cat.jpg
  • Asset URL (aset yang disetujui): asset://asset_a
Contoh: ["https://example.com/cat.jpg"] atau ["asset://asset_a"]
Asset URL hanya didukung oleh model doubao-seedance-2.0 dan doubao-seedance-2.0-fast. Model lain tidak mendukungnya.
  • image_urls dan image_with_roles tidak dapat digunakan bersamaan
  • Maximum of 9 reference images
image_with_roles
array
Array gambar dengan role, mendukung penentuan frame pertama/frame terakhir
Jika field url menggunakan Asset URL, hanya model doubao-seedance-2.0 dan doubao-seedance-2.0-fast yang didukung. Model lain tidak mendukungnya.
Contoh:
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
Format Asset URL:
[
  {"url": "asset://asset_a", "role": "reference_image"}
]
  • image_urls dan image_with_roles tidak dapat digunakan bersamaan
  • Saat menggunakan gambar frame pertama/frame terakhir, video_urls dan audio_urls tidak tersedia
video_urls
array<string>
Array URL video referensiMendukung dua format:
  • URL video reguler: https://example.com/reference.mp4
  • Asset URL (aset yang disetujui): asset://asset_a
Contoh: ["https://example.com/reference.mp4"] atau ["asset://asset_a"]
Asset URL hanya didukung oleh model doubao-seedance-2.0 dan doubao-seedance-2.0-fast. Model lain tidak mendukungnya.
  • Saat menggunakan gambar frame pertama/frame terakhir (image_with_roles), video referensi tidak tersedia
  • Maksimum 3 video referensi, total durasi harus 15 dtk atau kurang
  • Resolusi video referensi harus antara 480P dan 720P
  • Video referensi tidak boleh berisi orang nyata
audio_urls
array<string>
Array URL audio referensiMendukung dua format:
  • URL audio reguler: https://example.com/speech.wav
  • Asset URL (aset yang disetujui): asset://asset_a
Contoh: ["https://example.com/speech.wav"] atau ["asset://asset_a"]
Asset URL hanya didukung oleh model doubao-seedance-2.0 dan doubao-seedance-2.0-fast. Model lain tidak mendukungnya.
  • Saat menggunakan gambar frame pertama/frame terakhir (image_with_roles), audio referensi tidak tersedia
  • Maksimum 3 file audio referensi, total durasi harus 15 dtk atau kurang
  • Audio referensi harus digunakan bersama gambar referensi atau video referensi

Respons

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

Kasus Penggunaan

Kasus 1: Teks-ke-Video

{
  "model": "doubao-seedance-2.0",
  "prompt": "A kitten yawning at the camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "seed": 42,
  "generate_audio": true
}

Kasus 2: Gambar-ke-Video (Frame Pertama)

{
  "model": "doubao-seedance-2.0",
  "prompt": "The kitten stands up and walks toward the camera",
  "image_urls": ["https://example.com/cat.jpg"],
  "duration": 5
}

Kasus 3: Video Frame Pertama/Terakhir

{
  "model": "doubao-seedance-2.0",
  "prompt": "Transition from day to night",
  "image_with_roles": [
    {"url": "https://example.com/day.jpg", "role": "first_frame"},
    {"url": "https://example.com/night.jpg", "role": "last_frame"}
  ],
  "duration": 5
}

Kasus 4: Video-Referensi-ke-Video

{
  "model": "doubao-seedance-2.0",
  "prompt": "Convert the video style to anime style",
  "video_urls": ["https://example.com/reference.mp4"]
}

Kasus 5: Video Referensi + Audio Referensi

{
  "model": "doubao-seedance-2.0",
  "prompt": "A scene of a person speaking",
  "video_urls": ["https://example.com/reference.mp4"],
  "audio_urls": ["https://example.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}

Kasus 6: Video dengan Audio

{
  "model": "doubao-seedance-2.0",
  "prompt": "A man stops a woman and says: \"Remember, you must never point your finger at the moon.\"",
  "generate_audio": true
}

Kasus 7: Pembuatan Video Berkelanjutan (Mengembalikan Frame Terakhir)

{
  "model": "doubao-seedance-2.0",
  "prompt": "The kitten continues walking toward the camera",
  "image_urls": ["https://example.com/last_frame_from_prev.png"],
  "return_last_frame": true
}

Kasus 8: Pembuatan Versi Cepat

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "City nightscape timelapse photography",
  "size": "21:9",
  "duration": 8
}

Kasus 9: Gambar Referensi + Video Referensi + Audio Referensi (Video Multimodal)

Gabungkan gambar referensi, video referensi, dan audio referensi untuk menghasilkan video iklan perspektif orang pertama yang imersif. Ideal untuk promosi produk, iklan brand, dan skenario lain yang memerlukan fusi materi dari beberapa sumber.
{
  "model": "doubao-seedance-2.0",
  "prompt": "Use video 1's first-person perspective throughout, and use audio 1 as the background music throughout. First-person POV fruit tea advertisement for seedance brand 'Peace Apple' apple fruit tea limited edition. First frame is image 1: your hand picks a dewy Aksu red apple with a crisp apple collision sound. 2-4s: quick cut, your hand drops apple chunks into a shaker cup, adds ice and tea base, shakes vigorously, ice collision and shaking sounds sync with upbeat drum beats, background voice: 'Fresh-cut, fresh-shaken'. 4-6s: first-person close-up of the finished product, layered fruit tea poured into a clear cup, your hand gently squeezes cream cap spreading on top, sticks a pink label on the cup, camera zooms in on the layered texture of cream cap and fruit tea. 6-8s: first-person handheld cup raise, you lift the fruit tea from image 2 toward the camera (simulating handing it to the viewer), cup label clearly visible, background voice 'Take a sip of freshness', final frame freezes on image 2. Background voice consistently uses a female tone.",
  "image_urls": [
    "https://example.com/tea_pic1.jpg",
    "https://example.com/tea_pic2.jpg"
  ],
  "video_urls": ["https://example.com/tea_video1.mp4"],
  "audio_urls": ["https://example.com/tea_audio1.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}

Kasus 10: Gambar-ke-Video dengan Asset URL

Aset avatar virtual yang disetujui dapat diteruskan langsung sebagai gambar referensi tanpa perlu diunggah ulang atau direview ulang.
{
  "model": "doubao-seedance-2.0",
  "prompt": "The character walks naturally on a city street under bright sunshine",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

Kasus 11: Tentukan Potret Referensi dengan Asset URL (image_with_roles)

{
  "model": "doubao-seedance-2.0",
  "prompt": "Using the reference portrait, the character walks elegantly toward the camera",
  "image_with_roles": [
    {
      "url": "asset://asset_a",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

Kasus 12: Versi Cepat + Gambar-ke-Video Asset URL

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "The character strolls in a park with a gentle breeze",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

Kasus 13: Gambar Asset URL + Video Referensi (Transfer Gerakan)

Gabungkan aset potret yang disetujui dengan video referensi untuk menggerakkan karakter melakukan gerakan tertentu.
{
  "model": "doubao-seedance-2.0",
  "prompt": "The character dances to the rhythm of the reference video with smooth and natural movements",
  "image_urls": ["https://example.com/dance_reference.jpg", "asset://asset_a"],
  "video_urls": ["https://example.com/dance_reference.mp4", "asset://asset_a"],
  "duration": 8,
  "resolution": "720p"
}
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.

Perbedaan dari Versi 1.5 Pro

Fitur1.5 Pro2.0 / 2.0 fast
Resolusi480p/720p/1080p480p/720p
Rentang durasi4-12s5-15s
Durasi default5s5s
Parameter rasio aspekaspect_ratiosize (opsi adaptive baru)
Pembuatan audioparameter audioparameter generate_audio
Video referensiTidak didukungDidukung melalui video_urls
Audio referensiTidak didukungDidukung melalui audio_urls
Gambar-ke-videoimage_urls / image_with_rolesimage_urls / image_with_roles
Video dengan audioTidak didukungDidukung melalui generate_audio
Video berkelanjutanTidak didukungDidukung melalui return_last_frame
Versi cepatTidak didukungDidukung melalui doubao-seedance-2.0-fast