Seedance Official Edition Video API

Trang này mô tả cách gọi các model video Seedance bản chính thức. Giống các model video khác, chúng được tạo bằng POST /v1/videos và truy vấn bằng GET /v1/videos/{id}; xác thực, tải lên tư liệu, trạng thái truy vấn định kỳ, tải kết quả và xử lý lỗi xem Quy chuẩn gọi Video API đầy đủ. Trang này chỉ trình bày các trường và quy tắc riêng của nhóm model này.

Cập nhật ngày 2026-10-10. Nhóm model này chỉ hỗ trợ truy vấn định kỳ: không đặt callback_url khi tạo, nếu không yêu cầu sẽ bị từ chối. SD bản đám mây (SD2.0, SD2.5) và Seedance chuyển tiếp chính thức có khả năng khác với nhóm này, lần lượt xem SD bản đám mây và Seedance chuyển tiếp chính thức.

Model

Tên model phải khớp chính xác với id do GET /v1/models trả về, bao gồm hậu tố 官方版. Mỗi dòng chỉ có một tên model; dùng resolution để chọn mức độ phân giải đầu ra, và yêu cầu được tính phí theo mức đó. Khi bổ sung mức mới sau này, tên model vẫn giữ nguyên.

Quy tắc chung

• Độ phân giải: điền vào resolution một mức trong bảng trên, không phân biệt chữ hoa/thường (720p và 720P là như nhau); nếu không truyền, dùng mức thấp nhất. Điền mức mà dòng model không hỗ trợ sẽ trả về 400, hệ thống không tự hạ mức.
• Thời lượng: số giây nguyên trong duration (hoặc seconds dạng chuỗi); nếu không truyền, dùng giá trị mặc định trong bảng trên.
• Tỷ lệ khung hình: ratio (hoặc aspect_ratio) nhận 16:9, 9:16, 1:1, 4:3, 3:4, 21:9; mặc định 16:9. Không hỗ trợ auto.
• Prompt: prompt bắt buộc.
• Âm thanh: không có tùy chọn tạo âm thanh; không gửi generate_audio.
• Trường tùy chọn: negative_prompt (prompt phủ định), seed (số nguyên).

Tư liệu tham chiếu

• Ảnh tham chiếu đặt trong mảng images ở cấp gốc.
• Video tham chiếu đặt trong metadata.referenceVideos, âm thanh tham chiếu đặt trong metadata.referenceAudios.
• Mỗi loại tư liệu chỉ dùng một trường; nếu gửi nhiều bí danh, hệ thống chỉ lấy một nhóm và không gộp lại.
• Yêu cầu về URL và cách tải tệp cục bộ lên xem Yêu cầu đối với URL tư liệu và Tải lên tư liệu cục bộ.

{
  "model": "seedance-2.5官方版",
  "resolution": "720p",
  "prompt": "Dùng ngoại hình sản phẩm từ ảnh tham chiếu, nhịp máy quay từ video tham chiếu và không khí âm thanh từ âm thanh tham chiếu để làm quảng cáo công nghệ",
  "duration": 10,
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
    "referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
  }
}

Khung hình đầu và cuối

Khung hình đầu và khung hình cuối đặt trong metadata.firstFrame và metadata.lastFrame. lastFrame phải đi kèm firstFrame; khung hình đầu và cuối không thể dùng chung với ảnh, video hoặc âm thanh tham chiếu.

{
  "model": "seedance-2.0官方版",
  "prompt": "Chuyển mượt từ quảng trường vắng lúc sáng sớm sang cùng bố cục vào ban đêm khi đèn bật sáng",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Tải tệp lên

Cũng có thể gửi trực tiếp 1 tệp ảnh cục bộ bằng multipart/form-data, trong trường input_reference; khi đó đừng gửi images hoặc image trong cùng yêu cầu. Video và âm thanh tham chiếu không thể gửi dưới dạng tệp, hãy lấy URL trước theo Tải lên tư liệu cục bộ.

Tên model cũ

Các tên model cũ có kèm mức độ phân giải Seedance-2.5-720p官方版, Seedance-2.0-720p官方版, Seedance-2.0-fast-720p官方版, seedance-2.0-mini-480p, seedance-2.0-mini-720p vẫn gọi được; đầu ra và chi phí cố định theo mức trong tên, và resolution sẽ bị bỏ qua. Các tên này không còn hiển thị trong quảng trường model; khi tích hợp mới, hãy dùng tên dòng model trong bảng trên kèm resolution.