Tạo Video

Việc tạo video là bất đồng bộ. POST /v1/videos/generations trả về một danh tính tác vụ công khai và thường là một poll_url; video cuối cùng sẽ xuất hiện trong các phản hồi trạng thái sau. Khi model Seedance đã chọn có thể dùng thư viện material của TokenLab, URL hình ảnh và data URL inline được hỗ trợ sẽ được chuẩn bị thành material TokenLab có thể tái sử dụng trước khi tạo video. Nếu quá 60 giây, hãy thử lại sau khi auto_material_asset_ids được trả về chuyển sang ACTIVE. Nếu model đã chọn không thể dùng thư viện material, input hình ảnh thông thường tiếp tục đi theo luồng hình ảnh thông thường.

Các thao tác được hỗ trợ

Sử dụng operation rõ ràng trong sản xuất. TokenLab có thể suy luận một số thao tác từ đầu vào, nhưng các giá trị thao tác rõ ràng giúp việc xác thực, hỗ trợ và thử lại trở nên rõ ràng hơn.

Thao tác	Đầu vào yêu cầu hoặc điển hình	Trường hợp sử dụng
`text-to-video`	`prompt`	Tạo từ văn bản chỉ
`image-to-video`	`image_url` hoặc `image` tương thích	Hoạt hình một hình ảnh bắt đầu
`reference-to-video`	`reference_images` và tùy chọn `video_urls` / `audio_urls` trên các mô hình hỗ trợ	Giữ danh tính, phong cách hoặc tham chiếu tài sản
`start-end-to-video`	`start_image`, `end_image`	Kiểm soát khung hình đầu tiên và cuối cùng
`video-to-video`	`video_url` hoặc `task_id` cụ thể cho mô hình	Biến đổi hoặc nâng cấp một clip hiện có
`motion-control`	`image_url` cộng với `video_url`	Áp dụng tham chiếu chuyển động cho một đối tượng
`audio-to-video`	`audio_url`	Dòng video điều kiện âm thanh
`video-extension`	`task_id`, `extend_at`, hoặc các trường mở rộng cụ thể cho mô hình	Tiếp tục một video đã được tạo

Khám Phá Mô Hình

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \\
  -H "Authorization: Bearer sk-your-api-key"

Dùng model ID hiển thị trong TokenLab ở model, sau đó chọn biến thể tính năng bằng operation và đầu vào media tương ứng. Ví dụ gồm wan-2.7, happyhorse-1.0, viduq3, viduq3-mix, pixverse-v6, kling-3.0-video, veo3.1, và seedance-2.0; không dùng hậu tố riêng của operation làm tên model TokenLab. Đọc chi tiết mô hình đã chọn trước khi dựa vào các trường chuyên biệt như reference_images, kling_elements, output_audio, duration, resolution, hoặc aspect_ratio.

Tạo Yêu Cầu

curl https://api.tokenlab.sh/v1/videos/generations \\
  -H "Authorization: Bearer sk-your-api-key" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "veo3.1",
    "operation": "text-to-video",
    "prompt": "Một cảnh quay điện ảnh bình yên của một con mèo đi bộ qua một khu vườn ngập nắng",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

Đối với đầu vào phương tiện trong sản xuất, hãy ưu tiên URL https công khai thay vì URL data: nội tuyến. Nếu dùng URL tạm thời, hãy giữ URL hợp lệ cho đến khi TokenLab tạo xong tác vụ.

Đầu Vào Và Các Trường Cụ Thể Cho Mô Hình

Các yêu cầu của gia đình Veo 3 mặc định là âm thanh bật khi output_audio bị bỏ qua. Đặt nó một cách rõ ràng khi mô hình hỗ trợ công tắc và trải nghiệm người dùng của bạn phụ thuộc vào âm thanh.
kling_elements dành cho các yêu cầu hình ảnh điều kiện kling-3.0-video. Tham chiếu từng phần tử trong prompt dưới dạng @name; không kết hợp nó với output_audio=true.
Với họ Seedance 2.0, hãy đọc hướng dẫn mô hình video Seedance 2.0 trước khi dùng đầu ra 4K, giới hạn Fast/Mini hoặc đầu vào tham chiếu đa phương thức.
Đối với grok-imagine-video, video-to-video sử dụng một video_url công khai .mp4; hãy kiểm tra chi tiết model trước khi đặt các giới hạn như duration và resolution.

PixVerse và HappyHorse

Mô hình	Thao tác	Đầu vào	Độ phân giải	Thời lượng	Bộ chọn âm thanh
`pixverse-c1`, `pixverse-v6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	`prompt`; `image_url`; `start_image` + `end_image`; `reference_images`	360p, 540p, 720p, 1080p	Bất kỳ số nguyên từ 1 đến 15 giây	`output_audio`, mặc định `false`
`pixverse-v5.6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	Các trường giống như C1 và V6	360p, 540p, 720p, 1080p	5, 8 hoặc 10 giây; 1080p hỗ trợ 5 hoặc 8 giây	`output_audio`, mặc định `false`
`happyhorse-1.0`	`text-to-video`, `image-to-video`, `reference-to-video`, `video-to-video`	`prompt`; `image_url`; `reference_images`; `video_url` + `reference_images`	720p, 1080p	3 đến 15 giây cho các thao tác tạo; đầu ra video-to-video bị giới hạn ở 15 giây	Không gửi `output_audio`

Trên TokenLab, các mô hình PixVerse ở trên không chấp nhận operation=video-extension.

curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "operation": "image-to-video",
    "prompt": "A slow camera move through a neon-lit street",
    "image_url": "https://example.com/start.jpg",
    "resolution": "1080p",
    "duration": 5,
    "output_audio": true
  }'

Polling Kết Quả

Sử dụng poll_url đã trả về trước. Nếu bạn cần một điểm cuối cố định, sử dụng GET /v1/tasks/{id} với cùng id / task_id từ phản hồi tạo. Các tác vụ video đã hoàn thành có thể trả về video_url, video, hoặc videos tùy theo model và số lượng đầu ra. Xem billing_transaction_id như một định danh thanh toán, không phải là định danh tác vụ.

Những Cạm Bẫy Thường Gặp

Không mã hóa cứng các đường dẫn trạng thái video cũ; ưu tiên poll_url.
Không kết hợp các trường khung hình đầu tiên với các dòng hình ảnh tham chiếu dành riêng trừ khi chi tiết model cho phép.
Không giả định duration mô tả độ dài video tham chiếu đầu vào; nó thường kiểm soát độ dài đầu ra được tạo.
Không thử lại các yêu cầu tạo sau khi hết thời gian mà không kiểm tra xem một tác vụ đã được tạo hay chưa.

Tài Liệu API

Chủ đề	Tham chiếu
Tạo Video	Tạo Video
Lấy Trạng Thái Video	Lấy Trạng Thái Video
Lấy Trạng Thái Tác Vụ	Lấy Trạng Thái Tác Vụ
Hủy Tác Vụ	Hủy Tác Vụ
Thanh Toán & Giá Cả	Thanh Toán & Giá Cả

API video kiểu OpenAI và tương thích Volc

Dùng /v1/videos/generations cho API video hợp nhất của TokenLab trên nhiều mô hình. Nếu bạn đang di chuyển tích hợp Seedance 2.0 đã dùng content[] hoặc yêu cầu Action kiểu Volc, hãy dùng các endpoint tương thích Seedance dưới /api/v3. Cả hai kiểu đều dùng TokenLab Bearer API key và polling bất đồng bộ, nhưng hình dạng yêu cầu và phản hồi khác nhau.

Bắt đầu

Hướng dẫn cốt lõi

Hướng dẫn media

Các thao tác được hỗ trợ

Khám Phá Mô Hình

Tạo Yêu Cầu

Đầu Vào Và Các Trường Cụ Thể Cho Mô Hình

PixVerse và HappyHorse

Polling Kết Quả

Những Cạm Bẫy Thường Gặp

Tài Liệu API

API video kiểu OpenAI và tương thích Volc

​Các thao tác được hỗ trợ

​Khám Phá Mô Hình

​Tạo Yêu Cầu

​Đầu Vào Và Các Trường Cụ Thể Cho Mô Hình

​PixVerse và HappyHorse

​Polling Kết Quả

​Những Cạm Bẫy Thường Gặp

​Tài Liệu API

​API video kiểu OpenAI và tương thích Volc

Các thao tác được hỗ trợ

Khám Phá Mô Hình

Tạo Yêu Cầu

Đầu Vào Và Các Trường Cụ Thể Cho Mô Hình

PixVerse và HappyHorse

Polling Kết Quả

Những Cạm Bẫy Thường Gặp

Tài Liệu API

API video kiểu OpenAI và tương thích Volc