curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
seedance-2-5-flash
Pembuatan Video Seedance 2.5 Flash
Buat video 480p / 720p hingga 30 detik melalui teks, referensi multimodal, pengeditan, perpanjangan, atau frame awal dan akhir.
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": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
POST /v1/videos/generations, baca data[0].task_id, lalu periksa GET /v1/tasks/{task_id}.
Parameter permintaan
Gunakan
seedance-2-5-flash. Alias doubao-seedance-2-5-flash juga diterima. Nama bertitik seedance-2.5-flash tidak didukung.Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
true: periksa prompt dan gambar input denganomni-moderation-latestfalseatau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
nsfw_content_detected) tanpa membuat tugas atau biaya generasi. Video dan audio referensi tidak diperiksa. Permintaan dapat berlanjut jika layanan moderasi gagal.Prompt wajib. Rujuk media menggunakan
@图片1 / @视频1 / @音频1; indeks mulai dari 1 sesuai urutan masing-masing array media.Hanya
480p / 720p, default 720p. 1080p, 2k, 4k, atau nilai lain menghasilkan HTTP 400 saat pengiriman.Mendukung
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (default). Alias: aspect_ratio. Tugas frame awal/akhir, edit, dan extend wajib memakai adaptive.Detik bulat
4–30; permintaan biasa memakai 5 jika dihilangkan. -1 berarti otomatis. edit eksplisit hanya menerima -1 atau dihilangkan, yang diperlakukan sebagai -1; durasi mengikuti video sumber. Durasi otomatis mencadangkan 30 detik lalu dihitung berdasarkan token aktual.Buat suara, default
true. Alias: audio. Mengatur suara keluaran, terpisah dari input referensi audio_urls.auto (default), reference, edit, atau extend, hanya untuk tugas dengan media referensi. Jenis eksplisit memicu validasi saat pengiriman sesuai tabel di bawah.Array gambar referensi, semuanya sebagai
reference_image. Maksimal 10 gambar digabung dengan image_with_roles. Gunakan image_with_roles untuk frame awal/akhir.Setiap item memuat
url dan role. Peran: reference_image, first_frame (maksimal 1), last_frame (maksimal 1, bersama frame awal). Total maksimal 10 bersama image_urls; hindari peran yang bertentangan. Jika ada video_urls / audio_urls, frame awal/akhir menjadi gambar referensi multimodal.Maksimal 5 video, masing-masing 2–30 detik, total maksimal 30 detik. Video sumber untuk edit harus berdurasi 4–30 detik.
Maksimal 5 audio, masing-masing 2–30 detik, total maksimal 30 detik. Referensi hanya audio didukung, tanpa harus menyertakan gambar atau video.
Jika
true, gambar frame terakhir dikembalikan setelah berhasil di data.result.videos[].last_frame_url.draft / draft_task_id tidak didukung; hapus dari permintaan agar tidak mendapat HTTP 400. Gunakan Seedance 2.5 untuk mode draf.Persyaratan media
Gunakan URLhttp(s) yang dapat diakses publik atau ID asset:// yang sudah disetujui. Resolusi keluaran dan batas piksel video input diperiksa secara terpisah.
| Media | Batas |
|---|---|
| Gambar | Total ≤10 pada kedua field gambar; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; lebar dan tinggi masing-masing 300–6000 px; rasio 0.4–2.5; masing-masing <30 MB. |
| Video | ≤5; MP4 / MOV, video H.264 / H.265 dan audio AAC / MP3; masing-masing 2–30 detik, total ≤30 detik; masing-masing ≤200 MB; lebar dan tinggi 300–6000 px, rasio 0.4–2.5, lebar × tinggi 409,600–8,295,044 piksel, 24–60 FPS. |
| Audio | ≤5; WAV / MP3; masing-masing 2–30 detik, total ≤30 detik; masing-masing ≤15 MB. |
Jenis tugas dan batasan
| Mode | Penggunaan dan batasan |
|---|---|
| Teks ke video | Isi prompt tanpa media referensi; hilangkan omni_reference_task_type. |
| Referensi ke video | Sertakan media referensi; reference opsional. Batas durasi dan rasio normal tetap berlaku. |
| Frame awal/akhir | Gunakan image_with_roles; size / aspect_ratio harus adaptive. |
| Edit video | edit; minimal 1 video sumber berdurasi 4–30 detik; rasio adaptive, duration hanya -1 atau dihilangkan. |
| Perpanjang video | extend; minimal 1 video referensi; rasio adaptive. |
auto, model menentukan jenis dari media dan prompt sehingga dapat gagal saat generasi. Jenis eksplisit pun dapat mengalami InvalidParameter.TaskTypeMismatch jika bertentangan dengan prompt.
Contoh permintaan
Referensi multimodal
{
"model": "seedance-2-5-flash",
"prompt": "Use the composition of @视频1, the subject in @图片1, and @音频1 as background music",
"image_urls": [
"https://example.com/reference.jpg"
],
"video_urls": [
"https://example.com/reference_8s.mp4"
],
"audio_urls": [
"https://example.com/music_5s.mp3"
],
"omni_reference_task_type": "reference",
"duration": 8,
"size": "16:9"
}
Frame awal dan akhir
{
"model": "seedance-2-5-flash",
"prompt": "Smoothly transition from the first frame to the last frame",
"image_with_roles": [
{
"url": "https://example.com/first.jpg",
"role": "first_frame"
},
{
"url": "https://example.com/last.jpg",
"role": "last_frame"
}
],
"size": "adaptive",
"duration": 5
}
Edit video
{
"model": "seedance-2-5-flash",
"prompt": "Edit @视频1: replace the cloudy sky with a clear sunset while preserving the camera movement",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "edit",
"size": "adaptive",
"duration": -1,
"output_format": "mov"
}
Perpanjang video
{
"model": "seedance-2-5-flash",
"prompt": "Extend @视频1 forward: continue the camera movement as the subject walks into the forest",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "extend",
"size": "adaptive",
"duration": 5
}
Aset privat
Gambar atau video yang berisi wajah orang nyata harus disetujui di pustaka aset sebelum memakaiasset://. Saat mengunggah, isi juga model dengan seedance-2-5-flash. Lihat API pustaka aset dan gunakan nama Flash pada contoh berikut.
curl --request POST \
--url https://api.apimart.ai/v1/seedance2/private-avatar/assets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"group": {
"name": "flash-assets"
},
"asset_type": "Image",
"assets": [
{
"url": "https://example.com/reference.jpg",
"name": "reference"
}
]
}'
asset:// dari daftar aset lalu pakai pada image_urls, image_with_roles[].url, video_urls, atau audio_urls.
Status dan hasil tugas
Lakukan polling API status tugas.pending / processing berarti berjalan, completed berhasil, failed gagal. Baca data.result.videos[0].url[0]; url berupa array.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
--header 'Authorization: Bearer <token>'
{
"code": 200,
"data": {
"id": "task_example_seedance25flash",
"status": "completed",
"progress": 100,
"cost": 0.3104,
"credits_cost": 3.104,
"usage": {
"completion_tokens": 38800
},
"result": {
"videos": [
{
"url": [
"https://example.com/generated-video.mp4"
],
"last_frame_url": "https://example.com/generated-last-frame.png"
}
]
}
}
}
| Field | Arti |
|---|---|
data.usage.completion_tokens | Token untuk perhitungan akhir. Mungkin belum muncul beberapa detik setelah selesai; periksa lagi. |
data.cost | Biaya aktual dalam USD setelah diskon akun. Gunakan nilai yang dikembalikan. |
data.credits_cost | Kredit yang benar-benar dipotong. |
data.result.videos[].url | Array URL video; segera unduh dan simpan. |
data.result.videos[].last_frame_url | URL frame terakhir, hanya setelah berhasil dengan permintaan return_last_frame: true. |
data.error.message | Alasan gagal. Tugas gagal memiliki data.cost: 0 dan dana cadangan dikembalikan. |
Penagihan
- Saat dikirim, dana dicadangkan berdasarkan tarif per detik sesuai resolusi. Referensi video memakai tingkat dengan input: durasi keluaran ditambah total durasi video referensi.
- Permintaan biasa tanpa
durationmencadangkan 5 detik keluaran.duration: -1, atauedittanpa durasi, mencadangkan 30 detik keluaran. - Setelah berhasil:
data.usage.completion_tokens÷ 1,000,000 × tarif per juta token yang sesuai, dengan diskon akun. Selisih dikembalikan atau ditagihkan. Ada tidaknya referensi video menentukantokenatautoken-input; biaya akhir ada padadata.cost. - Pengiriman yang ditolak tidak dikenai biaya generasi. Jika generasi gagal, dana cadangan dikembalikan. Tarif dan diskon tersedia di halaman harga.
Kesalahan umum
| Situasi | Tindakan |
|---|---|
| HTTP 400: resolusi tidak didukung | Gunakan 480p / 720p, bukan 1080p. |
| HTTP 400: terlalu banyak referensi | Maksimal 10 gambar total, 5 video, 5 audio; periksa juga durasinya. |
| HTTP 400: draf tidak didukung | Hapus draft / draft_task_id. |
| HTTP 400: jenis, durasi, atau rasio | Periksa kombinasi omni_reference_task_type, duration, size / aspect_ratio. |
HTTP 400: nsfw_content_detected | Perlakukan sebagai penolakan moderasi, baca error.message, lalu ubah konten. |
| Model tidak ditemukan | Gunakan seedance-2-5-flash, bukan seedance-2.5-flash. |
Tugas failed | Baca data.error.message dan sesuaikan media serta prompt dengan jenis tugas. Dana cadangan dikembalikan. |