FishSpeech Docs
API Reference视频生成

视频生成

创建、查询和列出视频生成任务。

视频生成

视频接口使用异步任务模型。提交 prompt 和模型后,服务端创建任务并在完成后返回结果视频 URL。

创建任务

POST /v1/videos/tasks
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
  "prompt": "一段产品展示短片,镜头缓慢推进",
  "model": "kitta-video-v1",
  "aspectRatio": "16:9",
  "size": "720p",
  "duration": 5,
  "firstFrameUrl": "https://example.com/frame.png"
}

可选字段包括 seedlastFrameUrlreferenceImageUrls。具体模型、尺寸和时长以 GET /api/openapi.json 为准。

查询任务

GET /v1/videos/tasks/{taskId}
Authorization: Bearer YOUR_API_KEY

查询列表

GET /v1/videos/tasks?limit=20&offset=0&status=processing
Authorization: Bearer YOUR_API_KEY

成功任务会返回 resultVideoUrl;失败任务会返回 errorCodeerrorMessage

On this page