视频生成

视频统一使用异步任务。提交到 POST /v1/videos 后保存 SourcesData task_xxx，再通过统一任务接口查询和下载，不要把提交请求保持到生成完成。

创建任务

curl --fail-with-body --silent --show-error \
  "$SOURCESDATA_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $SOURCESDATA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-fast",
    "prompt": "A paper boat drifting through a rain puddle, cinematic close-up",
    "seconds": 4,
    "size": "1280x720"
  }' | jq .

不同模型的时长、分辨率、画幅、音轨和参考素材规则不同。使用模型页声明的能力，不要假设所有视频模型共享同一组参数。

参考素材

远程参考素材可在 JSON 中使用模型支持的 URL 字段。本地文件使用 multipart/form-data 的 input_reference 上传；具体素材类型与数量以模型页和接口校验为准。

curl --fail-with-body --silent --show-error \
  "$SOURCESDATA_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $SOURCESDATA_API_KEY" \
  -F 'model=seedance-2.0-fast' \
  -F 'prompt=Animate the subject with subtle natural motion' \
  -F 'seconds=4' \
  -F 'size=1280x720' \
  -F '[email protected]' | jq .

查询与下载

按异步任务轮询 GET /v1/videos/{task_id}。完成后使用带 API Key 的 /v1/videos/{task_id}/content 下载；该接口支持 HEAD、Range、206 和 416，适合大文件探测和断点续传。

完整自动轮询脚本：examples/bash/async-media.sh。