API 文档AI 模型接口视频HappyHorse

参考生视频

基于 1~9 张参考图生成视频。异步任务接口，提交后返回 task_id，需轮询任务状态获取结果。

基于 1~9 张参考图生成视频，prompt 中用 [Image N] 指代参考图。支持最长 15 秒、最高 1080P 分辨率。

异步任务型接口：提交后立即返回 task_id，需轮询任务状态，成功后再下载视频。

Base URL

  • https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Endpoints

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

创建视频生成任务

基于参考图创建视频生成任务。

请求头需设置 X-DashScope-Async: enable。

Request Body

Content-Type: application/json

Example:

{
  "model": "happyhorse-1.1-r2v",
  "input": {
    "prompt": "[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。",
    "media": [
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/fvuihk/hh-v2v2-folding-fan.jpg"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"
      }
    ]
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }
}

Properties:

NameTypeRequiredDescription
modelstringYes模型名称。可选值：happyhorse-1.1-r2v、happyhorse-1.0-r2v
inputobjectYes基础输入信息，如参考图像与提示词
input.promptstringYes文本提示词，用于描述期望生成的视频元素与画面特征。支持任何语言，长度不超过 5000 个非中文字符或 2500 个中文字符。请使用 [Image 1]、[Image 2] 等占位符指代 media 数组中的图像，编号与数组顺序一致（第 1 张对应 [Image 1]，以此类推）
input.mediaarrayYes参考图像媒体列表，可传入 1～9 张参考图。详见下方说明
input.media[].typestringYes媒体素材类型。固定值：reference_image
input.media[].urlstringYes参考图像 URL 或 Base64 编码数据。详见下方说明
parametersobjectNo视频处理参数，如分辨率、宽高比、时长等
parameters.resolutionstringNo分辨率档位。可选值：480P、720P、1080P（默认）
parameters.ratiostringNo宽高比。可选值：16:9（默认）、9:16、3:4、4:3、4:5、5:4、1:1、9:21、21:9
parameters.durationintegerNo视频时长（秒），取值 [3, 15] 之间的整数，默认 5
parameters.watermarkbooleanNo是否添加水印（右下角固定文案 "Happy Horse"）。true（默认）添加，false 不添加
parameters.seedintegerNo随机数种子，取值 [0, 2147483647]。未指定时系统自动生成。固定 seed 可提升可复现性，但不保证完全一致

inputobject（必选）

基础输入信息，如参考图像与提示词。

mediaarray（必选）

参考图像媒体列表，可传入 1～9 张参考图。数组中第 1 个 reference_image 对应 [Image 1]，第 2 个对应 [Image 2]，以此类推。

typestring（必选）

媒体素材类型。固定值：reference_image。

urlstring（必选）

参考图像 URL 或 Base64 编码数据。

图像限制：

  • 格式： JPEG、JPG、PNG、WEBP。
  • 分辨率： 图像的短边不小于 400 像素。建议使用 720P 及以上的高清图像，避免使用过小、模糊或过度压缩的图片，否则可能影响成片效果。
  • 文件大小： 不超过 20MB。

支持输入的格式：

  1. 公网 URL： 支持 HTTP 或 HTTPS 协议。示例值：https://xxx/xxx.jpg
  2. Base64 编码图像后的字符串： 数据格式为 data:{MIME_type};base64,{base64_data}。示例值：data:image/png;base64,GDU7MtCZzEbTbmRZ......

Responses

200: 成功创建任务

Content-Type: application/json

400: 请求参数错误

Content-Type: application/json

429: 请求频率限制

Content-Type: application/json

请求示例

curl -X POST "https://api.autorouter.top/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "X-DashScope-Async: enable" \
  -d '{
  "model": "happyhorse-1.1-r2v",
  "input": {
    "prompt": "[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。",
    "media": [
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/fvuihk/hh-v2v2-folding-fan.jpg"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"
      }
    ]
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }
}'

响应示例

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

响应字段说明：

NameTypeDescription
outputobject任务输出信息
output.task_idstring任务 ID，可用于查询任务状态，有效期 24 小时
output.task_statusstring任务状态。枚举值：PENDING（排队中）、RUNNING（处理中）、SUCCEEDED（成功）、FAILED（失败）、CANCELED（已取消）、UNKNOWN（不存在或状态未知）
request_idstring本次请求的唯一标识，用于追踪与排查问题
codestring错误码，仅请求失败时返回
messagestring错误信息，仅请求失败时返回

GET /api/v1/tasks/{task_id}

根据任务ID查询结果

根据创建任务时返回的 task_id 查询任务状态与结果。查询有效期 24 小时。

Headers

NameTypeRequiredDescription
AuthorizationstringYes请求身份认证。格式：Bearer sk-xxxxxx

Path Parameters

NameTypeRequiredDescription
task_idstringYes任务 ID

Responses

200: 成功查询任务

Content-Type: application/json

400: 请求参数错误

Content-Type: application/json

429: 请求频率限制

Content-Type: application/json

请求示例

curl -X GET "https://api.autorouter.top/api/v1/tasks/{task_id}" \
  -H "Authorization: Bearer sk-xxxxxx"

响应示例

{
  "request_id": "99243b47-ec5f-9413-9993-xxxxxx",
  "output": {
    "task_id": "4673458e-28be-4a05-bf2a-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-20 17:55:17.075",
    "scheduled_time": "2026-04-20 17:55:17.129",
    "end_time": "2026-04-20 17:56:36.658",
    "orig_prompt": "[Image 1]中身着红色旗袍的女性...",
    "video_url": "https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 720,
    "ratio": "16:9"
  }
}

响应字段说明：

NameTypeDescription
outputobject任务输出信息
output.task_idstring任务 ID，查询有效期 24 小时
output.task_statusstring任务状态。枚举值：PENDING（排队中）、RUNNING（处理中）、SUCCEEDED（成功）、FAILED（失败）、CANCELED（已取消）、UNKNOWN（不存在或状态未知）。轮询过程中状态流转一般为 PENDING → RUNNING → SUCCEEDED / FAILED
output.submit_timestring任务提交时间，格式 YYYY-MM-DD HH:mm:ss.SSS
output.scheduled_timestring任务执行时间，格式 YYYY-MM-DD HH:mm:ss.SSS
output.end_timestring任务完成时间，格式 YYYY-MM-DD HH:mm:ss.SSS
output.video_urlstring视频下载 URL，仅 task_status 为 SUCCEEDED 时返回。链接有效期 24 小时，视频为 MP4（H.264）
output.orig_promptstring原始提示词，对应请求参数 prompt
output.codestring错误码，仅任务失败时返回
output.messagestring错误信息，仅任务失败时返回
usageobject输出统计信息，仅成功时返回
usage.input_video_durationinteger输入视频时长（秒）
usage.output_video_durationinteger输出视频时长（秒）
usage.durationinteger用于计费的总视频时长（秒），值为 input_video_duration + output_video_duration
usage.SRinteger输出视频分辨率档位
usage.ratiostring生成视频的宽高比
usage.video_countinteger输出视频数量，固定为 1
request_idstring本次请求的唯一标识，用于追踪与排查问题

错误处理

HTTP 400 参数错误（提交前拦截，不扣费）

AutoRouter 在提交到上游前会对必填字段做基础校验：

场景响应
未传 input.prompt{"code":"InvalidParameter","message":"...","request_id":"..."}
未传 input.media 或参考图数量不在 1～9{"code":"InvalidParameter","message":"...","request_id":"..."}
未知模型名{"code":"InvalidParameter","message":"unknown model: ...","request_id":"..."}

HTTP 401 / 403 鉴权错误

  • 401 Unauthorized：API Key 无效或已过期
  • 403 Forbidden：API Key 无权访问此模型（检查 token 的模型白名单）

HTTP 402 余额不足

返回 insufficient user quota。请前往 AutoRouter 控制台充值。

任务 FAILED 状态

任务成功提交但上游生成失败（output.task_status == "FAILED"），常见原因见 output.code / output.message：

原因处理建议
内容审核失败调整 prompt，避免敏感内容
参考图缺失或数量非法media 中需包含 1～9 个 type: reference_image 元素
媒体 URL 不可访问确保 URL 公开可访问、未过期
媒体文件不符规格参考 Request Body 中图像限制
参数组合非法（如分辨率不支持）按 Request Body 规范传参

任务 FAILED 时 AutoRouter 会自动退款到你的账户，可在日志页面查询退款记录。

图生视频-基于首帧

以首帧图为起点按提示词生成视频。异步任务接口，提交后返回 task_id，需轮询任务状态获取结果。

视频编辑

对现有视频做风格变换、局部替换等编辑。异步任务接口，提交后返回 task_id，需轮询任务状态获取结果。

目录

Base URLAuthenticationEndpointsPOST /api/v1/services/aigc/video-generation/video-synthesisRequest BodyResponses请求示例响应示例GET /api/v1/tasks/{task_id}HeadersPath ParametersResponses请求示例响应示例错误处理HTTP 400 参数错误（提交前拦截，不扣费）HTTP 401 / 403 鉴权错误HTTP 402 余额不足任务 FAILED 状态