HappyHorse
HappyHorse 1.0 文生视频、图生视频与参考生视频
HappyHorse 1.0 用同一个入口覆盖三种任务类型：文生视频（t2v）、图生视频（i2v）、参考生视频（r2v），由 model 字段区分。
所有任务均为异步：提交后轮询任务状态，再下载结果。完整生命周期见「视频生成与查询」页。
模型一览
happyhorse-1.0-t2v — 文生视频。宽高比 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9；时长 3–15 秒。
happyhorse-1.0-i2v — 图生视频，传 1 张首帧图（input_reference）。宽高比自动跟随输入图像；时长 3–15 秒。
happyhorse-1.0-r2v — 参考生视频，传 1–9 张参考图。宽高比 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9；时长 3–15 秒。
提交生成任务
按请求体中的 model 字段路由到对应模型。
任务创建非幂等，视频路由禁用 failover 重试。
/v1/videos兼容别名POST/v1/video/generations请求
字段JSON 请求体。字段支持情况因任务类型而异，见各字段说明。
modelstringRequiredHappyHorse 模型名，决定任务类型。
happyhorse-1.0-t2vhappyhorse-1.0-i2vhappyhorse-1.0-r2vpromptstringOptional文本提示词，不超过 5000 个非中文字符或 2500 个中文字符。t2v 与 r2v 必填；i2v 可选。r2v 可按位置引用素材，如「[Image 1]」「[Image 2]」。
sizestringOptional分辨率档位，默认 1080P。
720P1080PdurationintegerOptional视频时长（秒），取值 3–15，默认 5。
input_referencestringOptionali2v 首帧图 URL（有且仅 1 张）。也可改用 metadata.input.media 传入。
metadataobjectOptional
HappyHorse 特有参数容器。
metadata.ratiostringOptionalt2v 与 r2v 的宽高比，默认 16:9。i2v 不使用该参数（输出比例跟随首帧图）。
16:99:161:14:33:44:55:49:2121:9metadata.watermarkbooleanOptional是否添加水印，默认 true。
metadata.seedintegerOptional随机种子，0–2147483647。
metadata.reference_typestringOptional仅 r2v：参考图的使用方式——subject（参考主体/人物）或 style（参考风格）。
subjectstylemetadata.input.media[]array<object>Optional
r2v 的参考媒体：1–9 项。i2v 也可在此传入单张首帧图，替代 input_reference。
media[].typestringOptional素材角色。
reference_imagevideofirst_framemedia[].urlstringOptional素材文件 URL。
响应
字段提交回执。字段平铺在 JSON 顶层（无 data 包装）。
idstringOptional任务 ID（task_xxx）。与 task_id 相同，供 OpenAI SDK 兼容使用。
task_idstringOptional任务 ID，用于后续轮询与下载。
objectstringOptional固定值 video。
modelstringOptional请求中传入的模型名。
statusstringOptional提交后初始状态，通常为 QUEUED。
SUBMITTEDQUEUEDIN_PROGRESSSUCCESSFAILUREprogressintegerOptional进度 0–100，刚提交时通常为 0。
created_atintegerOptional任务创建时间（秒级时间戳）。
图片素材（i2v 首帧 / r2v 参考图）：JPEG / JPG / PNG / WEBP，宽高均 ≥ 300 像素（r2v 推荐 720P 以上），文件 ≤ 10MB，宽高比 1:2.5–2.5:1。
典型耗时：t2v / i2v / r2v 约 100–150 秒。轮询总超时建议 5 分钟。
成功与业务失败均返回 HTTP 200。调用失败时响应体不含回执字段，而是携带 error 对象——{ "error": { "message", "type", "code" } }——请通过是否存在 error 字段区分。
查询与下载
轮询任务直到进入终态 SUCCESS 或 FAILURE（建议间隔 10–15 秒，不要低于 5 秒），然后下载结果。下载接口支持 Range 请求（HTTP 206），可断点续传、拖拽播放。
/v1/videos/{task_id}兼容别名GET/v1/video/generations/{task_id}/v1/videos/{task_id}/content响应
字段以下为核心字段。完整的任务详情字段、状态生命周期与轮询建议见「视频生成与查询」页。
statusstringOptional任务状态。
SUBMITTEDQUEUEDIN_PROGRESSSUCCESSFAILUREprogressstringOptional进度百分比字符串，如 "50%"。
result_urlstringOptional结果视频下载地址，仅 status 为 SUCCESS 时返回。形如 /v1/videos/{task_id}/content。
fail_reasonstringOptional失败原因，仅 status 为 FAILURE 时返回。