happyhorse-1.0-r2v（多参考图生视频）

任务进度与结果查询见 使用说明。

说明

异步任务接口，用于提交 HappyHorse 参考图生视频任务，需传入 1 张或多张参考图片，具体生成进度与结果请通过任务查询接口获取。

请求地址

POST /open/v1/ai_creation/task/submit

Header

access_token: {{access_token}}
Content-Type: application/json

请求参数 Body

{
  "ref_img_url": [
    "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref1.jpg",
    "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref2.jpg"
  ],
  "ref_prompt": "保持马匹主体特征一致，让它在草原上迎风奔跑，镜头平稳推进，画面具有电影感",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 1080,
  "video_duration": 5,
  "model_code": "happyhorse-1.0-r2v"
}

参数说明

字段	类型	是否必传	示例	说明
ref_img_url	array<string>	是	["https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref1.jpg"]	参考图片 URL 列表，支持传入 1 张或多张图片
ref_prompt	string	是	保持马匹主体特征一致，让它在草原上迎风奔跑，镜头平稳推进，画面具有电影感	视频生成提示词
creation_type	int	是	4	创作类型，视频生成为 4
aspect_ratio	string	否	16:9	输出视频宽高比，常用 9:16、16:9、1:1
clarity	int	否	1080	输出清晰度，常用 720 或 1080
video_duration	int	是	5	视频时长（秒）（如 5、10）
model_code	string	是	happyhorse-1.0-r2v	模型编码，固定为 happyhorse-1.0-r2v

响应示例

{
  "trace_id": "96afa792520b0e6a86d72e89435bc0a7",
  "code": 0,
  "msg": "success",
  "data": "a60747d7-dc05-4afc-b2ef-ee4370ed53c6"
}

响应字段说明

字段	说明
code	响应状态码
msg	响应信息
trace_id	请求链路追踪 ID
data	提交的创作 ID

响应状态码说明

code	说明
0	响应成功
400	传入参数格式错误
10400	AccessToken 验证失败
40000	参数错误
40001	超出 QPS 限制
50000	系统内部错误

示例代码

cURL

curl --location --request POST 'https://www.chanjing.cc/open/v1/ai_creation/task/submit' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ref_img_url": [
        "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref1.jpg",
        "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref2.jpg"
    ],
    "ref_prompt": "保持马匹主体特征一致，让它在草原上迎风奔跑，镜头平稳推进，画面具有电影感",
    "creation_type": 4,
    "aspect_ratio": "16:9",
    "clarity": 1080,
    "video_duration": 5,
    "model_code": "happyhorse-1.0-r2v"
}'

Go

payload := strings.NewReader(`{
  "ref_img_url": [
    "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref1.jpg",
    "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref2.jpg"
  ],
  "ref_prompt": "保持马匹主体特征一致，让它在草原上迎风奔跑，镜头平稳推进，画面具有电影感",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 1080,
  "video_duration": 5,
  "model_code": "happyhorse-1.0-r2v"
}`)

Java

RequestBody body = RequestBody.create(mediaType, "{\n  \"ref_img_url\": [\n    \"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref1.jpg\",\n    \"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref2.jpg\"\n  ],\n  \"ref_prompt\": \"保持马匹主体特征一致，让它在草原上迎风奔跑，镜头平稳推进，画面具有电影感\",\n  \"creation_type\": 4,\n  \"aspect_ratio\": \"16:9\",\n  \"clarity\": 1080,\n  \"video_duration\": 5,\n  \"model_code\": \"happyhorse-1.0-r2v\"\n}");

Python

payload = json.dumps({
  "ref_img_url": [
    "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref1.jpg",
    "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref2.jpg"
  ],
  "ref_prompt": "保持马匹主体特征一致，让它在草原上迎风奔跑，镜头平稳推进，画面具有电影感",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 1080,
  "video_duration": 5,
  "model_code": "happyhorse-1.0-r2v"
})