Buat video

Ringkasan

Generasi video berjalan secara asinkron. Anda mengirim permintaan, menerima task_id dan poll_url, lalu memeriksa status secara berkala sampai hasil akhirnya siap.

Perilaku polling

Untuk perilaku pengecekan status yang paling andal, gunakan poll_url yang dikembalikan oleh respons pembuatan secara persis.

Jika respons create mengembalikan poll_url, panggil URL tersebut secara persis. Saat URL itu mengarah ke /v1/tasks/{id}, perlakukan itu sebagai endpoint status tetap yang kanonik.

Perilaku model dan media

Perilaku audio bergantung pada model dan operasi. Video dapat memiliki suara meskipun tidak menyediakan sakelar audio. Menghilangkan parameter berbeda dengan mengirim false.

veo3.1 dan veo3.1-fast selalu menghasilkan audio sesuai kontrak Gemini API. Pembuatan video wan-2.6 dan wan-2.7 juga tidak mendukung penonaktifan suara. Hilangkan output_audio atau gunakan true jika diizinkan detail model.
hailuo-h3 dan model video Grok menghasilkan audio native. Jangan menambahkan sakelar yang tidak tercantum pada detail model.
Seedance 1.5/2.x dan viduq3-pro / viduq3-turbo mengaktifkan audio secara default dan mendukung keluaran tanpa suara. PixVerse C1/V5.6/V6 menonaktifkannya secara default. Gunakan output_audio hanya untuk operasi yang mencantumkannya; Vidu juga menerima kolom boolean audio yang dinyatakan dalam kontraknya.
audio_url / audio_urls menyediakan audio masukan atau referensi, bukan sakelar keluaran. Pengeditan video, transfer gerakan, dan transfer gaya dapat mempertahankan trek asli. Mempertahankan audio asli tidak berarti membisukannya.

Lihat detail model untuk nilai yang diizinkan dan harga audio. Alias yang didukung outputAudio, generate_audio, dan boolean audio harus sama dengan output_audio jika digabungkan. Kontrol dapat berbeda antarversi dan operasi.

Untuk integrasi produksi, sebaiknya gunakan URL https publik untuk gambar, video, dan audio. Model yang kompatibel masih menerima URL data:, tetapi muatan base64 yang besar lebih sulit untuk dicoba ulang, diinspeksi, dan di-debug.

Isi permintaan

modelstringbawaan: veo3.1

ID model video. Gunakan ID model yang ditampilkan TokenLab seperti veo3.1, wan-2.7, happyhorse-1.0, viduq3, pixverse-v6, atau kling-3.0-video; pilih text-to-video, image-to-video, reference-to-video, atau varian lain dengan operation. Lihat panduan video dan Models API.

PixVerse

Model: pixverse-c1, pixverse-v6, pixverse-v5.6
Operasi: text-to-video, image-to-video, start-end-to-video, reference-to-video
Pemilih audio: output_audio, default false

Di TokenLab, model-model PixVerse di atas tidak mendukung operation=video-extension.

HappyHorse

Model: happyhorse-1.0
Operasi: text-to-video, image-to-video, reference-to-video, video-to-video
Pemilih audio: Jangan kirim output_audio

promptstring

Deskripsi teks video yang ingin Anda hasilkan. Field ini wajib untuk sebagian besar model video publik.

operationstring

Operasi video yang akan dijalankan. Kontrak publik mendukung text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension, audio-to-video, dan motion-control. TokenLab bisa menebak operasi berdasarkan input yang Anda kirim, tetapi untuk traffic produksi sebaiknya operation dikirim secara eksplisit.

image_urlstring

URL publik dari gambar awal untuk alur image-to-video. Untuk kompatibilitas lintas-model yang paling luas, sebaiknya gunakan image_url.

imagestring

Gambar inline dalam bentuk URL data: (misalnya data:image/jpeg;base64,...). Model yang kompatibel mendukung format ini, tetapi dalam praktik produksi image_url biasanya lebih stabil.

reference_imagesarray

Gambar referensi untuk alur dengan conditioning khusus. Jumlah yang didukung bergantung pada model. Untuk seedance-2.0 dan seedance-2.0-fast, TokenLab saat ini mendukung hingga 9 gambar referensi, ditambah hingga 3 video referensi dan 3 audio referensi. Untuk pilihan model, batas 4K, dan catatan Mini, lihat panduan model video Seedance 2.0. URL publik https lebih disarankan; model yang kompatibel juga menerima URL data:. Untuk grok-imagine-video, reference-to-video menerima hingga 7 referensi gambar dan duration dibatasi maksimal 10 detik. grok-imagine-video-1.5-preview hanya mendukung image-to-video dan tidak menerima referensi gambar.

material_asset_idstring

ID material Seedance TokenLab yang dikembalikan oleh Membuat Aset Material. Gunakan setelah material menjadi ACTIVE dengan model Seedance yang dapat menggunakan pustaka material TokenLab.

material_asset_idsarray

Beberapa ID material Seedance TokenLab. ID ini berbagi batas referensi gambar Seedance yang sama dengan reference_images; model yang dipilih harus dapat menggunakan pustaka material TokenLab.

URL gambar biasa digunakan sebagai input dan tidak otomatis membuat material yang dapat dipakai ulang. Buat material melalui API material, lalu gunakan ID TokenLab atau URI asset://asset-YYYYMMDDHHMMSS-xxxxx. Jika material eksplisit mengembalikan 409 seedance_material_preparing, periksa inactive_asset_ids dan coba lagi setelah material menjadi ACTIVE.

reference_image_typestring

Field opsional untuk model yang membedakan referensi asset dan style.

kling_elementsarray

Gunakan kling_elements hanya jika detail publik model saat ini mencantumkannya. Sertakan gambar dan 1–3 elemen dengan name, description opsional, serta 2–4 element_input_urls; rujuk melalui @name di prompt. Jangan gabungkan dengan output_audio=true.

video_urlstring

URL publik video sumber. Diperlukan untuk alur video-to-video berbasis URL video dan untuk motion-control; beberapa alur turunan menggunakan task_id sebagai gantinya.

video_urlsarray

Input video referensi tambahan untuk model yang mendukung conditioning referensi multimodal. Jumlah yang didukung bergantung pada model. Untuk seedance-2.0 dan seedance-2.0-fast, TokenLab saat ini mendukung hingga 3 video referensi.

audio_urlstring

URL audio publik untuk operasi berbasis audio atau referensi audio yang didukung model.

audio_urlsarray

Input audio referensi tambahan untuk model yang mendukung conditioning referensi multimodal. Jumlah yang didukung bergantung pada model. Untuk seedance-2.0 dan seedance-2.0-fast, TokenLab saat ini mendukung hingga 3 audio referensi.

task_idstring

ID tugas yang digunakan oleh beberapa alur lanjutan, ekstensi, atau turunan.

extend_atinteger

Offset awal khusus model yang dipakai oleh beberapa alur video-extension.

extend_timesstring

Pengali atau jumlah pengulangan khusus model yang dipakai oleh beberapa alur video-extension.

durationinteger

Durasi video output yang dihasilkan dalam detik. Untuk model Seedance 1.5/2.0, jika field ini dihilangkan nilainya adalah 5; mengirim -1 membuat model memilih dalam rentang yang didukung, dan penagihan diperkirakan secara konservatif sampai tugas selesai.

secondsinteger

Alias kompatibilitas untuk duration. Jika seconds dan duration dikirim bersama, nilainya harus sama. Untuk Seedance, seconds=-1 memiliki arti durasi otomatis yang sama dengan duration=-1.

aspect_ratiostring

Rasio aspek kanonis, misalnya adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, atau 21:9. Seedance menggunakan adaptive secara default jika dihilangkan.

resolutionstring

Resolusi output bergantung pada model. Seedance default ke 720p; seedance-2.0 mendukung 480p, 720p, 1080p, dan 4k, sedangkan seedance-2.0-fast dan seedance-2.0-mini dibatasi ke 480p dan 720p.

output_audioboolean

Selektor audio untuk operasi yang mendeklarasikannya. Jika dihilangkan, default model berlaku; false meminta keluaran tanpa suara hanya jika didukung. Lihat penjelasan di atas dan detail model.

draftboolean

Flag alur Draft Seedance 1.5 Pro. Gunakan draft=true dengan model Seedance yang mendukung tugas draft. Jangan kirim bersama draft_task_id.

draft_task_idstring

ID tugas draft Seedance 1.5 Pro untuk promosi. Kirim ID tugas draft sebelumnya untuk membuat video final; ini bukan field video generik.

ratiostring

Alias kompatibilitas untuk aspect_ratio. Jika ratio dan aspect_ratio dikirim bersama, nilainya harus identik.

generate_audioboolean

Alias kompatibilitas untuk output_audio. Jika generate_audio, output_audio, dan outputAudio muncul bersama, semua nilai harus sama.

execution_expires_afterinteger

Waktu kedaluwarsa eksekusi opsional dalam detik untuk model video yang kompatibel. Seedance default ke 172800 detik jika dihilangkan.

priorityinteger

Prioritas tugas opsional dari 0 sampai 9 untuk model video yang kompatibel. Jangan gabungkan priority dengan service_tier=flex.

safety_identifierstring

Pengenal keamanan end-user opsional untuk model video yang kompatibel. Jika dihilangkan untuk Seedance, TokenLab menggunakan user jika tersedia.

service_tierstring

default diterima sebagai no-op kompatibilitas untuk model Seedance 2.0. flex hanya boleh digunakan jika model yang dipilih mendukungnya.

framesinteger

Jumlah frame opsional untuk model video yang kompatibel. Model Seedance 2.0 dan Seedance 1.5 Pro tidak mendukung field ini.

camera_fixedboolean

Selector kamera tetap opsional untuk model video yang kompatibel. Model Seedance 2.0 tidak mendukung field ini.

fpsinteger

Frame per detik (1-120). Hanya berlaku pada model yang mengekspos kontrol FPS.

negative_promptstring

Elemen yang ingin dihindari dalam video yang dihasilkan.

seedinteger

Seed acak untuk generasi yang dapat direproduksi. Seedance menggunakan -1 sebagai seed acak jika dihilangkan.

cfg_scalenumber

Kekuatan kepatuhan terhadap prompt (0-20) pada model yang mengekspos kontrol ini.

motion_strengthnumber

Intensitas gerakan (0-1) pada model yang mengekspos kontrol ini.

start_imagestring

URL gambar frame pertama, atau input gambar yang kompatibel, untuk start-end-to-video.

end_imagestring

URL gambar frame terakhir, atau input gambar yang kompatibel, untuk start-end-to-video.

sizestring

Tingkat ukuran khusus model untuk model video yang kompatibel.

watermarkboolean

Toggle watermark opsional untuk model yang menyediakannya. Seedance default ke false jika dihilangkan.

effect_typestring

Pemilih efek khusus model untuk alur efek atau editing tertentu.

userstring

Pengenal unik untuk end-user. Untuk Seedance, TokenLab juga menggunakan nilai ini sebagai safety_identifier ketika field tersebut dihilangkan.

Catatan kompatibilitas

Field publik kanonis menggunakan snake_case: reference_images, reference_image_type, dan output_audio.
Field publik kanonis tetap menggunakan snake_case: aspect_ratio, output_audio, reference_images, dan reference_image_type.
Untuk kompatibilitas, TokenLab juga menerima ratio, generate_audio, outputAudio, seconds, referenceImages, dan referenceImageType.
Jika field kanonis dan alias dikirim bersama, nilainya harus sama; alias yang bertentangan ditolak sebelum tugas dibuat.

Praktik terbaik untuk input media

Untuk image_url, reference_images, video_url, dan audio_url, sebaiknya gunakan URL https publik.
Jika memungkinkan, hindari mencampur base64 inline dan URL jarak jauh dalam permintaan yang sama.
Pastikan URL media jarak jauh tetap berlaku cukup lama untuk menutupi coba ulang dan pembuatan tugas asinkron.

Parameter Seedance

Untuk model Seedance 1.5/2.0, endpoint terpadu mengikuti nama field TokenLab sambil menerima alias kompatibel seconds, ratio, dan generate_audio. Selector Seedance yang dihilangkan memakai default berikut: duration=5, resolution=720p, aspect_ratio=adaptive, output_audio=true, watermark=false, return_last_frame=false, execution_expires_after=172800, priority=0, dan seed=-1.

duration=-1 atau seconds=-1 membuat Seedance memilih durasi output dalam rentang yang didukung model. TokenLab memperkirakan biaya secara konservatif sebelum tugas selesai, lalu melakukan penyelesaian berdasarkan usage tugas selesai jika tersedia. service_tier=default diterima sebagai no-op kompatibilitas untuk Seedance 2.0; service_tier=flex, frames, dan camera_fixed ditolak jika model yang dipilih tidak mendukungnya.

Contoh Seedance

cURL

curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A sleek product reveal with cinematic camera movement",
    "operation": "text-to-video",
    "duration": -1,
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "output_audio": true
  }'

Respons

Field hasil, error, timestamp, dan model dikembalikan jika tersedia untuk task.

idstring

Identifier tugas asinkron kanonik. Saat id dan task_id sama-sama ada, perlakukan keduanya sebagai identitas tugas yang sama.

task_idstring

Pengidentifikasi tugas unik untuk pengecekan status.

poll_urlstring

URL pengecekan status yang direkomendasikan untuk tugas ini. Gunakan path ini secara persis saat memeriksa status.

billing_transaction_idstring

ID transaksi billing TokenLab saat settlement sudah selesai. Ini adalah identitas transaksi untuk dashboard/rekonsiliasi dan terpisah dari id / task_id async.

statusstring

Status tugas: pending, processing, completed, failed.

createdinteger

Unix timestamp saat tugas dibuat.

modelstring

Model yang digunakan.

videoobject

Objek video tunggal dengan url, duration, width, dan height saat tersedia.

videosarray

Array video saat tugas pembuatan mengembalikan lebih dari satu output.

errorstring | object

Pesan kesalahan (jika gagal).

Permintaan

cURL

curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "prompt": "A cat walking through a garden, cinematic lighting",
    "operation": "text-to-video",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

Respons

Response

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "veo3.1",
  "created": 1706000000
}

Image to video

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "hailuo-2.3-standard",
        "prompt": "The scene begins from the provided image and adds gentle natural motion.",
        "operation": "image-to-video",
        "image_url": "https://example.com/image.jpg",
        "duration": 6,
        "resolution": "768p"
    }
)

Elemen Kling 3.0

Reference to video

Gunakan operation=reference-to-video ketika model mendukung conditioning referensi khusus. Dalam detail model TokenLab, referensi gambar menggunakan reference_images, sedangkan video dan audio referensi multimodal menggunakan video_urls dan audio_urls. Untuk seedance-2.0 dan seedance-2.0-fast, TokenLab saat ini mendukung hingga 9 gambar referensi, ditambah hingga 3 video referensi dan 3 audio referensi. Untuk pilihan model, batas 4K, dan catatan Mini, lihat panduan model video Seedance 2.0. duration hanya mengatur panjang output yang dihasilkan; field ini tidak menetapkan batas terpisah untuk durasi input video referensi. Untuk grok-imagine-video, reference-to-video menerima hingga 7 referensi gambar (reference_images atau image_urls) dan duration dibatasi maksimal 10 detik. Jangan gabungkan referensi gambar dengan input frame awal image_url / image. grok-imagine-video-1.5-preview hanya mendukung image-to-video.

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "veo3.1",
        "prompt": "Keep the same subject identity, palette, and framing while adding subtle natural motion.",
        "operation": "reference-to-video",
        "reference_images": [
            "https://example.com/ref-a.jpg",
            "https://example.com/ref-b.jpg"
        ],
        "reference_image_type": "asset",
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "9:16"
    }
)

Kontrol frame awal dan akhir

Gunakan start_image dan end_image untuk mengontrol frame pertama dan frame terakhir.

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "viduq2-pro",
        "operation": "start-end-to-video",
        "start_image": "https://example.com/day.jpg",
        "end_image": "https://example.com/night.jpg",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9"
    }
)

Video to video

Untuk video-to-video dengan grok-imagine-video, kirim URL HTTPS publik .mp4 di video_url. Anda dapat mengatur resolution ke 480p atau 720p; duration dan aspect_ratio tidak diterima untuk alur edit ini.

Jika model menerima video yang sudah ada sebagai input utama, gunakan operation=video-to-video.

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "grok-imagine-video",
        "operation": "video-to-video",
        "video_url": "https://example.com/source.mp4",
        "prompt": "Enhance the clip while preserving the original motion."
    }
)

Motion control

Jika model membutuhkan gambar subjek sekaligus video referensi gerakan, gunakan operation=motion-control. TokenLab akan menormalkan bentuk publik image_url + video_url menjadi input kontrol gerakan yang kompatibel.

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "kling-3.0-motion-control",
        "operation": "motion-control",
        "prompt": "Keep the subject stable while following the motion reference.",
        "image_url": "https://example.com/subject.png",
        "video_url": "https://example.com/motion.mp4",
        "resolution": "720p"
    }
)

Penemuan model

Inventaris video publik dan operasi yang didukung berubah dari waktu ke waktu. Gunakan Models API sebagai sumber kebenaran sebelum mengintegrasikan alur khusus model:

curl "https://api.tokenlab.sh/v1/models?recommended_for=video"

curl "https://api.tokenlab.sh/v1/models/veo3.1"

Baca respons detail model sebelum bergantung pada operasi atau field khusus model. Operasi seperti audio-to-video dan video-extension bersifat khusus model; konfirmasi ketersediaan terbarunya di sana, bukan dari contoh statis di halaman ini.

Otorisasi

BearerAuth

AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

"auto"
"verified"
"official"

Body permintaan

application/json

prompt?string

Deskripsi video

model?string

Model yang akan digunakan (contoh: veo3.1, kling-v1)

operation?string

Operasi video yang diminta. Jika dihilangkan, TokenLab menyimpulkan operasi dari input yang diberikan. Operasi eksplisit direkomendasikan untuk keandalan produksi.

Nilai yang tersedia

"text-to-video"
"image-to-video"
"reference-to-video"
"start-end-to-video"
"video-to-video"
"video-extension"
"audio-to-video"
"motion-control"

image?string

Gambar inline sebagai data URL (contoh: data:image/png;base64,...). Gunakan image_url untuk kompatibilitas produksi yang lebih luas. Saat model Seedance yang dipilih dapat menggunakan pustaka material TokenLab, TokenLab menyiapkan input gambar ini sebagai material yang dapat digunakan kembali sebelum pembuatan; jika tidak ACTIVE dalam 60 detik, API mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids. Jika model yang dipilih tidak dapat menggunakan pustaka material, input gambar biasa akan berlanjut pada jalur gambar reguler.

image_url?string

URL gambar yang dapat diakses publik untuk pembuatan image-to-video, atau asset://asset-YYYYMMDDHHMMSS-xxxxx untuk material TokenLab Seedance yang ACTIVE yang digunakan sebagai frame pertama. Lebih disukai daripada base64 inline dalam produksi. TokenLab memverifikasi kepemilikan material. Saat model Seedance yang dipilih dapat menggunakan pustaka material TokenLab, TokenLab menyiapkan input gambar biasa sebagai material yang dapat digunakan kembali sebelum pembuatan; jika tidak ACTIVE dalam 60 detik, API mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids. Jika model yang dipilih tidak dapat menggunakan pustaka material, input gambar biasa akan berlanjut pada jalur gambar reguler.

Formaturi

video_url?string

URL video yang dapat diakses publik untuk alur gaya video-to-video dan model kontrol gerak.

Formaturi

duration?integer

Durasi video dalam detik. Model Seedance juga menerima -1 agar model memilih dalam rentang durasi yang didukungnya; TokenLab memperkirakan penagihan secara konservatif untuk mode tersebut.

Rentang-1 <= value <= 60

aspect_ratio?string

Rasio aspek video kanonik. Seedance menggunakan default adaptive jika dihilangkan. Alias rasio diterima untuk kompatibilitas.

Nilai yang tersedia

"adaptive"
"16:9"
"9:16"
"1:1"
"4:3"
"3:4"
"21:9"

resolution?string

Resolusi video. Seedance menggunakan default 720p jika dihilangkan; nilai yang tersedia bergantung pada model.

Nilai yang tersedia

"480p"
"720p"
"1080p"
"4k"

output_format?string

Format kontainer video untuk model yang kompatibel. Seedance 2.5 mendukung mp4 dan mov; hilangkan field ini untuk Seedance 2.0 dan model lain yang tidak mempublikasikan pemilih format output.

Nilai yang tersedia

"mp4"
"mov"

output_audio?boolean

Selektor audio untuk operasi yang mendeklarasikannya. Jika dihilangkan, default model berlaku; false meminta keluaran tanpa suara hanya jika didukung. Lihat penjelasan di atas dan detail model.

fps?integer

Frame per detik

Rentang1 <= value <= 120

negative_prompt?string

Apa yang harus dihindari dalam video

seed?integer

Seed untuk reproduktibilitas pada model yang kompatibel. Model Seedance yang kompatibel menggunakan -1 untuk seed acak jika dihilangkan; Seedance 2.5 tidak mendukung field ini.

Rentang-1 <= value <= 4294967295

cfg_scale?number

Kekuatan kepatuhan prompt (0-20) untuk model yang mengekspos kontrol gaya CFG.

Rentang0 <= value <= 20

motion_strength?number

Intensitas gerak (0-1) untuk model yang mengeksposnya.

Rentang0 <= value <= 1

start_image?string

Input gambar frame pertama untuk alur start-end-to-video. Seedance menerima referensi gambar publik atau asset://asset-YYYYMMDDHHMMSS-xxxxx untuk material TokenLab yang ACTIVE yang dimiliki oleh organisasi peminta. Saat model Seedance yang dipilih dapat menggunakan pustaka material TokenLab, TokenLab menyiapkan input gambar biasa sebagai material yang dapat digunakan kembali sebelum pembuatan; jika tidak ACTIVE dalam 60 detik, API mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids. Jika model yang dipilih tidak dapat menggunakan pustaka material, input gambar biasa akan berlanjut pada jalur gambar reguler.

end_image?string

Input gambar bingkai terakhir untuk alur start-end-to-video. Seedance menerima referensi gambar publik atau asset://asset-YYYYMMDDHHMMSS-xxxxx untuk material TokenLab yang AKTIF dan dimiliki oleh organisasi pemohon. Saat model Seedance yang dipilih dapat menggunakan pustaka material TokenLab, TokenLab menyiapkan input gambar biasa sebagai material yang dapat digunakan kembali sebelum pembuatan; jika tidak AKTIF dalam 60 detik, API akan mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids. Jika model yang dipilih tidak dapat menggunakan pustaka material, input gambar biasa akan berlanjut pada jalur gambar reguler.

user?string

Pengenal pengguna akhir

image_urls?array<>

Array URL gambar untuk alur video dengan kondisi gambar yang kompatibel. Seedance 2.5 menerima hingga 30 input gambar agregat; model video lainnya tetap menggunakan batas bersama sebanyak 9 entri kecuali detail model menentukan batas yang lebih rendah. Saat model Seedance yang dipilih dapat menggunakan pustaka material TokenLab, TokenLab menyiapkan input gambar ini sebagai material yang dapat digunakan kembali sebelum pembuatan; jika tidak AKTIF dalam 60 detik, API akan mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids. Jika model yang dipilih tidak dapat menggunakan pustaka material, input gambar biasa akan berlanjut pada jalur gambar reguler.

Item1 <= items <= 30

kling_elements?array<>

Referensi elemen Kling 3.0 untuk permintaan kling-3.0-video dengan kondisi gambar. Tentukan 1-3 elemen dan referensikan dalam prompt dengan @name. Setiap elemen memerlukan 2-4 URL gambar di element_input_urls. Jangan gabungkan kling_elements dengan output_audio=true; hilangkan output_audio atau atur ke false untuk permintaan referensi elemen.

Item1 <= items <= 3

reference_images?array<string>

Bidang gambar referensi publik kanonis untuk pengondisian reference-to-video. Seedance 2.5 menerima hingga 30 input gambar agregat; model video lainnya tetap menggunakan batas bersama sebanyak 9 URL atau URL data yang kompatibel kecuali detail model menentukan batas yang lebih rendah. xAI grok-imagine-video menerima hingga 7 referensi gambar dengan durasi dibatasi hingga 10 detik; grok-imagine-video-1.5 dan grok-imagine-video-1.5-preview hanya untuk image-to-video dan tidak menerima gambar referensi. Saat model Seedance yang dipilih dapat menggunakan pustaka material TokenLab, TokenLab menyiapkan input gambar biasa sebagai material yang dapat digunakan kembali sebelum pembuatan; jika tidak AKTIF dalam 60 detik, API akan mengembalikan 409 seedance_material_preparing dengan auto_material_asset_ids. Jika model yang dipilih tidak dapat menggunakan pustaka material, input gambar biasa akan berlanjut pada jalur gambar reguler.

Item1 <= items <= 30

material_asset_id?string

ID aset material TokenLab Seedance yang dikembalikan oleh /v1/videos/assets, melalui penyiapan gambar otomatis, atau dari grup orang asli yang dikembalikan oleh GetVisualValidateResult. Gunakan setelah aset AKTIF dengan model Seedance yang dapat menggunakan pustaka material TokenLab. Aset harus milik akun saat ini. Bidang ini adalah input referensi generik; untuk menetapkan semantik first-frame, last-frame, atau reference-image secara eksplisit, masukkan asset://<material_asset_id> di start_image, end_image, atau reference_images.

material_asset_ids?array<string>

ID aset material TokenLab Seedance yang dikembalikan oleh /v1/videos/assets atau melalui penyiapan gambar otomatis. ID ini berbagi batas referensi gambar Seedance; model yang dipilih harus dapat menggunakan pustaka material TokenLab dan semua aset harus milik akun saat ini serta AKTIF.

Item1 <= items <= 9

reference_image_type?string

Peran gambar referensi opsional untuk model yang membedakan antara referensi aset dan gaya. Alias camelCase referenceImageType diterima untuk kompatibilitas.

Nilai yang tersedia

"asset"
"style"

audio_url?string

URL audio publik untuk operasi berbasis audio atau referensi audio yang didukung model.

Formaturi

task_id?string

Pengidentifikasi tugas yang digunakan oleh beberapa alur kelanjutan, ekstensi, atau turunan.

extend_at?integer

Offset awal ekstensi khusus model yang digunakan oleh beberapa alur ekstensi video.

Rentang0 <= value

extend_times?string

Pengali ekstensi atau jumlah pengulangan khusus model yang digunakan oleh beberapa alur ekstensi video.

seconds?integer

Alias dari duration yang digunakan oleh bentuk permintaan yang kompatibel. Model Seedance juga menerima -1 agar model dapat memilih dalam rentang durasi yang didukung; duration dan seconds harus cocok jika keduanya disediakan.

Rentang-1 <= value <= 60

size?string

Tingkat ukuran khusus model untuk model video yang kompatibel.

watermark?boolean

Tombol alih watermark opsional untuk model yang mengeksposnya. Seedance secara default bernilai false jika dihilangkan.

effect_type?string

Pemilih efek khusus model untuk alur pengeditan khusus.

video_urls?array<>

Array kompatibilitas untuk alur yang dikondisikan video jika beberapa video input didukung oleh model yang dipilih. Seedance 2.5 menerima hingga 10 input video agregat; model video lainnya mempertahankan batas bersama sebanyak 3 referensi kecuali detail model menentukan batas yang lebih rendah.

Item1 <= items <= 10

audio_urls?array<>

Array kompatibilitas untuk alur yang dikondisikan audio jika beberapa referensi audio didukung oleh model yang dipilih. Seedance 2.5 menerima hingga 10 input audio agregat dan mengizinkan permintaan referensi audio murni tanpa prompt; model video lainnya mempertahankan batas bersama sebanyak 3 referensi kecuali detail model menentukan batas yang lebih rendah.

Item1 <= items <= 10

ratio?string

Alias kompatibilitas untuk aspect_ratio. Jika ratio dan aspect_ratio keduanya disediakan, keduanya harus cocok.

Nilai yang tersedia

"adaptive"
"16:9"
"9:16"
"1:1"
"4:3"
"3:4"
"21:9"

outputAudio?boolean

Alias kompatibilitas untuk output_audio. Jika keduanya disediakan, keduanya harus cocok.

generate_audio?boolean

Alias kompatibilitas untuk output_audio. Jika lebih dari satu tombol alih audio disediakan, semua nilai harus cocok.

execution_expires_after?integer

Jendela kedaluwarsa eksekusi opsional dalam detik untuk model video yang kompatibel. Seedance secara default bernilai 172800 detik jika dihilangkan.

Rentang3600 <= value <= 259200

bawaan172800

priority?integer

Prioritas tugas opsional untuk model video yang kompatibel. Jangan gabungkan priority dengan service_tier=flex.

Rentang0 <= value <= 9

bawaan0

safety_identifier?string

Pengidentifikasi pelacakan keamanan/pengguna opsional untuk model video yang kompatibel. Jika dihilangkan untuk Seedance, TokenLab menggunakan user jika disediakan.

Panjanglength <= 128

service_tier?string

Tingkat layanan opsional untuk model video yang kompatibel. service_tier=default diterima sebagai no-op kompatibilitas untuk Seedance 2.0 dan Seedance 2.5; service_tier=flex ditolak untuk kedua model tersebut.

Nilai yang tersedia

"default"
"flex"

frames?integer

Jumlah bingkai opsional untuk model video yang kompatibel. Seedance 1.5 Pro, Seedance 2.0, dan Seedance 2.5 tidak mendukung bidang ini.

Rentang1 <= value

camera_fixed?boolean

Pemilih kamera tetap opsional untuk model video yang kompatibel. Seedance 2.0 dan Seedance 2.5 tidak mendukung bidang ini.

return_last_frame?boolean

Mengembalikan bingkai yang terakhir dibuat saat model yang dipilih mendukungnya. Seedance secara default bernilai false jika dihilangkan.

bawaanfalse

draft?boolean

Flag alur kerja draft Seedance 1.5 Pro. Hanya didukung oleh model Seedance yang mendukung draft; draft=true membuat tugas draft berbiaya rendah.

bawaanfalse

draft_task_id?string

ID tugas promosi draf Seedance 1.5 Pro. Berikan ini alih-alih draft=true untuk membuat video final dari tugas draf sebelumnya.

audio?boolean

Selektor audio untuk operasi yang mendeklarasikannya. Jika dihilangkan, default model berlaku; false meminta keluaran tanpa suara hanya jika didukung. Lihat penjelasan di atas dan detail model.

bgm?boolean

Kontrol audio opsional. Hanya diterima jika dinyatakan oleh model dan operasi yang dipilih; ketersediaannya dapat berbeda menurut operasi.

audio_type?string

Kontrol audio opsional. Hanya diterima jika dinyatakan oleh model dan operasi yang dipilih; ketersediaannya dapat berbeda menurut operasi.

voice_id?string

Kontrol audio opsional. Hanya diterima jika dinyatakan oleh model dan operasi yang dipilih; ketersediaannya dapat berbeda menurut operasi.

Buat video

Ringkasan

Perilaku polling

Perilaku model dan media

Isi permintaan

Catatan kompatibilitas

Praktik terbaik untuk input media

Parameter Seedance

Contoh Seedance

Respons

Image to video

Elemen Kling 3.0

Reference to video

Kontrol frame awal dan akhir

Video to video

Motion control

Penemuan model

Otorisasi

Header

Body permintaan

Respons

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Buat video

RingkasanCopy Anchor Link

Perilaku pollingCopy Anchor Link

Perilaku model dan mediaCopy Anchor Link

Isi permintaanCopy Anchor Link

Catatan kompatibilitasCopy Anchor Link

Praktik terbaik untuk input mediaCopy Anchor Link

Parameter SeedanceCopy Anchor Link

Contoh SeedanceCopy Anchor Link

ResponsCopy Anchor Link

Image to videoCopy Anchor Link

Elemen Kling 3.0Copy Anchor Link

Reference to videoCopy Anchor Link

Kontrol frame awal dan akhirCopy Anchor Link

Video to videoCopy Anchor Link

Motion controlCopy Anchor Link

Penemuan modelCopy Anchor Link

OtorisasiCopy Anchor Link

HeaderCopy Anchor Link

Body permintaanCopy Anchor Link

ResponsCopy Anchor Link

200application/json

400application/json

401application/json

402application/json

409application/json

429application/json

500application/json

503application/json

Ringkasan

Perilaku polling

Perilaku model dan media

Isi permintaan

Catatan kompatibilitas

Praktik terbaik untuk input media

Parameter Seedance

Contoh Seedance

Respons

Image to video

Elemen Kling 3.0

Reference to video

Kontrol frame awal dan akhir

Video to video

Motion control

Penemuan model

Otorisasi

Header

Body permintaan

Respons

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`