Video API Seedance

Tạo video Seedance sử dụng Video API bất đồng bộ. Trước tiên gửi một tác vụ, sau đó kiểm tra trạng thái bằng ID tác vụ được trả về. API này tách biệt với Chat Completions.

Trước khi bắt đầu

Tạo API key Modelflare và dùng https://modelflare.dev/v1 làm Base URL. Tên model công khai là seedance-2.0 và seedance-2.5.

Tổ hợp thời lượng và độ phân giải có thể khác nhau theo model. Hãy kiểm tra Model & Bảng giá trước khi gửi yêu cầu. Khi được hỗ trợ, độ phân giải là 480p, 720p, 1080p hoặc 4k.

Yêu cầu văn bản thành video

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Một chú mèo trắng chạy trên phố đèn neon dưới mưa, góc máy điện ảnh chuyển động",
    "duration": 4,
    "resolution": "720p"
  }'

Yêu cầu ảnh thành video

Thêm image với URL HTTPS của ảnh có thể truy cập công khai. Các trường còn lại giống yêu cầu văn bản thành video.

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Chủ thể từ từ quay về phía máy quay khi máy quay tiến lên",
    "image": "https://example.com/reference.png",
    "duration": 4,
    "resolution": "720p"
  }'

Phản hồi khi gửi

Gửi thành công sẽ trả về ID tác vụ công khai. id và task_id chỉ cùng một tác vụ; hãy lưu một trong hai.

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued"
}

Kiểm tra trạng thái

Kiểm tra tác vụ sau mỗi vài giây. Trạng thái chờ có thể là queued, pending, processing hoặc in_progress. Dừng khi trạng thái là completed hoặc failed.

curl https://modelflare.dev/v1/videos/task_example_123 \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Ví dụ phản hồi hoàn tất:

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Tải kết quả

Sau khi hoàn tất, tải video qua endpoint content:

curl -L https://modelflare.dev/v1/videos/task_example_123/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -o seedance.mp4

Các trường chính

• model: bắt buộc; seedance-2.0 hoặc seedance-2.5.
• prompt: bắt buộc; mô tả video.
• duration: bắt buộc; số nguyên tính bằng giây, hiện tối thiểu là 4. seconds cũng được chấp nhận.
• resolution: bắt buộc; độ phân giải được model đã chọn hỗ trợ.
• image: tùy chọn; URL HTTPS công khai để chuyển sang tạo video từ ảnh.

HTTP 400 thường là tham số sai, 401 là API key không hợp lệ, 429 là giới hạn tạm thời; lỗi 5xx có thể thử lại với thời gian chờ tăng dần.