Seedance任務狀態及結果

Seedance 影片創作是異步的。建立請求返回任務ID；輪詢 Modelflare 直到任務完成或失敗。

支援的型號

創建任務

使用相符的模型頁面來取得完整的請求正文：

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"
  }'

保存回應中的 id。相容性響應可以使用task_id。

投票任務

bash

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

視訊提供者的公眾反應已標準化：

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}
  }
}

當status為queued或in_progress時輪詢。停在 completed 或 failed 處。

狀態	意義	下一步
queued	等待運行	再次投票
in_progress	處理	再次投票
completed	影片已準備好	下載內容
failed	任務失敗	讀取錯誤並修復請求

當服務回應包含它們時，metadata可以包含標準化動作、解析度、比率、輸出格式、音訊標誌和代幣使用。將這些欄位視為可選欄位；使用status和內容端點作為穩定合約。

下載結果

bash

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

內容端點返回視訊串流。及時儲存它，因為結果 URL 可能會過期。

任務失敗

建立可以在提供者驗證完成之前返回任務 ID。因此，稍後的輪詢可以將任務變更為 failed。調查錯誤時保留請求 ID。不要透過默默地將請求信封更改為另一個模型系列來重試。