视频生成

先通过 GET /api/open/v1/media/models?mediaType=video 获取已验证模型，再调用 POST /api/open/v1/media/videos/jobs 创建任务。使用 GET /api/open/v1/media/videos/jobs/{jobId} 轮询供应商状态。

创建任务

curl https://fishaudio.org/api/open/v1/media/videos/jobs \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY" \
  -H "Idempotency-Key: video-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"SUV 沿环湖公路行驶","model":"veo3.1","seconds":8,"size":"720x1280"}'

参考图通过 references 数组提交，每项包含 role 与 url；可用角色为 start_frame、end_frame 和 reference。模型、尺寸、时长和参考图限制以媒体模型目录及 GET /api/openapi.json 为准。

计费与退款

视频任务创建时预扣 API 额度，不扣网站会员积分。供应商创建失败、任务落库失败、异步执行失败或超时都会按任务快照幂等退回 API 额度。

Idempotency-Key 为必填请求头，每次有意创建新任务时必须使用新值。使用同一个 key 重试会返回首次结果，不会重复创建任务或重复扣费。

查询任务

GET /api/open/v1/media/videos/jobs/{jobId}
Authorization: Bearer YOUR_API_KEY

客户端应保存任务 ID，并持续处理 pending、processing、completed 和 failed 状态。