Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
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

Output audio bergantung pada model. Di TokenLab, keluarga Veo 3 akan menyalakan audio secara default ketika output_audio dihilangkan. Jika model mendukung kontrol audio, gunakan output_audio untuk menyalakan atau mematikannya secara eksplisit. Alias camelCase outputAudio juga diterima untuk kompatibilitas. 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.

​
Request body

​
model
string
default:"sora-2"
ID model video. Default API adalah sora-2. Lihat panduan generasi video untuk matriks model publik saat ini dan kemampuan yang didukung.
​
prompt
string
wajib
Deskripsi teks video yang ingin Anda hasilkan. Field ini wajib untuk sebagian besar model video publik.
​
operation
string
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_url
string
URL publik dari gambar awal untuk alur image-to-video. Untuk kompatibilitas lintas-model yang paling luas, sebaiknya gunakan image_url.
​
image
string
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_images
array
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. URL publik https lebih disarankan; model yang kompatibel juga menerima URL data:.
​
reference_image_type
string
Field opsional untuk model yang membedakan referensi asset dan style.
​
kling_elements
array
Definisi referensi elemen Kling 3.0. Hanya didukung oleh kling-3.0-video untuk request yang dikondisikan gambar. Definisikan 1-3 elemen; setiap elemen memiliki name, description opsional, dan element_input_urls berisi 2-4 URL gambar. Referensikan elemen di prompt dengan @name. Jangan gabungkan kling_elements dengan output_audio=true; hilangkan output_audio atau set ke false saat memakai referensi elemen.
​
video_url
string
URL publik dari video sumber. Field ini diperlukan untuk alur publik video-to-video saat ini dan untuk model motion-control.
​
video_urls
array
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_url
string
URL audio publik untuk model yang mendukung audio-to-video.
​
audio_urls
array
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_id
string
ID tugas dari penyedia untuk beberapa alur lanjutan, ekstensi, atau turunan tertentu.
​
extend_at
integer
Offset awal khusus model yang dipakai oleh beberapa alur video-extension.
​
extend_times
string
Pengali atau jumlah pengulangan khusus model yang dipakai oleh beberapa alur video-extension.
​
duration
integer
Durasi video output yang dihasilkan dalam detik. Nilai yang tersedia bergantung pada model. Field ini hanya mengatur panjang output, bukan durasi input video referensi.
​
aspect_ratio
string
Rasio aspek, misalnya 16:9, 9:16, atau 1:1.
​
resolution
string
Resolusi output, misalnya 720p, 1080p, atau 4k. Ketersediaannya bergantung pada model.
​
output_audio
boolean
Toggle output audio bergantung pada model. Di TokenLab, request keluarga Veo 3 default ke true saat field ini dihilangkan. kling-3.0-video menerima selector ini untuk request tanpa referensi elemen dan memetakannya ke kontrol sound upstream yang kompatibel; request Kling yang menghilangkan field ini defaultnya silent. Jangan gabungkan output_audio=true dengan kling_elements. Model video publik lain mengikuti perilaku default yang sudah digovern. Alias camelCase outputAudio diterima untuk kompatibilitas.
​
fps
integer
Frame per detik (1-120). Hanya berlaku pada model yang mengekspos kontrol FPS.
​
negative_prompt
string
Elemen yang ingin dihindari dalam video yang dihasilkan.
​
seed
integer
Seed acak untuk hasil yang dapat direproduksi.
​
cfg_scale
number
Kekuatan kepatuhan terhadap prompt (0-20) pada model yang mengekspos kontrol ini.
​
motion_strength
number
Intensitas gerakan (0-1) pada model yang mengekspos kontrol ini.
​
start_image
string
URL gambar frame pertama, atau input gambar yang kompatibel, untuk start-end-to-video.
​
end_image
string
URL gambar frame terakhir, atau input gambar yang kompatibel, untuk start-end-to-video.
​
size
string
Tingkat ukuran khusus model untuk beberapa model video yang kompatibel dengan OpenAI.
​
watermark
boolean
Sakelar watermark untuk model yang mengeksposnya secara publik.
​
effect_type
string
Pemilih efek khusus model untuk alur efek atau editing tertentu.
​
user
string
Pengidentifikasi unik untuk end-user.

​
Catatan kompatibilitas

  • Field publik kanonis menggunakan snake_case: reference_images, reference_image_type, dan output_audio.
  • Untuk kompatibilitas, TokenLab juga menerima alias camelCase referenceImages, referenceImageType, dan outputAudio.
  • Jika operation tidak dikirim, TokenLab akan menebaknya dari input yang tersedia. Meski begitu, untuk produksi tetap disarankan untuk mengirimkannya secara eksplisit.

​
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.
  • Jika Anda menggunakan signed URL, pastikan masa berlakunya cukup panjang untuk menutupi coba ulang dan pembuatan tugas asinkron.

​
Respons

​
id
string
Identifier tugas asinkron kanonik. Saat id dan task_id sama-sama ada, perlakukan keduanya sebagai identitas tugas yang sama.
​
task_id
string
Pengidentifikasi tugas unik untuk pengecekan status.
​
poll_url
string
URL pengecekan status yang direkomendasikan untuk tugas ini. Gunakan path ini secara persis saat memeriksa status.
​
billing_transaction_id
string
ID transaksi billing TokenLab saat settlement sudah selesai. Ini adalah identitas transaksi untuk dashboard/rekonsiliasi dan terpisah dari id / task_id async.
​
status
string
Status awal: pending.
​
created
integer
Unix timestamp saat tugas dibuat.
​
model
string
Model yang digunakan.
curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A cat walking through a garden, cinematic lighting",
    "operation": "text-to-video",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "sora-2",
  "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,
        "aspect_ratio": "16:9"
    }
)

​
Kling 3.0 Elements

Gunakan kling_elements dengan kling-3.0-video saat memerlukan referensi elemen. Sertakan request yang dikondisikan gambar (image_url, image_urls, start_image, atau end_image) dan referensikan setiap elemen di prompt dengan @name. Jangan gabungkan kling_elements dengan output_audio=true; hilangkan output_audio atau set ke false saat memakai referensi elemen. 
response = requests.post("https://api.tokenlab.sh/v1/videos/generations",
    headers=headers,
    json={
        "model": "kling-3.0-video",
        "prompt": "Place @hero_bag on a studio turntable with soft product lighting.",
        "operation": "image-to-video",
        "image_url": "https://example.com/studio-start.png",
        "duration": 5,
        "resolution": "720p",
        "kling_elements": [
            {
                "name": "hero_bag",
                "description": "black leather handbag",
                "element_input_urls": [
                    "https://example.com/bag-front.png",
                    "https://example.com/bag-side.png"
                ]
            }
        ]
    }
)

​
Reference to video

Gunakan operation=reference-to-video ketika model mendukung conditioning referensi khusus. Dalam kontrak publik 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. duration hanya mengatur panjang output yang dihasilkan; field ini tidak menetapkan batas terpisah untuk durasi input video referensi. 
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",
        "prompt": "Smooth transition from day to night",
        "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

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": "topaz-video-upscale",
        "operation": "video-to-video",
        "video_url": "https://example.com/source.mp4",
        "prompt": "Upscale the clip while preserving the original motion.",
        "resolution": "1080p"
    }
)

​
Motion control

Jika model membutuhkan gambar subjek sekaligus video referensi gerakan, gunakan operation=motion-control. TokenLab akan menormalkan bentuk publik image_url + video_url ke kontrak upstream yang sesuai. 
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"
    }
)

​
Ketersediaan audio-to-video dan video-extension saat ini

Kontrak publik TokenLab menerima audio-to-video dan video-extension untuk alur khusus model tertentu. Namun, dalam inventaris model publik yang umumnya diaktifkan pada build dokumentasi ini, belum ada model yang secara luas diaktifkan dan secara publik mengiklankan dua kemampuan tersebut. Sebelum mengintegrasikan alur ini, cek ketersediaan terbaru melalui Models API atau halaman model.

​
Inventaris model video publik yang sedang aktif

Daftar ini diselaraskan dengan inventaris model video publik yang aktif pada build dokumentasi ini. Untuk kondisi terbaru, gunakan Models API.

​
OpenAI

ModelOperasi publik
sora-2Teks ke video, image-to-video
sora-2-proTeks ke video, image-to-video
sora-2-pro-storyboardGambar-ke-video

​
Kuaishou

ModelOperasi publik
kling-3.0-motion-controlKontrol gerakan
kling-3.0-videoTeks ke video, image-to-video, start-end-to-video, referensi elemen
kling-v2.5-turbo-proTeks ke video, image-to-video, start-end-to-video
kling-v2.5-turbo-stdTeks ke video, image-to-video
kling-v2.6-proTeks ke video, image-to-video, start-end-to-video
kling-v2.6-stdTeks ke video, image-to-video
kling-v3.0-proTeks ke video, image-to-video, start-end-to-video
kling-v3.0-stdTeks ke video, image-to-video, start-end-to-video
kling-video-o1-proTeks ke video, image-to-video, reference-to-video, start-end-to-video, video-to-video
kling-video-o1-stdTeks ke video, image-to-video, reference-to-video, start-end-to-video, video-to-video

​
Google

ModelOperasi publik
veo3Teks ke video, image-to-video
veo3-fastTeks ke video, image-to-video
veo3-proTeks ke video, image-to-video
veo3.1Teks ke video, image-to-video, reference-to-video, start-end-to-video
veo3.1-fastTeks ke video, image-to-video, reference-to-video, start-end-to-video
veo3.1-proTeks ke video, image-to-video, start-end-to-video

​
ByteDance

ModelOperasi publik
seedance-1.5-proTeks ke video, image-to-video

​
MiniMax

ModelOperasi publik
hailuo-2.3-fastGambar-ke-video
hailuo-2.3-proTeks ke video, image-to-video
hailuo-2.3-standardTeks ke video, image-to-video

​
Alibaba

ModelOperasi publik
wan-2.2-plusTeks ke video, image-to-video
wan-2.5Teks ke video, image-to-video
wan-2.6Teks ke video, image-to-video, reference-to-video

​
Shengshu

ModelOperasi publik
viduq2Teks ke video, reference-to-video
viduq2-proGambar-ke-video, referensi-ke-video, awal-akhir-ke-video
viduq2-pro-fastGambar-ke-video, awal-akhir-ke-video
viduq2-turboGambar-ke-video, awal-akhir-ke-video
viduq3-proTeks ke video, image-to-video, start-end-to-video
viduq3-turboTeks ke video, image-to-video, start-end-to-video

​
xAI

ModelOperasi publik
grok-imagine-image-to-videoGambar-ke-video
grok-imagine-text-to-videoTeks ke video
grok-imagine-upscaleVideo-ke-video

​
Lainnya

ModelOperasi publik
topaz-video-upscaleVideo-ke-video