API tạo video Seedance 2.0

Tạo video với Seedance 2.0 thông qua APIMaster.

Tạo video Seedance 2.0

Xác minh chủ thể và tài sản chân dung. Bốn mô hình dùng chung giao diện APIMaster. Máy chủ ánh xạ API, thông tin xác thực, ID và trạng thái của nhà cung cấp. Xác minh chính chủ chính thức, kiểm duyệt chân dung của kênh và tài sản thông thường hoặc ảo là các quy trình khác nhau. Chỉ gửi ảnh được chủ thể cho phép rõ ràng.

Seedance 2.0 hỗ trợ tạo video từ văn bản, tạo video từ hình ảnh và tạo từ phương tiện tham chiếu thông qua các tác vụ bất đồng bộ.

URL gốc: https://apimaster.ai/v1 là https://apimaster.ai/v1. Không thêm /v1 nào khác vào đường dẫn.

Giới hạn thời lượng (xác minh 2026-10-06)

Để tương thích giữa các kênh, hãy chỉ định rõ 4–15 giây cho Seedance 2.0. Một số tuyến không hỗ trợ duration: -1; thời lượng tự động của nhà cung cấp gốc không có trên mọi tuyến. duration: 20 vượt giới hạn; gửi lại không giải quyết được.

Tối đa 3 video tham chiếu, mỗi video 2–15 giây, tổng không quá 15 giây; âm thanh tham chiếu có cùng giới hạn số lượng và thời lượng. Đầu vào và đầu ra có giới hạn riêng. Giây tính phí có thể gồm cả hai nhưng không tăng giới hạn đầu ra.

Kiểm tra tham số trước khi gửi. HTTP 200 và task_id chỉ xác nhận tiếp nhận; HTTP 400 / InvalidParameter sau đó có thể làm tác vụ thất bại. Đọc lỗi, sửa tham số rồi tạo tác vụ mới. Không gửi lại yêu cầu chưa sửa. Tác vụ thất bại hoàn lại khoản giữ trước cho việc tạo video.

Nguồn xác minh: Seedance API.

Tương thích và kiểm tra tham số

Hỗ trợ cả POST https://apimaster.ai/v1/video/generations và POST https://apimaster.ai/v1/videos/generations. Với cùng mô hình, tham số và quy tắc tính phí giống nhau; mỗi đường dẫn giữ định dạng phản hồi tạo tác vụ hiện có. Khách hàng hiện tại không cần đổi đường dẫn.

Với Seedance, ratio và aspect_ratio là bí danh; khi bỏ qua độ phân giải, dùng 720p. Giá trị không hỗ trợ hoặc bí danh mâu thuẫn trả HTTP 400, không tự chuyển sang độ phân giải cao hơn. Hãy chỉ định rõ độ phân giải, tỷ lệ và thời lượng.

Tham số

Trường	Kiểu	Bắt buộc	Mô tả
`model`	string	có	`seedance-2.0`
`prompt`	string	có	Mô tả video
`duration`	integer	không	`duration` là thời lượng video đầu ra tính bằng giây: số nguyên từ `4` đến `15`.
`resolution`	string	không	`480p`, `720p`, `1080p`, hoặc `4K`
`aspect_ratio`	string	không	`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, hoặc `adaptive`
`image_urls`	string[]	không	URL hình ảnh tham chiếu công khai
`video_urls`	string[]	không	URL video tham chiếu công khai
`audio_urls`	string[]	không	URL âm thanh tham chiếu công khai
`generate_audio`	boolean	không	Tạo âm thanh
`watermark`	boolean	không	Thêm hình mờ
`seed`	integer	không	Hạt giống (seed) để tái lập kết quả
`output_format`	string	không	`mp4` hoặc `mov`

Gửi một tác vụ

curl -s "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "Sunlight through a forest, smooth forward camera movement",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false
  }'

Phản hồi chứa một task_id:

{"code":200,"data":[{"status":"submitted","task_id":"task_xxxxxxxx"}]}

Kiểm tra trạng thái và tải xuống

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" -H "Authorization: Bearer YOUR_API_KEY" -o output.mp4

Các trạng thái bao gồm submitted, in_progress, completed, và failed. Hãy tải xuống ngay sau khi hoàn thành.

Tính phí

Không có video tham chiếu: chi phí = số giây tính phí của video tạo ra × đơn giá áp dụng cho độ phân giải đầu ra.
Có video tham chiếu: chi phí = (tổng số giây tính phí của các video tham chiếu + số giây tính phí của video tạo ra) × đơn giá mức có đầu vào video của độ phân giải đó. Không chỉ tính thời lượng đầu ra hoặc dùng đơn giá không có video đầu vào.
Ví dụ, video tham chiếu 4 giây và đầu ra 5 giây được ước tính là 9 giây tính phí. Ảnh và âm thanh tham chiếu không cộng thêm giây video.

Khi gửi, hệ thống tạm trừ khoản phí gồm thời lượng tham chiếu đã xác minh và thời lượng đầu ra yêu cầu; thời lượng tự động hoặc giới hạn tạm trừ dùng mức ước tính tối đa áp dụng. Sau khi thành công, phí được quyết toán theo công việc tính phí thực tế của nhà cung cấp, có thể trừ thêm hoặc hoàn chênh lệch. Phí tạm trừ có thể khác phí cuối cùng. Tác vụ thất bại được hoàn khoản tạm trừ tạo video.

Kiểm tra thẻ mô hình và Video/media pricing trong ví trước khi gửi. Độ phân giải, mức đầu vào và giá của tài khoản ảnh hưởng đến đơn giá. Phí cuối cùng là số tiền ròng của tạm trừ, trừ thêm và hoàn tiền.

Lỗi

400 tham số không hợp lệ, 401 khóa API không hợp lệ, 402 số dư không đủ, 429 bị giới hạn tần suất, và 500/502 lỗi dịch vụ tạm thời.

Xem thêm: Tổng quan về tạo video và Seedance 2.5.

Báo giá Seedance và biên nhận thanh toán

Webhook tác vụ bất đồng bộ

Seedance: gửi bất biến và khôi phục yêu cầu