Seedance 2.5 Flash

Seedance 2.5 Flash hỗ trợ tạo video từ văn bản, tạo video từ khung hình đầu/cuối, tạo video từ tư liệu tham chiếu và chỉnh sửa video. Sử dụng dreamina-seedance-2-5-flash với cấp Default. Gửi nội dung đa phương tiện dưới dạng URL HTTP hoặc HTTPS công khai không kèm thông tin xác thực. Lưu ID tác vụ được trả về và truy vấn ID đó để lấy video đã hoàn tất.

Xem khu thử nghiệm và giá hiện tại, đặc tả OpenAPI và hướng dẫn tính giá.

Ví dụ nhanh

Yêu cầu này tạo một video dài bốn giây. Kiểm tra giá hiện tại trước khi gửi; yêu cầu tạo video được gửi và hoàn tất thành công sẽ phát sinh phí.

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-flash",
    "content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
    "resolution": "480p",
    "duration": 4,
    "ratio": "16:9",
    "generate_audio": false
  }'

Tham số

model và content là bắt buộc. Tất cả các trường khác đều là tùy chọn. Giá trị null được chỉ định tường minh và các trường không xác định đều bị từ chối.

Theo tài liệu, câu lệnh có giới hạn tối đa 10.000 token. Không có bộ tách token công khai nào được chỉ định, vì vậy không được coi số ký tự là số token chính xác.

Nội dung và chế độ

Văn bản sử dụng {"type":"text","text":"Describe the shot"}. Hình ảnh, video và âm thanh sử dụng URL lồng nhau và vai trò được chỉ định tường minh:

{
  "type": "image_url",
  "image_url": {"url": "https://example.com/reference.jpg"},
  "role": "reference_image"
}

Các mục video sử dụng type: "video_url", video_url: {"url": "..."}, role: "reference_video"; các mục âm thanh sử dụng audio_url và reference_audio theo cùng cấu trúc. Không thể kết hợp khung hình đầu/cuối với nội dung đa phương tiện tham chiếu. Các tùy chọn điều khiển Draft, Extend, 1080p, dấu chìm, giá trị khởi tạo ngẫu nhiên và đầu ra khung hình cuối không có trong tích hợp này. Không hỗ trợ hàm gọi lại.

Ràng buộc nội dung đa phương tiện

Các tệp phải có thể đọc được trước khi gửi. Thời lượng video được đo từ nội dung đa phương tiện để tính phí. Sử dụng URL công khai ổn định.

Phản hồi tác vụ và truy vấn định kỳ

Thao tác tạo trả về id, model, status và created_at. Truy vấn cùng tác vụ đó cho đến khi hoàn tất:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Trạng thái là processing, completed hoặc failed. Khi thành công, đọc output.video_url để lấy video đã lưu. Khi thất bại, đọc error.code và error.message. Phản hồi công khai không bao gồm chi phí. Hết thời gian truy vấn định kỳ không chứng minh rằng việc tạo video đã thất bại: giữ ID tác vụ và truy vấn lại thay vì gửi yêu cầu tạo video khác.

Tính phí

Đơn giá hiện tại phụ thuộc vào độ phân giải và việc có cung cấp video hay không. Khi không có video đầu vào, số giây tính phí bằng thời lượng đầu ra. Khi có video tham chiếu, số giây tính phí bằng thời lượng đầu ra cộng với giá trị lớn hơn giữa thời lượng đầu ra và tổng thời lượng đầu vào được làm tròn lên. Chỉnh sửa tính phí gấp đôi thời lượng nguồn được làm tròn lên. Âm thanh đã được bao gồm. Yêu cầu thất bại không bị tính phí.

Ví dụ, đầu ra dài năm giây với video tham chiếu dài ba giây được tính phí mười giây. Chỉnh sửa nguồn dài mười giây được tính phí hai mươi giây. Nhân số giây tính phí với đơn giá hiện tại tương ứng.

Xem vòng đời tác vụ và mã lỗi để biết các phản hồi thường gặp và hướng dẫn thử lại.