Skip to main content

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ằng cgt-; hãy polling trạng thái cho đến khi statussucceeded, 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. succeededfailed đượ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ũ.
Xem thêm Mô hình video Seedance 2.0Tạo video.

Quy tắc nội dung

  • Dùng type=text cho văn bản prompt.
  • type=image_url không có role được xử lý như khung đầu; bạn cũng có thể đặt role=first_frame.
  • Chỉ dùng role=last_frame cùng với khung đầu.
  • Dùng role=reference_image, reference_video hoặc reference_audio cho 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ố

  • ratio chấp nhận 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 hoặc adaptive.
  • Giá trị mặc định chính thức của generate_audiofalse; đặt true khi 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ối service_tier=flex, framescamera_fixed=true.
  • Khi mô hình đã chọn hỗ trợ, tools có 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.

Ví dụ