Skip to main content

HappyHorse 接口格式 生视频

视频接口用于根据文本描述成图像，部分模型支持参考图及参考视频。通过 model 参数区分模型，input 数组可含 prompt控制模型视频生成。

项目说明
请求方法POST
接口地址https://api.taiha.cn/v1/video/generations
鉴权请求头 Authorization: Bearer
Model ID在模型广场对应模型详情中查看

文生视频模型​

万相-文生视频模型支持可生成最长15秒、分辨率为1080P的视频。

  • 基础能力：支持整数级视频时长（2～15 秒）、指定视频分辨率（480P/720P/1080P）、智能改写prompt、添加水印。
  • 音频能力：支持自动配音，或传入自定义音频文件，实现声画同步。（wan2.7/wan2.6/wan2.5）
  • 多镜头叙事：支持生成包含多个镜头的视频，在镜头切换的同时保持主体一致。（wan2.7/wan2.6）

模型能力​

制作多镜头视频​

支持模型：wan2.7系列、wan2.6系列模型。
功能介绍：模型可自动进行分镜切换，例如从全景切换到特写，制作MV等场景。

参数设置：

  • wan2.7：无需设置 shot_type，可以在 prompt 中用自然语言描述镜头结构（如使用时间戳分镜描述）。若 prompt 中未包含任何镜头结构描述，模型将分析语义内容，自行决策输出单镜头或多镜头视频。
  • wan2.6：shot_type 必须设为 "multi"，且 prompt_extend 必须设为 true（开启智能改写以优化分镜描述）。

请求示例​

POST /v1/video/generations
curl -X POST 'https://api.taiha.cn/v1/video/generations' \
-H 'Authorization: Bearer <API Key>' \
-H 'Content-Type: application/json' \
-d '{
    "model": "<Model ID>",
    "input" : {
        "prompt": "第1个镜头 大远景开篇，镜头从接近地面的低机位开始向前移动，镜头沿草原方向推进，同时向上移动，将视角从贴地逐渐抬升至略高位置，使猎豹从左侧进入画面并与前方逃窜的羚羊共同处于同一追逐路径中，建立清晰的前后空间关系。 第2个镜头 向下移动回到接近地面高度，并沿猎豹运动方向向右移动，与其保持侧向平行关系进行稳定跟随，主体始终处于画面中部偏左位置，背景产生连续横向位移效果，在这一阶段镜头运动保持稳定一段时间以强化速度感与空间连续性。 第3个镜头 在维持向右移动的同时，沿猎豹运动路径内侧做小幅弧线移动，使画面产生轻微绕行变化但始终保持与主体同向。 第4个镜头 逐渐减缓横向移动速度并过渡为机位相对稳定，同时执行变焦推进，将视觉焦点逐步压缩至猎豹与羚羊之间不断缩短的距离上。 第5个镜头 再次向前移动并轻微向下移动，贴近地面逼近两者之间的空间，在猎豹前肢逼近羚羊后方的临界位置停住，形成强烈压迫感与张力，同时配合逐渐增强的交响配乐、持续加密的鼓点、风声与踏地声推进节奏，并在最后阶段压低音乐仅保留环境声与节奏声形成短暂停顿。"
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "prompt_extend": true,
        "watermark": true,
        "duration": 15
    }
}'
note

请求后并不会立即返回生成内容，耗时取决于prompt复杂程度及分辨率等要求，通常需要100秒左右。您可以通过任务查询接口获取生成进度及结果。

参数说明​

model 　string　必填　|　模型ID

  • 模型ID，请按照模型广场中模型所示名称填写，区分大小写。
  • 您也可以通过请求端点models来获得所有可请求的模型列表。

input 　array　必填　|　输入内容

prompt 　string　必填　|　提示词

描述需要生成的视频内容具体要求

audio_url 　string　可选　|　音频链接

可要求视频生成时，按照传入的音频链接进行配乐或者配音

parameters 　array　必填　|　生成要求

resolution 　string　可选　|　分辨率

可要求视频的分辨率，如：480P/720P/1080P，模型支持的分辨率可查看具体文档

ratio 　string　可选　|　画面比例

可要求视频的画面比例，如：16:9，模型支持的比例可查看具体文档

prompt_extend 　boolean　可选　|　提示词优化

默认不开启，开启后模型会先对提示词进行优化，该操作会增加生成时长月3-5秒，对于提示词比较具体的请求不建议开启

watermark 　boolean　可选　|　水印

默认开启，开启后生成的视频会出现AI生成的提示水印

duration 　integer　必填　|　视频时长

控制视频生成的时长，以秒为单位，模型支持的最大生成时长可查看具体文档

返回格式​

{
    "id" : "task_YvS3Wuau3aYnhJZYcaFwNlLd8NqkUIeo",
    "task_id" : "task_YvS3Wuau3aYnhJZYcaFwNlLd8NqkUIeo",
    "object" : "video",
    "model" : "happyhorse-1.1-t2v",
    "status" : "queued",
    "progress" : 0,
    "created_at" : 1785161936
}

查询结果​

步骤1：创建任务获取任务ID

通过接口返回参数中的task_id获得任务ID进行查询

步骤2：根据任务ID获取结果

将TASK_ID完整替换为上一步接口返回的task_id的值。task_id查询有效期为24小时。

curl -X GET "https://token.taiha.cn/v1/video/generations/<TASK_ID>"
-H "Authorization: Bearer <Model ID>"

输出示例​

{
    "code": "success",
    "message": "",
    "data": {
        "id": 20,
        "created_at": 1785161936,
        "updated_at": 1785162042,
        "task_id": "task_YvS3Wuau3aYnhJZYcaFwNlLd8NqkUIeo",
        "action": "generate",
        "status": "SUCCESS",
        "fail_reason": "",
        "result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/91/20260727/8fe28795/50976025-metadata_video_720p_4e200a08-0440-419b-93cf-a32e4957e6c4_refiner_watermark.mp4?Expires=1785248437\u0026OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1\u0026Signature=v0IwJwMFMkhO%2FHqQ2koqhrGcnPI%3D",
        "submit_time": 1785161936,
        "start_time": 1785161946,
        "finish_time": 1785162042,
        "progress": "100%",
        "properties": {
            "input": "",
            "upstream_model_name": "happyhorse-1.1-t2v",
            "origin_model_name": "happyhorse-1.1-t2v"
        },
        "data": {
            "usage": {
                "SR": 720,
                "duration": 5,
                "video_count": 1,
                "input_video_duration": 0,
                "output_video_duration": 5
            },
            "output": {
                "task_id": "4e200a08-0440-419b-93cf-a32e4957e6c4",
                "end_time": "2026-07-27 22:20:39.186",
                "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/91/20260727/8fe28795/50976025-metadata_video_720p_4e200a08-0440-419b-93cf-a32e4957e6c4_refiner_watermark.mp4?Expires=1785248437\u0026OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1\u0026Signature=v0IwJwMFMkhO%2FHqQ2koqhrGcnPI%3D",
                "orig_prompt": "第1个镜头 大远景开篇，镜头从接近地面的低机位开始向前移动，镜头沿草原方向推进，同时向上移动，将视角从贴地逐渐抬升至略高位置，使猎豹从左侧进入画面并与前方逃窜的羚羊共同处于同一追逐路径中，建立清晰的前后空间关系。 第2个镜头 向下移动回到接近地面高度，并沿猎豹运动方向向右移动，与其保持侧向平行关系进行稳定跟随，主体始终处于画面中部偏左位置，背景产生连续横向位移效果，在这一阶段镜头运动保持稳定一段时间以强化速度感与空间连续性。 第3个镜头 在维持向右移动的同时，沿猎豹运动路径内侧做小幅弧线移动，使画面产生轻微绕行变化但始终保持与主体同向。 第4个镜头 逐渐减缓横向移动速度并过渡为机位相对稳定，同时执行变焦推进，将视觉焦点逐步压缩至猎豹与羚羊之间不断缩短的距离上。 第5个镜头 再次向前移动并轻微向下移动，贴近地面逼近两者之间的空间，在猎豹前肢逼近羚羊后方的临界位置停住，形成强烈压迫感与张力，同时配合逐渐增强的交响配乐、持续加密的鼓点、风声与踏地声推进节奏，并在最后阶段压低音乐仅保留环境声与节奏声形成短暂停顿。",
                "submit_time": "2026-07-27 22:18:55.984",
                "task_status": "SUCCEEDED",
                "scheduled_time": "2026-07-27 22:18:56.042"
            },
            "request_id": "5a336216-5807-95cd-b3e8-9ad2ee4de335"
        }
    }
}

任务状态

  • queued: 排队中
  • in_progress: 生成中
  • completed: 已完成
  • failed: 失败

模型能力​

模型ID适用场景最大分辨率最大时长
happyhorse-1.1-t2v文生视频720P, 1080P3-15秒
wan2.7-t2v-2026-06-12文生视频，自定义音频文件720P, 1080P2-15秒
happyhorse-1.1-i2v首帧生视频720P, 1080P3-15秒
wan2.7-i2v-2026-04-25首帧生视频、首尾帧生视频、视频续写720P, 1080P2-15秒
happyhorse-1.1-r2v参考图像生视频720P, 1080P3-15秒
wan2.7-r2v-2026-06-12参考图像和视频生视频720P, 1080P2-10秒
happyhorse-1.0-video-edit视频编辑720P, 1080P3-15秒
wan2.7-videoedit视频编辑、特效复刻、运镜复刻720P, 1080P2-10秒
wan2.2-animate-move动作迁移到静态人物720P2-30秒
wan2.2-animate-mix视频中替换人物720P2-30秒