立即注册

百炼视频 · HappyHorse

百炼视频 · HappyHorse 系列

适用 modelKey：

modelKey能力
happyhorse-1.0-t2v文生视频
happyhorse-1.0-i2v图生视频（首帧）
happyhorse-1.0-r2v参考生视频
happyhorse-1.0-video-edit视频编辑

百炼侧通常需 加白 后可用；以 GET /v1/models 返回为准。

推荐接入

平台异步任务 API（视频）

示例（文生视频）

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

TASK=$(curl -s -X POST "$API_BASE_URL/api/ai/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "happyhorse-1.0-t2v",
    "callbackId": "hh-vid-001",
    "videoParams": {
      "prompt": "卡通风格的小马在草原上奔跑",
      "duration": 5,
      "resolution": "720p",
      "aspectRatio": "16:9"
    }
  }')
echo "$TASK"

TASK_ID=$(echo "$TASK" | jq -r .taskId)
curl -s "$API_BASE_URL/api/ai/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

status=completed 时从 resultUrlPublic 取视频地址。建议每 2~5 秒轮询，或使用 Webhook 回调。

平台入参

字段说明
videoParams.prompt提示词
videoParams.firstFrame图生视频（happyhorse-1.0-i2v）
videoParams.refImages参考生视频（happyhorse-1.0-r2v）
videoParams.duration / resolution / aspectRatio映射到 HH 的 duration / resolution / ratio
videoParams.extraParamsJson平台已支持的视频编辑指令等 HH 特有字段

完整字段见 平台异步任务 API（视频）。

平台字段映射

extraParamsJson 必须是 JSON 字符串；当前平台会解析为对象后按模型能力映射：

场景支持字段
happyhorse-1.0-t2vratio、duration、resolution、seed、watermark
happyhorse-1.0-i2vfirstFrame 或 refImages[0] 作为首帧；支持 duration、resolution、seed、watermark
happyhorse-1.0-r2vrefImages 或 extraParamsJson.media（1–9 张参考图）；支持 ratio、duration、resolution、seed、watermark
happyhorse-1.0-video-edit源视频用 extraParamsJson.sourceVideo / videoUrl / video_url 或 extraParamsJson.refVideos[0]；参考图用 refImages（最多 5 张）；支持 audio_setting / audioSetting、resolution、seed、watermark

平台默认 watermark=true；duration 默认 5 秒，并按当前实现限制在 3–15 秒。

平台出参

查单 status=completed 时从 resultUrlPublic 取视频 URL；Webhook 见 Webhook 回调。

厂商全量参数

文档路径
文生视频HappyHorse 文生视频
图生视频HappyHorse 图生视频
参考生视频HappyHorse 参考生视频
视频编辑HappyHorse 视频编辑

原生接口兼容

POST /bailian/api/v1/services/aigc/video-generation/video-synthesis，body 与 HH 对外文档一致，model 为 modelKey。