HappyHorse-文生视频

POST /api/v1/services/aigc/video-generation/video-synthesis — 输入文本提示词生成视频

HappyHorse 文生视频模型，输入文本提示词生成物理真实、运动流畅的视频。

支持的模型

模型	说明
`happyhorse-1.1-t2v`	1.1 代文生视频
`happyhorse-1.0-t2v`	1.0 代文生视频
`happyhorse-1.0-t2v-20260618`	1.0 代文生视频 · 20260618 快照版本

创建任务

POST/api/v1/services/aigc/video-generation/video-synthesis

curl https://api.modelsite.ai/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Authorization: Bearer $MODELSITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "input": {
      "prompt": "一只金色卷毛小狗在傍晚的海滩上奔跑，海浪拍打岸边，电影级光影"
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5
    }
  }'

请求体

字段	类型	说明
`model`	string（必填）	模型名，见上表
`input.prompt`	string（必填）	提示词。中文字符按 2 个字符计、其他按 1 个计，总预算 5000，超出报错
`parameters`	object（可选）	生成参数，见下表

parameters 参数

参数	类型	说明
`resolution`	string	分辨率档位：`480P` / `720P` / `1080P`（默认）。可售档位以该模型的价格配置为准，传未定价的档位会报 `InvalidParameter`
`ratio`	string	宽高比：`16:9`（默认）/ `9:16` / `1:1` / `4:3` / `3:4` / `4:5` / `5:4` / `9:21` / `21:9`
`duration`	integer	时长（秒），`[3, 15]` 的整数，默认 5
`watermark`	boolean	是否添加水印（右下角 "Happy Horse" 角标）。默认 `true`——不想要水印必须显式传 `false`
`seed`	integer	随机种子 `[0, 2147483647]`，相同 seed 不保证结果完全一致
`negative_prompt`	string	反向提示词

其他厂商参数也可写在 parameters 里原样透传，平台不做包装。

轮询与结果

GET/api/v1/tasks/{task_id}

curl "https://api.modelsite.ai/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $MODELSITE_API_KEY"

响应字段

字段	说明
`output.task_id`	任务 ID（与创建时返回的一致）
`output.task_status`	`PENDING` 排队 / `RUNNING` 处理中 / `SUCCEEDED` 成功 / `FAILED` 失败
`output.video_url`	生成视频的 URL，仅 `SUCCEEDED` 时返回，尽快下载转存
`output.code` / `output.message`	仅失败时返回，失败原因
`usage`	用量统计（时长、分辨率档位等），仅成功时计数
`request_id`	请求唯一标识，排查问题时请提供

状态流转：PENDING → RUNNING → SUCCEEDED / FAILED。

计费

按实际生成时长（秒）计费，resolution 档位影响单价；任务失败不计费。单价见模型页。

错误处理

创建阶段的参数错误立即返回 4xx，响应体为 {"code": "...", "message": "..."}（如 InvalidParameter）。任务进行中的失败通过轮询响应的 output.code / output.message 返回。通用错误码见错误处理。

HappyHorse-文生视频

支持的模型

创建任务

轮询与结果

计费

错误处理

本页内容