LoopToken
视频生成

HappyHorse 系列

HappyHorse 系列视频模型

适用模型

模型类型说明
happyhorse-1.0-t2v文生视频resolution + ratio 组合指定输出分辨率
happyhorse-1.0-i2v图生视频首帧图片驱动,宽高比跟随首帧
happyhorse-1.0-r2v参考生视频1-9 张参考图,[Image N] 标注引用
happyhorse-1.0-video-edit视频编辑专属参数待补充

实际可用模型以模型列表为准。HappyHorse 采用 150 亿参数单流 Transformer 架构,擅长生成物理真实、运动流畅的视频。

共同注意事项:水印参数默认 true(视频右下角 "Happy Horse" 文案),不想要水印需显式传 parameters.watermark: false;不支持 negative_prompt 与 prompt_extend。

调用方式

异步两步协议(提交 + 轮询)与接口说明一致:提交 POST /v1/videos/generations 返回 202 和平台任务对象,之后轮询平台的 GET /v1/tasks/{task_id}。

请求体为 DashScope 风格(input + parameters),不使用 content 数组与 --duration 文本指令。

文生视频(happyhorse-1.0-t2v)

参数类型必填说明
input.promptstring是视频描述文本,≤5000 非中文字符或 2500 中文字符
parameters.resolutionstring否720P / 1080P(默认)
parameters.ratiostring否宽高比,默认 16:9;支持 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9
parameters.durationint否3-15 秒,默认 5
parameters.watermarkbool否默认 true
parameters.seedint否[0, 2147483647]

resolution 和 ratio 组合确定最终输出分辨率:如 720P + 16:9 输出 1280×720,1080P + 9:16 输出 1080×1920。

{
  "model": "happyhorse-1.0-t2v",
  "input": {"prompt": "一座由硬纸板和瓶盖搭建的微型城市,在夜晚焕发出生机"},
  "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
}

图生视频(happyhorse-1.0-i2v)

基于首帧图片生成视频,可选文本提示词引导。

请求参数

参数类型必填说明
modelstring是happyhorse-1.0-i2v
input.mediaarray是有且仅有 1 个元素,type 固定为 first_frame,url 为首帧图片(公网 URL 或 Base64)
input.promptstring否文本提示词,任何语言,不超过 5000 非中文字符或 2500 中文字符,超出自动截断
parameters.resolutionstring否分辨率档位:720P / 1080P(默认);输出宽高比自动跟随首帧
parameters.durationint否视频时长,3-15 秒,默认 5
parameters.watermarkbool否默认 true
parameters.seedint否随机种子,[0, 2147483647]

不支持 ratio(宽高比跟随首帧,无需指定)。

首帧图片限制

限制项要求
格式JPEG / JPG / PNG / WEBP
最小分辨率宽和高均 ≥300 像素
宽高比1:2.5 ~ 2.5:1
文件大小≤20MB

Base64 格式为 data:{MIME_type};base64,{data}(如 data:image/png;base64,iVBORw0KGgo...);传 URL 时必须保证上游能直接下载到。

请求示例

curl https://api.looptoken.cc/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-i2v",
    "input": {
      "prompt": "一只猫在草地上奔跑,阳光明媚",
      "media": [
        {"type": "first_frame", "url": "https://example.com/cat.jpg"}
      ]
    },
    "parameters": {"resolution": "720P", "duration": 5, "watermark": false}
  }'

提交成功返回 202 与平台任务对象,完整轮询示例见接口说明。

参考生视频(happyhorse-1.0-r2v)

传入 1-9 张参考图像,结合文本提示词融合多张图片中的主体元素生成视频。

参数类型必填说明
input.promptstring是必须用 [Image N] 标注引用对应参考图中的主体(如 "[Image 1] 中身着红色旗袍的女性,抬手展开 [Image 2] 中的折扇")
input.mediaarray是1-9 个元素,type 固定为 reference_image,url 为参考图(公网 URL 或 Base64),编号按数组顺序对应 [Image N]
parameters.resolutionstring否720P / 1080P
parameters.ratiostring否宽高比,如 16:9
parameters.durationint否默认 5 秒
parameters.watermarkbool否默认 true
parameters.seedint否随机种子
{
  "model": "happyhorse-1.0-r2v",
  "input": {
    "prompt": "[Image 1] 中身着红色旗袍的女性,镜头先侧面拍摄,随后抬手展开 [Image 2] 中的折扇",
    "media": [
      {"type": "reference_image", "url": "https://example.com/girl.jpg"},
      {"type": "reference_image", "url": "https://example.com/fan.jpg"}
    ]
  },
  "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
}

计费

按"时长 × 分辨率档位单价"计费,价格见模型列表。注意:平台的预扣估算只读 parameters.duration 和 parameters.size(宽*高 格式),HappyHorse 用 parameters.resolution 指定档位时预扣按 720p 档计算,任务结束后按上游返回的实际档位(usage.SR)多退少补,以 credits_charged 为准。

错误

与接口说明一致,见错误码。

Wan 视频系列

通义 Wan 系列视频模型

错误码

错误码与排查说明

本页内容

适用模型调用方式文生视频(happyhorse-1.0-t2v)图生视频(happyhorse-1.0-i2v)请求参数首帧图片限制请求示例参考生视频(happyhorse-1.0-r2v)计费错误