Pembuatan Video doubao-seedance-1-5-pro

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

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

POST

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-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

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

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 request:

Authorization: Bearer YOUR_API_KEY

Parameter Request

model

string

wajib

Nama model pembuatan videoModel yang didukung:

doubao-seedance-1-5-pro - Versi 1.5 Pro, mendukung pembuatan audio dan frame pertama/frame terakhir

prompt

string

wajib

Deskripsi konten videoJelaskan adegan, aksi, dan gaya secara detail untuk hasil pembuatan yang lebih baikContoh: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"

duration

integer

default:"5"

Durasi video (detik)Rentang yang didukung: 4 ~ 12 detikDefault: 5

aspect_ratio

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

Default: 16:9

resolution

string

default:"720p"

Resolusi videoOpsi:

480p - Definisi standar
720p - Definisi tinggi
1080p - Full HD

Default: 720p

seed

integer

Bilangan bulat seed untuk mengontrol keacakan konten yang dibuatRentang nilai: bilangan bulat antara -1 dan 2^32-1

Dengan request yang sama, jika model menerima nilai seed berbeda (misalnya tidak menentukan seed atau menyetel seed ke -1, yang akan menggunakan angka acak), hasil yang berbeda akan dibuat
Dengan request yang sama, jika model menerima nilai seed yang sama, hasil yang mirip akan dibuat, tetapi tidak dijamin identik

audio

boolean

default:"false"

Apakah membuat audioSaat disetel ke true, video akan menyertakan audio pengiring yang dibuat AIDefault: false

Pembuatan audio eksklusif untuk 1.5 Pro; versi 1.0 tidak mendukung parameter ini

camerafixed

boolean

default:"false"

Apakah mengunci kameraSaat disetel ke true, posisi kamera tetap terkunciDefault: false

Kombinasi Resolusi dan Rasio Aspek

Resolusi	Rasio Aspek yang Didukung	Catatan
480p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Semua didukung
720p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Semua didukung
1080p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Semua didukung

image_urls

array<url>

Array URL gambar untuk pembuatan gambar-ke-videoAturan penetapan role otomatis:

1 gambar = frame pertama
2 gambar = frame pertama + frame terakhir

Contoh: ["https://example.com/first.png", "https://example.com/last.png"]

image_urls dan image_with_roles tidak dapat digunakan bersamaan

image_with_roles

array

Array gambar dengan role untuk kontrol yang lebih presisi

Tampilkan Deskripsi Field

url

string

wajib

Alamat URL gambar

role

string

wajib

Role gambarOpsi:

first_frame - Gambar frame pertama, sebagai frame awal video (hanya satu yang didukung)
last_frame - Gambar frame terakhir, sebagai frame akhir video (hanya satu yang didukung)

Contoh:

[
  {"url": "https://example.com/start.png", "role": "first_frame"},
  {"url": "https://example.com/end.png", "role": "last_frame"}
]

image_urls dan image_with_roles tidak dapat digunakan bersamaan
Frame pertama dan frame terakhir masing-masing hanya mendukung satu gambar

Respons

code

integer

Kode status respons, 200 jika berhasil

data

array

Array data respons

Tampilkan Elemen Array

status

string

Status tugas, submitted saat pertama kali dikirim

task_id

string

Pengidentifikasi tugas unik untuk mengueri status dan hasil tugas

Kasus Penggunaan

Kasus 1: Teks-ke-Video dengan Audio

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand",
  "audio": true
}

Kasus 2: Video Pendek Potret Berkualitas Tinggi

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "A girl spinning under cherry blossom trees, petals falling with the wind",
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "audio": true
}

Kasus 3: Frame Pertama ke Video Dinamis

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Animate the image with natural dynamic effects",
  "image_urls": ["https://example.com/first.png"],
  "duration": 5,
  "audio": true
}

Kasus 4: Efek Transisi dengan Frame Pertama/Terakhir

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Scene transitions from day to night, city lights gradually turning on",
  "image_with_roles": [
    {"url": "https://example.com/day.png", "role": "first_frame"},
    {"url": "https://example.com/night.png", "role": "last_frame"}
  ],
  "duration": 5
}

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.0

Fitur	1.0 fast/quality	1.5 Pro
Resolusi default	1080p	720p
Resolusi yang didukung	480p/720p/1080p	480p/720p/1080p
Rentang durasi	2-12s	4-12s
Pembuatan audio	Tidak didukung	Didukung
Gambar referensi	`reference` (1 gambar)	Tidak didukung

Pembuatan Video doubao-seedance-1-0-pro Pembuatan Video doubao-seedance-2.0

Documentation Index

​Otorisasi

​Parameter Request

​Kombinasi Resolusi dan Rasio Aspek

​Respons

​Kasus Penggunaan

​Kasus 1: Teks-ke-Video dengan Audio

​Kasus 2: Video Pendek Potret Berkualitas Tinggi

​Kasus 3: Frame Pertama ke Video Dinamis

​Kasus 4: Efek Transisi dengan Frame Pertama/Terakhir

​Perbedaan dari Versi 1.0

Otorisasi

Parameter Request

Kombinasi Resolusi dan Rasio Aspek

Respons

Kasus Penggunaan

Kasus 1: Teks-ke-Video dengan Audio

Kasus 2: Video Pendek Potret Berkualitas Tinggi

Kasus 3: Frame Pertama ke Video Dinamis

Kasus 4: Efek Transisi dengan Frame Pertama/Terakhir

Perbedaan dari Versi 1.0