HappyHorse 1.0 T2V API

快马1.0 文生视频, 输入文本 → 视频, 720p/1080p

POST /v1/videos/generations

文生视频: 只给提示词即可。

请求参数

参数类型必填说明
modelstring要调用的模型名, 填模型广场里的名称。
durationinteger视频时长(秒)。⚠️ 必须放在**顶层**, 并与 input/parameters 里的实际取值保持一致 —— 只写在嵌套结构里我们读不到。
resolutionstring分辨率, 取 480p / 720p / 1080p。⚠️ 同样必须放在**顶层**, 并与 parameters.size 保持一致。
inputobject生成入参对象, 按上游原生格式原样透传(不做字段改写)。各用法的必填项见下方 input.* 说明。
parametersobject生成参数对象, 按上游原生格式原样透传。常用 size 指定像素尺寸: 480p→832*480 · 720p→1280*720 · 1080p→1920*1080。
aspect_ratiostring宽高比, 如 16:9 / 9:16。
waitbooleantrue=阻塞等结果(最长 60s), false/省略=立即返回 task_id 后自行轮询(推荐)。
callback_urlstring任务终态后回调该地址。
idempotency_keystring幂等键, 同一个键重复提交返回同一个任务, 不会重复计费。
input.promptstring提示词, 描述要生成的画面。
input.functionstringinput.function 可省略 —— 省略时按模型名自动推断; 传了就按你传的走。
parameters.sizestring像素尺寸, 如 1280*720。与顶层 resolution 保持一致。

请求示例

curl https://api.router.ai/v1/videos/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-t2v",
    "duration": 5,
    "resolution": "720p",
    "input": {
      "prompt": "一只橘猫在窗台上伸懒腰,阳光洒进来"
    },
    "parameters": {"size": "1280*720"}
  }'

接口通用说明: 提交视频任务