Happyhorse 系列
视频生成是异步任务。创建任务后返回 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
}
}'任务响应
创建任务响应示例:
JSON
{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"model": "happyhorse-1.0-video-edit",
"status": "queued",
"created_at": 1779381684
}任务完成响应示例(结果视频地址在 metadata.url):
JSON
{
"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