TokenLab

Video & tư liệu

Tạo Video

Bắt đầu một tác vụ tạo video

POST
/v1/videos/generations

Tổng quan

Việc tạo video là không đồng bộ (asynchronous). Một yêu cầu tạo thành công sẽ trả về một id tác vụ (giá trị tương đương với task_id) và một poll_url. Hãy gọi GET /v1/tasks/{id} với ID đó cho đến khi status là completed hoặc failed, sau đó đọc video_url. Xem Lấy trạng thái video.

  • Tệp kết quả được lưu trong 30 ngày. Hãy tải xuống nếu bạn cần lưu trữ lâu hơn; xem Lưu trữ dữ liệu.
  • Một tác vụ Seedance đang chờ xử lý có thể bị hủy bằng Hủy tác vụ.
  • Chi phí có thể được giữ chỗ khi tác vụ được chấp nhận và sẽ được thanh toán khi tác vụ hoàn tất hoặc thất bại. Xem Thanh toán & Định giá.
  • Gửi tiêu đề Idempotency-Key để thử lại yêu cầu tạo một cách an toàn sau khi hết thời gian chờ (timeout).

Mỗi model chấp nhận các thao tác và trường dữ liệu riêng. GET /v1/models/{model} (Lấy model) liệt kê, cho mỗi thao tác, các trường được chấp nhận, độ phân giải, thời lượng và tỷ lệ khung hình. Một trường hoặc giá trị nằm ngoài danh sách đó sẽ trả về lỗi 400 kèm theo các giá trị được chấp nhận. Hãy tự thiết lập duration, resolution, aspect_ratio và output_audio: khi bạn bỏ qua một trường, TokenLab sẽ sử dụng giá trị mặc định của model cho thao tác đó, và nếu không có giá trị mặc định nào khớp, yêu cầu sẽ trả về lỗi 400 và nêu tên trường cần thiết lập.

Đầu vào Âm thanh và Phương tiện

Hành vi âm thanh phụ thuộc vào mô hình được chọn và thao tác. Một video có thể chứa âm thanh ngay cả khi không có bộ chọn âm thanh nào được hiển thị. Việc bỏ qua bộ chọn khác với việc gửi false.

  • veo3.1, veo3.1-fast, và veo3.1-lite luôn tạo âm thanh. Hãy bỏ qua output_audio hoặc gửi true; giá trị false sẽ bị từ chối.
  • wan-2.6 và wan-2.7 luôn bao gồm âm thanh. Hãy bỏ qua output_audio hoặc gửi true. wan-3.0 và wan-3.0-prime cũng luôn bao gồm âm thanh và không sử dụng bộ chọn âm thanh.
  • hailuo-h3 tạo âm thanh gốc và không có công tắc tắt tiếng. Không gửi bộ chọn âm thanh mà chi tiết mô hình không liệt kê.
  • viduq3-pro và viduq3-turbo tạo âm thanh theo mặc định; hãy gửi output_audio: false (hoặc audio: false) để có đầu ra không âm thanh. Các mô hình Seedance và PixVerse sử dụng output_audio; hãy gửi tham số này một cách rõ ràng thay vì dựa vào mặc định. Chỉ sử dụng tham số này cho các thao tác có liệt kê nó.
  • audio_url / audio_urls cung cấp âm thanh đầu vào hoặc âm thanh tham chiếu. Chúng không phải là các công tắc đầu ra âm thanh. Chỉnh sửa video, chuyển động (motion transfer) và chuyển đổi phong cách (style transfer) có thể giữ lại bản nhạc đầu vào; việc bảo toàn âm thanh nguồn không có nghĩa là tắt tiếng nó.

Hãy kiểm tra chi tiết mô hình để biết các giá trị được phép và giá phí phụ thuộc vào âm thanh. Ở những nơi mô hình liệt kê chúng, các bí danh outputAudio, generate_audio, và boolean audio phải khớp với output_audio khi được kết hợp. Đừng mặc định rằng mọi phiên bản hoặc thao tác trong một dòng mô hình đều chia sẻ các điều khiển âm thanh giống nhau.

Sử dụng các URL https có thể truy cập công khai cho hình ảnh, video và âm thanh, đồng thời đảm bảo chúng vẫn hợp lệ cho đến khi tác vụ bắt đầu. Một URL phương tiện có thể dài tối đa 8.192 ký tự. Một số model cũng chấp nhận URL hình ảnh data: nội tuyến (tối đa 2.000.000 ký tự mỗi trường); URL sẽ đáng tin cậy hơn đối với các tệp lớn. Không trộn lẫn base64 nội tuyến và URL từ xa trong cùng một yêu cầu.

Nội dung yêu cầu (Request Body)

modelstringmặc định: veo3.1

ID của model video. Liệt kê các model video hiện tại với Liệt kê model (recommended_for=video), sau đó gửi model một cách rõ ràng.

PixVerse

  • Mô hình: pixverse-c1, pixverse-v6, pixverse-v5.6
  • Thao tác: text-to-video, image-to-video, start-end-to-video, reference-to-video
  • Bộ chọn âm thanh: output_audio, mặc định false

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

HappyHorse

  • Mô hình: happyhorse-1.0
  • Thao tác: text-to-video, image-to-video, reference-to-video, video-to-video
  • Bộ chọn âm thanh: Không gửi output_audio
promptstring

Mô tả văn bản của video, tối đa 10.000 ký tự. Hầu hết các thao tác đều cần trường này; chi tiết model sẽ cho biết thao tác nào không cần.

operationstring

Chế độ tạo: text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension, hoặc motion-control. Mỗi model chỉ hỗ trợ một số chế độ nhất định; các chế độ khác sẽ trả về lỗi 400 unsupported_operation. Nếu bạn bỏ qua tham số này, TokenLab sẽ tự suy luận dựa trên các đầu vào: task_id có kèm extend_at hoặc extend_times sẽ cho ra video-extension, hình ảnh hoặc tài liệu tham chiếu sẽ cho ra reference-to-video, end_image sẽ cho ra start-end-to-video, đầu vào video sẽ cho ra video-to-video, đầu vào hình ảnh (image, image_url, image_urls hoặc start_image) sẽ cho ra image-to-video, và các trường hợp còn lại là text-to-video. Hãy gửi tham số này một cách tường minh để các trường không khớp có thể báo lỗi sớm.

image_urlstring

URL có thể truy cập công khai của hình ảnh khung hình đầu tiên. Các model Seedance 2.0 cũng chấp nhận asset://asset-YYYYMMDDHHMMSS-xxxxx để sử dụng tài liệu (material) TokenLab ở trạng thái ACTIVE làm khung hình đầu tiên. Ưu tiên sử dụng URL https để có khả năng tương thích model rộng nhất.

imagestring

Hình ảnh nội tuyến dưới dạng URL dữ liệu (ví dụ: data:image/jpeg;base64,...). Chỉ một số model chấp nhận định dạng này; image_url hoạt động trên nhiều model hơn.

image_urlsarray

Các URL hình ảnh cho các model liệt kê trường này. Xem reference_images để biết giới hạn số lượng.

reference_imagesarray

Hình ảnh tham chiếu cho reference-to-video, dưới dạng URL https hoặc URL dữ liệu. Giới hạn số lượng phụ thuộc vào model:

  • seedance-2.0, seedance-2.0-fast và seedance-2.0-mini: tối đa 9 hình ảnh tham chiếu, bao gồm cả tài liệu (material assets). Vượt quá giới hạn sẽ trả về lỗi 400 too_many_seedance_reference_images.
  • seedance-2.5: tối đa 30 đầu vào hình ảnh tổng cộng trên cả image_urls và reference_images.
  • grok-imagine-video: tối đa 7, và duration bị giới hạn ở 10 giây. grok-imagine-video-1.5 và grok-imagine-video-1.5-preview không nhận hình ảnh tham chiếu.
  • Các model khác: xem chi tiết model. Yêu cầu vượt quá giới hạn sẽ trả về lỗi 400 too_many_items.

Các model Seedance 2.0 cũng chấp nhận asset://asset-YYYYMMDDHHMMSS-xxxxx cho tài liệu TokenLab ở trạng thái ACTIVE. Để biết về lựa chọn model, giới hạn 4K và các lưu ý về Mini, hãy xem Hướng dẫn về model video Seedance 2.0. Đối với grok-imagine-video, không kết hợp hình ảnh tham chiếu với image_url hoặc image.

start_imagestring

Hình ảnh khung hình đầu tiên. Khi kết hợp với end_image, yêu cầu sẽ là start-end-to-video. Nếu không có end_image, yêu cầu sẽ là image-to-video, và start_image hoạt động giống như image trên các mô hình có liệt kê tham số này trong hợp đồng. Chấp nhận URL công khai hoặc data URL; các mô hình Seedance 2.0 cũng chấp nhận asset://asset-YYYYMMDDHHMMSS-xxxxx.

end_imagestring

Hình ảnh khung hình cuối cùng cho start-end-to-video. Chấp nhận các đầu vào tương tự như start_image.

material_asset_idstring

ID tài liệu (material asset) TokenLab Seedance được trả về bởi Tạo tài liệu (Create Material Asset). Chỉ được chấp nhận bởi các model Seedance 2.0; các model khác sẽ trả về lỗi 400 unsupported_seedance_material_asset_model. Tài liệu phải ở trạng thái ACTIVE và thuộc về tài khoản của bạn. Trường này là đầu vào tham chiếu chung; để chỉ định rõ ràng ý nghĩa khung hình đầu, khung hình cuối hoặc hình ảnh tham chiếu, hãy đặt asset://<material_asset_id> vào start_image, end_image hoặc reference_images.

material_asset_idsarray

Tối đa 9 ID tài liệu TokenLab Seedance. Chúng được tính vào giới hạn 9 hình ảnh tham chiếu của các model Seedance 2.0.

Các URL hình ảnh thông thường được truyền dưới dạng đầu vào hình ảnh; chúng không tạo ra tài liệu có thể tái sử dụng. Hãy tạo tài liệu có thể tái sử dụng thông qua API tài liệu, sau đó sử dụng ID TokenLab hoặc URI asset://asset-YYYYMMDDHHMMSS-xxxxx của chúng. Nếu một tài liệu rõ ràng trả về lỗi 409 seedance_material_preparing, hãy kiểm tra các inactive_asset_ids được trả về và thử lại sau khi các tài liệu đó chuyển sang trạng thái ACTIVE.

video_urlstring

URL có thể truy cập công khai của video nguồn, cho các thao tác sử dụng video: video-to-video, video-extension và motion-control, trên các model liệt kê trường này.

video_urlsarray

Video nguồn hoặc video tham chiếu cho các model liệt kê trường này. seedance-2.5 chấp nhận tối đa 10 đầu vào video tổng cộng trên video_url và video_urls. Xem chi tiết model cho các model khác.

audio_urlstring

URL âm thanh công khai cho tham chiếu âm thanh hoặc thao tác điều khiển bằng âm thanh, trên các model liệt kê trường này. Đây là đầu vào, không phải công tắc đầu ra âm thanh.

audio_urlsarray

Âm thanh tham chiếu cho các model liệt kê trường này. seedance-2.5 chấp nhận tối đa 10 đầu vào âm thanh tổng cộng trên audio_url và audio_urls và cho phép yêu cầu có tham chiếu âm thanh mà không cần prompt. Đối với seedance-2.5, âm thanh tham chiếu cộng với video tham chiếu có thời lượng tối đa 30 giây.

task_idstring

ID của một tác vụ trước đó trong không gian làm việc của bạn, dành cho video-extension trên các model liệt kê trường này. Một tác vụ không thuộc về không gian làm việc của bạn sẽ trả về lỗi 403 task_not_owned.

extend_atinteger

Giây của video nguồn nơi video-extension bắt đầu. Bắt buộc đối với grok-imagine-video.

extend_timesstring

Số giây cần thêm vào trong video-extension, trên các model liệt kê trường này. grok-imagine-video nhận giá trị 6 hoặc 10.

durationinteger

Thời lượng đầu ra tính bằng giây. Các giá trị cho phép phụ thuộc vào model và thao tác; các giá trị khác sẽ trả về lỗi 400 invalid_duration. Các model Seedance cũng chấp nhận -1 để model tự chọn trong phạm vi của nó; chi phí sẽ được ước tính thận trọng cho đến khi tác vụ hoàn tất. Một số thao tác không cần thời lượng, chẳng hạn như motion-control và grok-imagine-video video-to-video.

secondsinteger

Bí danh tương thích cho duration. Nếu cả hai đều được gửi, chúng phải giống hệt nhau.

aspect_ratiostring

Tỷ lệ khung hình, ví dụ 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 hoặc adaptive (Seedance). Các giá trị cho phép phụ thuộc vào model và thao tác; các giá trị khác sẽ trả về lỗi 400 invalid_aspect_ratio.

resolutionstring

Độ phân giải đầu ra, ví dụ 480p, 720p, 1080p hoặc 4k. Các giá trị cho phép phụ thuộc vào model và thao tác, một số model cũng sử dụng 360p, 540p hoặc 768p. Các giá trị khác sẽ trả về lỗi 400 invalid_resolution.

output_audioboolean

Bộ chọn đầu ra âm thanh cho các thao tác liệt kê trường này. Việc bỏ qua sẽ tuân theo mặc định của model; false yêu cầu đầu ra im lặng chỉ khi model cho phép. Xem các lưu ý về âm thanh ở trên và chi tiết model đã chọn.

output_formatstring

Định dạng container, mp4 hoặc mov, cho các model liệt kê trường này, chẳng hạn như seedance-2.5. Bỏ qua đối với các model không liệt kê trường này.

return_last_frameboolean

Cũng trả về khung hình được tạo cuối cùng dưới dạng last_frame_url. Chỉ dành cho các model Seedance.

watermarkboolean

Bật/tắt hình mờ (watermark) cho các model liệt kê trường này (các model Seedance).

negative_promptstring

Những gì cần tránh trong video được tạo, tối đa 5.000 ký tự, cho các model liệt kê trường này.

seedinteger

Seed để tạo video có thể tái lập, cho các model liệt kê trường này. Các model Seedance 2.0 chấp nhận -1 cho seed ngẫu nhiên; seedance-2.5 không chấp nhận trường này.

fpsinteger

Số khung hình trên giây (1-120), cho các model liệt kê trường này.

framesinteger

Số lượng khung hình, cho các model liệt kê trường này. Các model Seedance không chấp nhận trường này.

execution_expires_afterinteger

Số giây tác vụ có thể chờ trong hàng đợi trước khi hết hạn (3600 đến 259200), dành cho các model Seedance.

priorityinteger

Độ ưu tiên tác vụ từ 0 đến 9, dành cho các model Seedance. Không kết hợp với service_tier=flex.

service_tierstring

default được chấp nhận như một thao tác không thực hiện (no-op) tương thích trên các model Seedance 2.0 và 2.5. flex bị từ chối trên các model đó.

safety_identifierstring

Định danh an toàn của người dùng cuối (tối đa 128 ký tự), dành cho các model Seedance. Nếu bỏ qua, TokenLab sử dụng user khi được cung cấp.

toolsarray

Các công cụ mà model có thể sử dụng trong khi tạo, dành cho các model Seedance 2.0 và 2.5. Công cụ được hỗ trợ là {"type": "web_search"}.

userstring

Định danh duy nhất cho người dùng cuối. Đối với các model Seedance, TokenLab cũng sử dụng nó làm safety_identifier khi trường đó bị bỏ qua.

Tên trường tương thích

  • Các trường chính sử dụng snake_case: aspect_ratio, output_audio và reference_images.
  • Để tương thích, TokenLab cũng chấp nhận ratio, generate_audio, outputAudio, seconds và referenceImages.
  • Nếu cả trường chính và bí danh của nó đều được gửi, giá trị của chúng phải khớp nhau. Sự không khớp sẽ trả về lỗi 400 với conflicting_audio_selector, conflicting_duration hoặc conflicting_aspect_ratio.

Tham số Seedance

Các model Seedance (seedance-2.0, seedance-2.0-fast, seedance-2.0-mini và seedance-2.5) nhận các tên trường TokenLab ở trên và các bí danh seconds, ratio và generate_audio. Các phiên bản có sự khác biệt:

Các model Seedance 2.0seedance-2.5
Độ phân giảiseedance-2.0: 480p, 720p, 1080p, 4k. seedance-2.0-fast và seedance-2.0-mini: 480p, 720p480p, 720p
Thời lượng-1, 4 đến 15 giây-1, 4 đến 30 giây
Tỷ lệ khung hình1:1, 3:4, 4:3, 9:16, 16:9, 21:9, adaptiveTương tự cho text-to-video và reference-to-video. Image-to-video, start-end, chỉnh sửa video và mở rộng cần adaptive; chỉnh sửa video cũng cần duration=-1
Định dạng đầu ramp4mp4 hoặc mov
seedĐược chấp nhậnKhông được chấp nhận
Đầu vào tham chiếu9 hình ảnh tham chiếu bao gồm tài liệu (tài liệu chỉ được chấp nhận trên các model này)30 hình ảnh, 10 video và 10 tệp âm thanh tổng cộng

Chi tiết model là nguồn thông tin hiện tại cho các giá trị này. Hãy gửi duration, resolution, aspect_ratio và output_audio một cách rõ ràng thay vì dựa vào mặc định; recommended_request của model hiển thị một yêu cầu điển hình.

duration=-1 hoặc seconds=-1 cho phép Seedance chọn thời lượng đầu ra trong phạm vi của model. TokenLab ước tính chi phí một cách thận trọng trước khi tác vụ hoàn tất, sau đó thanh toán từ mức sử dụng của tác vụ đã hoàn thành khi có sẵn. service_tier=flex và frames bị từ chối trên các model này.

Ví dụ về 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
  }'

Phản hồi (Response)

Các trường mô tả kết quả, lỗi, dấu thời gian và model được trả về khi có sẵn cho tác vụ.

idstring

ID tác vụ. Giống hệt với task_id.

task_idstring

ID tác vụ để thăm dò (poll) với GET /v1/tasks/{id}.

poll_urlstring

URL trạng thái cho tác vụ này, /v1/tasks/{id}. Hãy gọi nó với API key của bạn.

statusstring

Trạng thái tác vụ: pending, processing, completed, failed. Một tác vụ mới thường ở trạng thái pending.

createdinteger

Dấu thời gian Unix khi tác vụ được tạo.

modelstring

Model đã sử dụng.

billing_transaction_idstring

ID giao dịch thanh toán khi việc thanh toán đã hoàn tất. Nó tách biệt với ID tác vụ.

video_urlstring

URL video, chỉ xuất hiện khi phản hồi tạo đã mang theo kết quả. Thông thường bạn đọc nó từ phản hồi trạng thái.

errorstring | object

Thông báo lỗi hoặc đối tượng lỗi có cấu trúc khi tác vụ thất bại.

Lỗi

Trạng thái và mãÝ nghĩa
400 invalid_requestMột trường bị sai định dạng, nằm ngoài phạm vi hoặc bị thiếu. error.param sẽ nêu tên trường đó. Một thông báo như "Set aspect_ratio explicitly" có nghĩa là trường bị bỏ qua không có giá trị mặc định cho yêu cầu này.
400 unsupported_operation, unsupported_parameter, invalid_resolution, invalid_duration, invalid_aspect_ratio, invalid_parameter_value, too_many_items, prompt_too_longYêu cầu không khớp với những gì model chấp nhận cho thao tác đó. Lỗi thường liệt kê các giá trị được chấp nhận.
400 invalid_parameterMột đầu vào không phù hợp với thao tác, ví dụ hình ảnh được gửi cùng với text-to-video.
400 conflicting_audio_selector, conflicting_duration, conflicting_aspect_ratioMột bí danh và trường chính của nó không khớp.
400 unpriceable_selectionSự kết hợp đã chọn không có giá. Hãy thay đổi resolution, duration, aspect_ratio hoặc cài đặt âm thanh.
400 too_many_seedance_reference_images, unsupported_seedance_material_asset_modelQuá nhiều hình ảnh tham chiếu cho model Seedance 2.0, hoặc tài liệu được gửi đến một model khác.
402Không đủ số dư.
403 task_not_ownedtask_id thuộc về một không gian làm việc khác.
409 seedance_material_preparing, seedance_material_route_unavailableTài liệu chưa ở trạng thái ACTIVE, hoặc model đã chọn không thể sử dụng các tài liệu được cung cấp.
429Vượt quá giới hạn tốc độ (Rate limit). Xem Giới hạn tốc độ.

Yêu cầu

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,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Phản hồi

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

Image to Video

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "hailuo-2.3",
        "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"
    }
)

Reference to Video

Sử dụng operation=reference-to-video khi model hỗ trợ điều kiện tham chiếu chuyên dụng. Các tham chiếu hình ảnh nằm trong reference_images; các model nhận video và âm thanh tham chiếu sử dụng video_urls và audio_urls. duration chỉ thiết lập độ dài đầu ra được tạo. Nó không giới hạn độ dài của đầu vào video tham chiếu. Xem reference_images ở trên để biết giới hạn số lượng cho mỗi model.

import requests

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"
        ],
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "9:16"
    }
)

Keyframe Control

Sử dụng start_image và end_image để kiểm soát khung hình đầu và cuối:

import requests

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"
    }
)

Video to Video

Sử dụng operation=video-to-video khi model chấp nhận một video hiện có làm đầu vào chính. Đối với grok-imagine-video, hãy gửi URL .mp4 HTTPS công khai trong video_url và prompt chỉnh sửa, đồng thời bỏ qua resolution, duration và aspect_ratio.

import requests

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."
    }
)

Video Extension

Sử dụng operation=video-extension để tiếp tục một kết quả trước đó. Gửi task_id của một tác vụ từ không gian làm việc của bạn và một prompt; các trường khác phụ thuộc vào model. grok-imagine-video cũng cần extend_at và nhận extend_times là 6 hoặc 10. veo3.1 và veo3.1-fast nhận task_id và prompt. Các model Seedance liệt kê video_url, video_urls và task_id cho thao tác này.

Motion Control

Sử dụng operation=motion-control khi model mong đợi cả hình ảnh chủ thể và video tham chiếu chuyển động. Gửi image_url và video_url; resolution là bắt buộc.

import requests

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 identity stable while following the motion reference.",
        "image_url": "https://example.com/subject.png",
        "video_url": "https://example.com/motion.mp4",
        "resolution": "720p"
    }
)

Khám phá Model

Danh mục video công khai và các thao tác được hỗ trợ thay đổi theo thời gian. Sử dụng Models API để kiểm tra hỗ trợ hiện tại trước khi bạn thiết lập luồng công việc cụ thể cho model:

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

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

Đọc phản hồi chi tiết model trước khi dựa vào các thao tác hoặc trường cụ thể của model. Các thao tác như video-extension và motion-control là dành riêng cho từng model; hãy xác nhận tính khả dụng hiện tại ở đó thay vì dựa vào các ví dụ tĩnh trong trang này.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

Khóa tùy chọn giúp yêu cầu tạo trở nên an toàn khi thử lại. Hãy gửi một giá trị duy nhất mới, chẳng hạn như UUID, cho mỗi tác vụ. Thử lại với cùng khóa và cùng phần thân sẽ trả về kết quả của yêu cầu tạo ban đầu, thường là tác vụ gốc, và không tạo, điều phối hoặc tính phí tác vụ thứ hai. Phần thân khác với khóa đã được chấp nhận sẽ bị từ chối với 409. Khóa dài hơn 255 ký tự sẽ bị bỏ qua và yêu cầu đó sẽ không có bảo vệ idempotency. Xem Thử lại an toàn với khóa idempotency.

Độ dài1 <= length <= 255

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json