跳转到内容
HiAPI Docs
HiAPI
中文
English 中文

HappyHorse 1.0

概览

Section titled “概览”
提供商阿里巴巴
模型名称happyhorse-1-0
主要端点/v1/videos
任务类型仅文生视频
返回形式先返回 id，再轮询结果
典型能力1080P 高清、3–15 秒灵活时长、五种比例、按秒计费

HappyHorse 1.0 是阿里巴巴推出的文生视频模型，一句提示词直出片段，适合短视频、广告分镜、社媒内容创作。

适用场景

Section titled “适用场景”
  • 短视频内容、抖音/小红书/Reels 素材
  • 广告分镜与产品短片
  • 社媒账号的快速内容产线
  • 横版/竖版/方形多版本一次性出片

端点

Section titled “端点”
  • POST /v1/videos
  • GET /v1/videos/{id}

关键参数

Section titled “关键参数”
参数类型说明
modelstring固定为 happyhorse-1-0
promptstring描述主体、动作、环境与光线
secondsstring可选 "3"、"5"、"8"、"10"、"15"
resolutionstring"720p" 或 "1080p"
sizestring"16:9"、"9:16"、"1:1"、"4:3"、"3:4"

HappyHorse 1.0 仅支持文生视频，不要传入图片输入。

请求示例

Section titled “请求示例”
Terminal window
curl -X POST https://api.hiapi.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1-0",
    "prompt": "一位武侠女剑客在黄昏时分纵身跃过寺庙屋脊，丝绸长袍慢镜头中飘扬，电影级 35mm 胶片质感",
    "seconds": "5",
    "resolution": "1080p",
    "size": "16:9"
  }'

响应示例

Section titled “响应示例”
{
  "id": "video_task_001",
  "object": "video",
  "status": "processing"
}

异步与轮询

Section titled “异步与轮询”

提交任务后，用 GET /v1/videos/{id} 轮询，直到顶层 status 变为 completed，再读取返回的视频 URL。

Terminal window
curl -X GET https://api.hiapi.ai/v1/videos/video_task_001 \
  -H "Authorization: Bearer YOUR_API_KEY"

常见错误

Section titled “常见错误”
  • 400 Bad Request：seconds、resolution 或 size 不在支持范围内。
  • 401 Unauthorized：API Key 无效或未设置。
  • 402 或额度不足：余额不足，需在 Dashboard 充值。
  • 429 Too Many Requests：并发过高，需要退避重试。
  • 任务失败：提示词不够清晰或场景过于复杂，建议简化后重试。

定价说明

Section titled “定价说明”

HappyHorse 1.0 按秒计费，实时价格请查看实时定价页。

Skill

Section titled “Skill”

已发布本地一键 Skill，适用于 Codex / Claude Code / OpenCode / OpenClaw：

下一步

Section titled “下一步”