Video & tư liệu
Tạo Video
Bắt đầu một tác vụ tạo video
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-liteluôn tạo âm thanh. Hãy bỏ quaoutput_audiohoặc gửitrue; giá trịfalsesẽ bị từ chối.wan-2.6vàwan-2.7luôn bao gồm âm thanh. Hãy bỏ quaoutput_audiohoặc gửitrue.wan-3.0vàwan-3.0-primecũng luôn bao gồm âm thanh và không sử dụng bộ chọn âm thanh.hailuo-h3tạ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-provàviduq3-turbotạo âm thanh theo mặc định; hãy gửioutput_audio: false(hoặcaudio: false) để có đầu ra không âm thanh. Các mô hình Seedance và PixVerse sử dụngoutput_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_urlscung 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)
veo3.1ID 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 địnhfalse
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
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.
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.
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.
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.
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.
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-fastvà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ỗi400 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_urlsvàreference_images.grok-imagine-video: tối đa 7, vàdurationbị giới hạn ở 10 giây.grok-imagine-video-1.5vàgrok-imagine-video-1.5-previewkhô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.
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.
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.
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.
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.
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 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.
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.
Â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.
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.
Giây của video nguồn nơi video-extension bắt đầu. Bắt buộc đối với grok-imagine-video.
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.
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.
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.
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.
Độ 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.
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.
Đị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.
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.
Bật/tắt hình mờ (watermark) cho các model liệt kê trường này (các model Seedance).
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.
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.
Số khung hình trên giây (1-120), cho các model liệt kê trường này.
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.
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.
Độ ư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.
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 đó.
Đị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.
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"}.
Đị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_audiovàreference_images. - Để tương thích, TokenLab cũng chấp nhận
ratio,generate_audio,outputAudio,secondsvà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
400vớiconflicting_audio_selector,conflicting_durationhoặcconflicting_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.0 | seedance-2.5 | |
|---|---|---|
| Độ phân giải | seedance-2.0: 480p, 720p, 1080p, 4k. seedance-2.0-fast và seedance-2.0-mini: 480p, 720p | 480p, 720p |
| Thời lượng | -1, 4 đến 15 giây | -1, 4 đến 30 giây |
| Tỷ lệ khung hình | 1:1, 3:4, 4:3, 9:16, 16:9, 21:9, adaptive | Tươ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 ra | mp4 | mp4 hoặc mov |
seed | Được chấp nhận | Không được chấp nhận |
| Đầu vào tham chiếu | 9 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 -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ụ.
ID tác vụ. Giống hệt với task_id.
ID tác vụ để thăm dò (poll) với GET /v1/tasks/{id}.
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.
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.
Dấu thời gian Unix khi tác vụ được tạo.
Model đã sử dụng.
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ụ.
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.
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_request | Mộ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_long | Yê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_parameter | Mộ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_ratio | Một bí danh và trường chính của nó không khớp. |
400 unpriceable_selection | Sự 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_model | Quá 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. |
402 | Không đủ số dư. |
403 task_not_owned | task_id thuộc về một không gian làm việc khác. |
409 seedance_material_preparing, seedance_material_route_unavailable | Tà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. |
429 | Vượ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
{
"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 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
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"
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.
1 <= length <= 255Nộ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