Skip to Content
视频生成Happyhorse

Happyhorse 系列

Video Tasks
创建任务POST /v1/videos
查询任务GET /v1/videos/{task_id}

视频生成是异步任务。创建任务后返回 id / task_id,需通过 GET /v1/videos/{task_id} 轮询结果。

素材图片 / 视频必须通过公网可访问 URL 提供。

调用示例

curl -X POST "https://api.example.com/v1/videos" \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -H "Content-Type: application/json" \ -d '{ "model": "happyhorse-1.0-t2v", "input": { "prompt": "一匹白色小马在草原上奔跑,阳光明媚,电影感镜头" }, "parameters": { "resolution": "720P", "duration": 5, "ratio": "16:9", "watermark": false } }'

任务响应

创建任务响应示例:

{ "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "model": "happyhorse-1.0-video-edit", "status": "queued", "created_at": 1779381684 }

任务完成响应示例(结果视频地址在 metadata.url):

{ "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "model": "happyhorse-1.0-video-edit", "status": "completed", "progress": 100, "metadata": { "url": "https://example.com/generated-video.mp4" }, "error": null }

接入说明

  • 状态包括 queued、in_progress、completed、failed、cancelled。
  • 素材 URL 必须公网可访问,应为图片或视频文件直链;不支持本地路径,不建议 base64,不要使用需登录 / Cookie / 内网访问的地址。
Last updated on