HappyHorse 1.0

模型名称：happyhorse-1.0

面向标准视频池中的通用视频生成与镜头延展场景
default / standard 两个分组均可用，参数范围和请求体一致
提交成功后返回视频任务 ID
支持文生视频、首帧参考图生成和单参考视频生成
duration 支持 3 到 15 秒
aspect_ratio 支持 16:9、9:16、1:1、4:3、3:4
quality 支持 720P、1080P
当前页面展示平台稳定公共字段

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/videos

请求参数

字段	类型	必填	默认值	说明
`model`	`string`	是	-	固定传 `happyhorse-1.0`
`prompt`	`string`	是	-	视频生成提示词
`n`	`number`	否	`1`	当前仅支持传 `1`
`images`	`string[]`	否	-	参考图地址数组；单张按首帧处理，多张按参考图处理
`video_urls`	`string[]`	否	-	参考视频地址数组；当前公开协议最多传 `1` 条
`duration`	`number`	否	`3`	视频时长，支持 `3-15`
`aspect_ratio`	`string`	否	`16:9`	支持 `16:9`、`9:16`、`1:1`、`4:3`、`3:4`
`quality`	`string`	否	`720P`	清晰度档位，支持 `720P`、`1080P`
`audio_setting`	`object`	否	-	参考视频模式下的音频控制配置，按对象透传
`watermark`	`boolean`	否	`false`	是否保留水印
`seed`	`number`	否	`1`	随机种子，便于复现实验结果

参考视频最多 1 条；不支持 audio_urls、草稿、任务链和回调字段。

响应

提交成功响应示例：

{
  "id": "video_task_01KQEXAMPLE_HAPPYHORSE",
  "object": "video",
  "model": "happyhorse-1.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1711111111
}

提交失败响应示例：

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、duration、aspect_ratio、quality、images 或 video_urls 是否符合当前模型要求"
  }
}

任务查询接口

GET /v1/videos/{task_id}

查询成功示例：

{
  "id": "video_task_01KQEXAMPLE_HAPPYHORSE",
  "object": "video",
  "model": "happyhorse-1.0",
  "status": "completed",
  "progress": 100,
  "result_url": "https://example.com/result/happyhorse-10.mp4"
}

使用示例

文生视频

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0",
    "prompt": "生成一段商品展示镜头，主体在柔和灯光下旋转，背景层次干净",
    "n": 1,
    "duration": 5,
    "aspect_ratio": "16:9",
    "quality": "720P"
  }'

首帧参考图视频

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0",
    "prompt": "保留参考图中的主体结构和灯光氛围，生成一段短视频展示镜头",
    "n": 1,
    "images": [
      "https://example.com/reference-1.jpg"
    ],
    "duration": 5,
    "aspect_ratio": "9:16",
    "quality": "720P"
  }'

单参考视频生视频

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0",
    "prompt": "延续参考视频中的镜头运动，生成一段更利落的商品开场动画",
    "n": 1,
    "video_urls": [
      "https://example.com/reference-video.mp4"
    ],
    "duration": 8,
    "aspect_ratio": "16:9",
    "quality": "1080P",
    "audio_setting": {
      "volume": 0.5
    },
    "watermark": false,
    "seed": 20260704
  }'

注意事项

default / standard 两个分组使用相同参数能力，只需切换对应分组的 API Key。
对外请使用 images / video_urls 传入参考素材，并使用 aspect_ratio / quality 描述画面规格。
images、video_urls 建议单次只传一种参考来源；参考视频当前最多传 1 条。
audio_setting 当前只作为对象透传，不单独扩展成新的公共子字段。
页面优先展示当前稳定协议，不展开更多底层实现细节。
提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

异步状态与失败响应

视频任务状态只使用 queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口；只有 completed 状态才读取顶层 result_url。任务失败时保持视频对象结构，并返回顶层 error 与 fail_reason，不要按图片接口读取 code/data/works：

{
  "id": "video_task_01KQEXAMPLE_FAILED",
  "object": "video",
  "model": "happyhorse-1.0",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "task_failed",
    "message": "请求处理失败，请稍后重试"
  },
  "fail_reason": "请求处理失败，请稍后重试"
}

开始使用

图像模型

视频模型

文本模型

HappyHorse 1.0

请求鉴权

提交任务接口

请求参数

响应

任务查询接口

使用示例

文生视频

首帧参考图视频

单参考视频生视频

注意事项

异步状态与失败响应

​请求鉴权

​提交任务接口

​请求参数

​响应

​任务查询接口

​使用示例

​文生视频

​首帧参考图视频

​单参考视频生视频

​注意事项

​异步状态与失败响应

请求鉴权

提交任务接口

请求参数

响应

任务查询接口

使用示例

文生视频

首帧参考图视频

单参考视频生视频

注意事项

异步状态与失败响应