Trạng thái và kết quả của nhiệm vụ Seedance

Quá trình tạo video Seedance không đồng bộ. Yêu cầu tạo trả về ID nhiệm vụ; thăm dò Modelflare cho đến khi nhiệm vụ được hoàn thành hoặc thất bại.

Các mẫu được hỗ trợ

Tạo nhiệm vụ

Sử dụng trang mô hình phù hợp cho nội dung yêu cầu hoàn chỉnh:

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A cat walks through a sunlit room"}],
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9"
  }'

Lưu id từ phản hồi. Phản hồi tương thích có thể sử dụng task_id.

Thăm dò nhiệm vụ

bash

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

Phản hồi của công chúng được chuẩn hóa trên các nhà cung cấp video:

JSON

{
  "id": "TASK_ID",
  "object": "video",
  "model": "seedance-2.5",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1786084139,
  "seconds": "5",
  "metadata": {
    "action": "omniGenerate",
    "resolution": "1080p",
    "ratio": "9:16",
    "output_format": "mp4",
    "generate_audio": true,
    "usage": {"completion_tokens": 120, "total_tokens": 140}
  }
}

Thăm dò ý kiến trong khi status là queued hoặc in_progress. Dừng ở completed hoặc failed.

Trạng thái	Ý nghĩa	Bước tiếp theo
queued	Đang chờ chạy	Thăm dò lại
in_progress	Đang xử lý	Thăm dò lại
completed	Video đã sẵn sàng	Tải nội dung xuống
failed	Tác vụ thất bại	Đọc lỗi và sửa yêu cầu

Khi phản hồi dịch vụ bao gồm chúng, metadata có thể chứa hành động, độ phân giải, tỷ lệ, định dạng đầu ra, cờ âm thanh và cách sử dụng mã thông báo được chuẩn hóa. Hãy coi các trường này là tùy chọn; sử dụng status và điểm cuối nội dung làm hợp đồng ổn định.

Tải kết quả xuống

bash

curl --fail --location \
  https://modelflare.dev/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --output seedance-result.mp4

Điểm cuối nội dung trả về luồng video. Hãy lưu trữ nó kịp thời vì URL kết quả có thể hết hạn.

Nhiệm vụ thất bại

Quá trình tạo có thể trả về ID nhiệm vụ trước khi quá trình xác thực nhà cung cấp kết thúc. Do đó, cuộc thăm dò sau này có thể thay đổi nhiệm vụ thành failed. Giữ ID yêu cầu khi điều tra lỗi. Đừng thử lại bằng cách âm thầm thay đổi phong bì yêu cầu sang một họ mẫu khác.