Alibaba Happy Horse 1.1 reference to video API | 定价与文档

alibaba/happyhorse-1.1/reference-to-video

向 Happy Horse 1.1 reference to video 提供最多 9 张参考图和一条提示词，即可生成 3-15 秒的 720P/1080P 视频，在保持参考主体、风格和身份特征稳定的同时呈现流畅动作。

1. 快速开始

使用 RunComfy 的 API 运行 alibaba/happyhorse-1.1/reference-to-video。可接受的输入与输出请参阅模型的数据结构说明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

2. 身份验证

将 YOUR_API_TOKEN 环境变量设置为您的 API 密钥（在个人资料中管理密钥），并在每个请求的 Authorization 标头中以 Bearer 令牌形式携带： Authorization: Bearer $YOUR_API_TOKEN。

3. API 参考

提交请求

提交异步生成任务，将立即获得 request_id 以及用于查询状态、获取结果和取消的 URL。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

查询请求状态

根据 request_id 获取当前状态（"in_queue"、"in_progress"、"completed" 或 "cancelled"）。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

获取请求结果

获取指定 request_id 的最终输出与元数据；若任务未完成，响应会返回当前状态，便于继续轮询。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

取消请求

通过 request_id 取消排队中的任务；进行中的任务无法取消。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 文件输入

托管文件（URL）

请提供可公网访问的 HTTPS 地址。确保目标主机允许服务端拉取（无需登录或 Cookie）、未被限流或拦截爬虫。建议：图片 ≤ 50 MB（约 4K），视频 ≤ 100 MB（约 720p 下 2–5 分钟）。私有资源请使用稳定或预签名 URL。

5. 数据结构

输入结构

{
  "type": "object",
  "title": "输入结构",
  "required": [
    "image_url_1",
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "提示词",
      "description": "描述希望围绕参考图构建的场景、动作、镜头运动和氛围。非中文最多 5000 个字符，中文最多 2500 个字符（超出部分将被截断）。",
      "type": "string",
      "default": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit.",
      "maxLength": 5000
    },
    "ratio": {
      "title": "宽高比",
      "description": "生成视频的宽高比。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "时长",
      "description": "输出视频的时长，以秒为单位。可选值：3-15。",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "image_url_1": {
      "title": "参考图 1",
      "description": "主要参考图，用其主体、风格或构图引导视频生成。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp"
    },
    "image_url_2": {
      "title": "参考图 2",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_3": {
      "title": "参考图 3",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_4": {
      "title": "参考图 4",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_5": {
      "title": "参考图 5",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_6": {
      "title": "参考图 6",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_7": {
      "title": "参考图 7",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_8": {
      "title": "参考图 8",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_9": {
      "title": "参考图 9",
      "description": "可选的附加参考图。最多可组合使用 9 张参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "resolution": {
      "title": "分辨率",
      "description": "输出视频的分辨率。Happy Horse 1.1 reference to video 支持 720P 或 1080P。",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "seed": {
      "title": "种子",
      "description": "可选的随机种子，用于提高生成结果的可复现性。设为 0 时由提供方随机选择。",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "default": 0
    },
    "watermark": {
      "title": "水印",
      "description": "是否在生成的视频中保留提供方水印。",
      "type": "boolean",
      "default": false
    }
  }
}

输出结构

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "单张图片 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "单个视频 URL"
      },
      "images": {
        "type": "array",
        "description": "多张图片 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "多个视频 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy 是首选的 ComfyUI 平台，提供 ComfyUI 在线环境和服务，以及 ComfyUI 工作流具有惊艳的视觉效果。 RunComfy还提供 AI Models, 帮助艺术家利用最新的AI工具创作出令人惊叹的艺术作品。

1. 快速开始

使用 RunComfy 的 API 运行 alibaba/happyhorse-1.1/reference-to-video。可接受的输入与输出请参阅模型的数据结构说明。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

3. API 参考

提交请求

提交异步生成任务，将立即获得 request_id 以及用于查询状态、获取结果和取消的 URL。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/alibaba/happyhorse-1.1/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_url_1": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp",
    "prompt": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit."
  }'

查询请求状态

根据 request_id 获取当前状态（"in_queue"、"in_progress"、"completed" 或 "cancelled"）。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

获取请求结果

获取指定 request_id 的最终输出与元数据；若任务未完成，响应会返回当前状态，便于继续轮询。

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

取消请求

通过 request_id 取消排队中的任务；进行中的任务无法取消。

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. 文件输入

托管文件（URL）

5. 数据结构

输入结构

{
  "type": "object",
  "title": "输入结构",
  "required": [
    "image_url_1",
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "提示词",
      "description": "描述希望围绕参考图构建的场景、动作、镜头运动和氛围。非中文最多 5000 个字符，中文最多 2500 个字符（超出部分将被截断）。",
      "type": "string",
      "default": "The referenced woman walks slowly through a sunlit modern art gallery, tall windows casting soft golden light across white walls, her trench coat moving gently with each step, calm confident expression, faint ambient murmur and distant footsteps. Cinematic slow dolly-in, shallow depth of field, premium photoreal look, identity-stable face and outfit.",
      "maxLength": 5000
    },
    "ratio": {
      "title": "宽高比",
      "description": "生成视频的宽高比。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "时长",
      "description": "输出视频的时长，以秒为单位。可选值：3-15。",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "image_url_1": {
      "title": "参考图 1",
      "description": "主要参考图，用其主体、风格或构图引导视频生成。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7373/media-files/ref-promo.webp"
    },
    "image_url_2": {
      "title": "参考图 2",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_3": {
      "title": "参考图 3",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_4": {
      "title": "参考图 4",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_5": {
      "title": "参考图 5",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_6": {
      "title": "参考图 6",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_7": {
      "title": "参考图 7",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_8": {
      "title": "参考图 8",
      "description": "可选的附加参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "image_url_9": {
      "title": "参考图 9",
      "description": "可选的附加参考图。最多可组合使用 9 张参考图。格式：JPEG、JPG、PNG 或 WEBP。",
      "type": "string",
      "default": ""
    },
    "resolution": {
      "title": "分辨率",
      "description": "输出视频的分辨率。Happy Horse 1.1 reference to video 支持 720P 或 1080P。",
      "type": "string",
      "enum": [
        "720P",
        "1080P"
      ],
      "default": "1080P"
    },
    "seed": {
      "title": "种子",
      "description": "可选的随机种子，用于提高生成结果的可复现性。设为 0 时由提供方随机选择。",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "default": 0
    },
    "watermark": {
      "title": "水印",
      "description": "是否在生成的视频中保留提供方水印。",
      "type": "boolean",
      "default": false
    }
  }
}

输出结构

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "单张图片 URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "单个视频 URL"
      },
      "images": {
        "type": "array",
        "description": "多张图片 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "多个视频 URL",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

向 Happy Horse 1.1 reference to video 提供最多 9 张参考图和一条提示词，即可生成 3-15 秒的 720P/1080P 视频，在保持参考主体、风格和身份特征稳定的同时呈现流畅动作。

目录

1. 快速开始

2. 身份验证

3. API 参考

提交请求

查询请求状态

获取请求结果

取消请求

4. 文件输入

托管文件（URL）

5. 数据结构

输入结构

输出结构

向 Happy Horse 1.1 reference to video 提供最多 9 张参考图和一条提示词，即可生成 3-15 秒的 720P/1080P 视频，在保持参考主体、风格和身份特征稳定的同时呈现流畅动作。

目录

1. 快速开始

2. 身份验证

3. API 参考

提交请求

查询请求状态

获取请求结果

取消请求

4. 文件输入

托管文件（URL）

5. 数据结构

输入结构

输出结构

Happy Horse 1.1 reference to video：参考素材驱动的视频生成模型与 API | RunComfy

向 Happy Horse 1.1 reference to video 提供最多 9 张参考图和一条提示词，即可生成 3-15 秒的 720P/1080P 视频，在保持参考主体、风格和身份特征稳定的同时呈现流畅动作。

目录

1. 快速开始

2. 身份验证

3. API 参考

提交请求

查询请求状态

获取请求结果

取消请求

4. 文件输入

托管文件（URL）

5. 数据结构

输入结构

输出结构

Happy Horse 1.1 reference to video：参考素材驱动的视频生成模型与 API | RunComfy

向 Happy Horse 1.1 reference to video 提供最多 9 张参考图和一条提示词，即可生成 3-15 秒的 720P/1080P 视频，在保持参考主体、风格和身份特征稳定的同时呈现流畅动作。

目录

1. 快速开始

2. 身份验证

3. API 参考

提交请求

查询请求状态

获取请求结果

取消请求

4. 文件输入

托管文件（URL）

5. 数据结构

输入结构

输出结构