HappyHorse
1. 接口说明
所有视频生成能力（文生视频、图生视频、参考图生视频、视频编辑）均通过同一端点提交，由 model 字段区分具体能力：
http
POST /v1/videos2. 顶层请求参数
所有视频控制参数（水印、音频、随机种子等）必须放在 metadata 字段内，不能直接放在请求顶层。请求顶层仅接收以下字段：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 固定传 HappyHorse 映射模型名，如 happyhorse-1.0-i2v-720p |
prompt | string | 是 | 视频生成提示词 / 画面描述 |
input_reference | string | 是（图生视频） | 首帧图片 URL（公网可访问），用于图生视频 |
duration | int | 否 | 视频时长（秒），范围通常为 3~10 |
seconds | string | 否 | 时长另一种表达方式，按模型要求可选 |
size | string | 否 | 视频尺寸（如 1280*720）；分辨率主要由模型名后缀（-720p / -1080p）决定，无需传参 |
metadata | object | 否 | 所有视频控制参数放此处（见下表） |
注意：直接在顶层传
watermark / audio / seed / parameters等字段不会生效。请统一放入metadata。
3. metadata 控制参数
分辨率说明：分辨率通过调用不同模型来指定（模型名后缀
-720p/-1080p），无需传参。例如happyhorse-1.0-i2v-720p即 720P，happyhorse-1.0-i2v-1080p即 1080P。metadata 中没有resolution参数。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
watermark | bool | false（默认不添加） | 是否添加平台水印，如需水印请显式传 true |
audio | bool | 模型默认 | 是否生成音频，仅视频编辑（edit）任务支持 |
seed | int | 随机 | 随机种子，范围 0 ~ 2147483647，用于结果复现 |
metadata 请求示例
metadata 内容（JSON）：
json
{
"watermark": true,
"seed": 123456
}bash
curl --location --request POST 'https://neolink.com/api/v1/videos' \
--header 'Authorization: Bearer <API Key>' \
--form 'model="happyhorse-1.0-i2v-720p"' \
--form 'prompt="A calico cat playing a piano on stage"' \
--form 'input_reference="https://example.com/first_frame.png"' \
--form 'metadata={"watermark":true,"seed":123456}'python
import requests
url = "https://neolink.com/api/v1/videos"
headers = {
"Authorization": "Bearer <API Key>"
}
data = {
"model": (None, "happyhorse-1.0-i2v-720p"),
"prompt": (None, "A calico cat playing a piano on stage"),
"input_reference": (None, "https://example.com/first_frame.png"),
"metadata": (None, '{"watermark":true,"seed":123456}'),
}
response = requests.post(url, headers=headers, data=data)
print(response.status_code)
print(response.text)4. 文生视频（t2v）
http
POST /v1/videosbash
curl --location --request POST 'https://neolink.com/api/v1/videos' \
--header 'Authorization: Bearer <API Key>' \
--form 'model="<Model ID>"' \
--form 'prompt="A calico cat playing a piano on stage"' \
--form 'duration="4"' \
--form 'ratio="16:9"' \
--form 'metadata={"watermark":true,"seed":123456}'python
import requests
url = "https://neolink.com/api/v1/videos"
headers = {
"Authorization": "Bearer <API Key>"
}
data = {
"model": (None, "<Model ID>"),
"prompt": (None, "A calico cat playing a piano on stage"),
"duration": (None, "4"),
"ratio": (None, "16:9"),
"metadata": (None, '{"watermark":true,"seed":123456}'),
}
response = requests.post(url, headers=headers, data=data)
print(response.status_code)
print(response.text)支持模型Id：
- happyhorse-1.0-t2v-720p
- happyhorse-1.0-t2v-1080p
- happyhorse-1.1-t2v-720p
- happyhorse-1.1-t2v-1080p
5. 图生视频（i2v）
http
POST /v1/videosbash
curl --location --request POST 'https://neolink.com/api/v1/videos' \
--header 'Authorization: Bearer <API Key>' \
--form 'model="<Model ID>"' \
--form 'prompt="A calico cat playing a piano on stage"' \
--form 'duration="4"' \
--form 'input_reference="xxx.png"' \
--form 'metadata={"watermark":true,"seed":123456}'python
import requests
url = "https://neolink.com/api/v1/videos"
headers = {
"Authorization": "Bearer <API Key>"
}
data = {
"model": (None, "<Model ID>"),
"prompt": (None, "A calico cat playing a piano on stage"),
"duration": (None, "4"),
"input_reference": (None, "xxx.png"),
"metadata": (None, '{"watermark":true,"seed":123456}'),
}
response = requests.post(url, headers=headers, data=data)
print(response.status_code)
print(response.text)支持模型Id：
- happyhorse-1.0-i2v-720p
- happyhorse-1.0-i2v-1080p
- happyhorse-1.1-i2v-720p
- happyhorse-1.1-i2v-1080p
6. 参考图生视频（r2v）
http
POST /v1/videosbash
curl --location --request POST 'https://neolink.com/api/v1/videos' \
--header 'Authorization: Bearer <API Key>' \
--form 'model="<Model ID>"' \
--form 'prompt="[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。"' \
--form 'duration="3"' \
--form 'ratio="9:16"' \
--form 'input_reference="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg,https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"' \
--form 'metadata={"watermark":true,"seed":123456}'python
import requests
url = "https://neolink.com/api/v1/videos"
headers = {
"Authorization": "Bearer <API Key>"
}
data = {
"model": (None, "<Model ID>"),
"prompt": (None, "[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。"),
"duration": (None, "3"),
"ratio": (None, "9:16"),
"input_reference": (None, "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg,https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"),
"metadata": (None, '{"watermark":true,"seed":123456}'),
}
response = requests.post(url, headers=headers, data=data)
print(response.status_code)
print(response.text)支持模型Id：
- happyhorse-1.0-r2v-720p
- happyhorse-1.0-r2v-1080p
- happyhorse-1.1-r2v-720p
- happyhorse-1.1-r2v-1080p
7. 视频编辑（edit）
http
POST /v1/videosbash
curl --location --request POST 'https://neolink.com/api/v1/videos' \
--header 'Authorization: Bearer <API Key>' \
--form 'model="<Model ID>"' \
--form 'prompt="A calico cat which is in this video playing a piano on stage"' \
--form 'input_reference="xxx.mp4"' \
--form 'metadata={"watermark":true,"audio":true,"seed":123456}'python
import requests
url = "https://neolink.com/api/v1/videos"
headers = {
"Authorization": "Bearer <API Key>"
}
data = {
"model": (None, "<Model ID>"),
"prompt": (None, "A calico cat which is in this video playing a piano on stage"),
"input_reference": (None, "xxx.mp4"),
"metadata": (None, '{"watermark":true,"audio":true,"seed":123456}'),
}
response = requests.post(url, headers=headers, data=data)
print(response.status_code)
print(response.text)支持模型Id：
- happyhorse-1.0-edit-720p
- happyhorse-1.0-edit-1080p