Tổng quan
Các endpoint này dành cho nhóm đã dùng cấu trúc tác vụ Seedance kiểu Volc. Xác thực bằng TokenLab Bearer API key. ID tác vụ trả về bắt đầu bằngcgt-; hãy polling trạng thái cho đến khi status là succeeded, failed, cancelled hoặc expired.
Hợp đồng tác vụ chính thức dùng các đường dẫn REST dưới /api/v3/contents/generations/tasks. Các alias Action cũ chỉ được giữ cho tích hợp TokenLab trước đây và không thuộc hợp đồng wire-compatible chính thức.
callback_url nhận một địa chỉ HTTP(S) công khai. TokenLab gửi đúng đối tượng truy vấn mỗi khi trạng thái đổi sang queued, running, succeeded, failed hoặc expired, không kèm header riêng của TokenLab. succeeded và failed được thử lại tối đa ba lần sau năm giây.
Để khôi phục an toàn sau khi mất kết nối, hãy gửi một
Idempotency-Key duy nhất trong yêu cầu tạo REST. Gửi lại cùng body và key sẽ trả về cùng ID cgt-...; dùng key đó với body khác sẽ trả về 409. Cơ chế này không áp dụng cho tuyến Action cũ.Quy tắc nội dung
- Dùng
type=textcho văn bản prompt. type=image_urlkhông córoleđược xử lý như khung đầu; bạn cũng có thể đặtrole=first_frame.- Chỉ dùng
role=last_framecùng với khung đầu. - Dùng
role=reference_image,reference_videohoặcreference_audiocho media tham chiếu. - Không trộn đầu vào khung đầu/cuối với media tham chiếu trong cùng một yêu cầu.
Ghi chú tham số
ratiochấp nhận16:9,4:3,1:1,3:4,9:16,21:9hoặcadaptive.- Giá trị mặc định chính thức của
generate_audiolàfalse; đặttruekhi cần âm thanh đồng bộ. service_tier=defaultđược chấp nhận. Tác vụ tương thích Seedance 2.0 từ chốiservice_tier=flex,framesvàcamera_fixed=true.- Khi mô hình đã chọn hỗ trợ,
toolscó thể chứa các object như{ "type": "web_search" }. Mục tool sai định dạng sẽ bị từ chối thay vì bị bỏ qua.