HappyHorse 1.1 Reference-to-Video Spicy

HappyHorse 1.1 Reference-to-Video Spicy（高动态/高表现力版）是阿里巴巴推出的HappyHorse 系列衍生大模型。在继承多图参考主体锁定与音画同步能力的基础上，Spicy模式是无审查模式且针对高强度动作、激进运镜、强视觉冲击与夸张特效进行了深度微调。模型能够基于参考图驱动大幅度、高张力的动作姿态演变与复杂镜头调度，原生支持多语言角色口型对齐与环境音效，广泛适用于高能动作短剧、爆款短视频、游戏 CG 动效与强视觉商业广告制作。

HappyHorse 1.1 Reference-to-Video Spicy

HappyHorse 1.1 Reference-to-Video 是阿里巴巴推出的新一代 AI 角色与多图参考生视频大模型。模型支持上传 1–9 张参考图（涵盖角色形象、服装道具、产品外观与场景风格），实现高精度的多图融合与主体锁定，有效解决跨镜头画面漂移问题。可生成 720P/1080P 原生高清视频，最长支持 15 秒渲染。

Base URL

https://api.icreat.ai

认证

所有 API 请求需要通过 API Key 进行认证。您可以在控制台获取 API Key。

export ICREAT_API_KEY="your-api-key-here"

HTTP 请求头

import os

API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + API_KEY,
}

保护好您的 API Key

切勿在客户端代码或公开仓库中暴露您的 API Key。请使用环境变量或后端代理。

代码示例

图片/视频生成采用三段式异步调用：先提交任务获取 task_id，再轮询任务状态，最后在状态为 SUCCEEDED 时获取生成结果。以下示例使用同一 task_id 串联三个步骤。

1. 提交任务

向提交接口发送生成请求。

POST/v1/task/submit/ali/happyhorse-1-1/reference-to-video-spicy

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/ali/happyhorse-1-1/reference-to-video-spicy \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "一只正在奔跑的小猫",
      "media": [
        {
          "type": "reference_image",
          "url": "https://icreat.ai/xxx.jpg"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "watermark": false
    }
  }'

2. 轮询状态

使用 task_id 查询任务进度。响应体仅包含 status 字段。

POST/v1/task/query-status

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/query-status" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "task-xxx"
  }'

3. 获取结果

任务成功后拉取最终输出。

POST/v1/task/get-result

curl --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/get-result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "task-xxx"
  }'

输入参数

提交任务 — 输入参数

以下参数在提交任务请求体中被接受。

总计: 2 必填: 2 可选: 0

inputobject必填

生成任务的输入内容。

:::

parametersobject必填

生成参数。

轮询状态 — 输入参数

总计: 1 必填: 1 可选: 0

task_idstring必填

提交任务接口返回的任务 ID。

获取结果 — 输入参数

总计: 1 必填: 1 可选: 0

task_idstring必填

提交任务接口返回的任务 ID。

输出参数

提交任务 — 输出参数

总计: 1

task_idstring

提交任务接口返回的任务 ID。

轮询状态 — 输出参数

总计: 1

statusstring

当前任务状态。当状态为 SUCCEEDED 时可获取结果。

获取结果 — 输出参数

响应体为资源对象数组（array[object]）。

总计: 3

typestring

资源类型，视频模型为 Video。

urlstring

预览/访问 URL。

download_urlstring

下载 URL。

LLM友好的提示词

以下是一段 LLM 友好的 Markdown 提示词，可复制到 Cursor、ChatGPT 等 AI 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程与关键参数。点击「复制LLM提示词」按钮或下方代码块均可复制全文。

# ali/happyhorse-1-1/reference-to-video-spicy

> HappyHorse 1.1 Reference-to-Video 是阿里巴巴推出的新一代 AI 角色与多图参考生视频大模型。

## 概述

通过 iCreat 三段式异步任务 API 提交生成请求，轮询任务状态后在成功时获取视频资源 URL。

## API 信息

- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint (POST)**：`/v1/task/submit/ali/happyhorse-1-1/reference-to-video-spicy`
- **Poll endpoint (POST)**：`/v1/task/query-status`
- **Get result endpoint (POST)**：`/v1/task/get-result`
- **Model ID**：`ali/happyhorse-1-1/reference-to-video-spicy`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **Submit**：POST submit 路径，Body 见输入要点；响应 `{ "task_id": "..." }`
2. **Poll**：POST `/v1/task/query-status`，Body `{ "task_id": "..." }`；响应**仅** `{ "status": "SUBMITTED|SUCCEEDED|FAILED" }`
3. **Get result**：`status` 为 `SUCCEEDED` 时 POST `/v1/task/get-result`；响应为顶层数组，`type` 为 `Video` 时读取 `url` 或 `download_url`

### 输入要点

- 请求体顶层：`input`（object）+ `parameters`（object），二者为同级字段
- `input.prompt`（必填）：描述要生成视频的提示词。
- `input.negative_prompt`（可选）：描述不应出现在视频中的内容。
- `parameters.resolution`（必填）：视频分辨率。
- `parameters.ratio`（必填）：视频宽高比。
- `parameters.duration`（必填）：视频时长（秒）。
- `parameters.watermark`（可选）：是否添加水印。

### 输出要点

- 轮询：只看 `status`
- 结果：顶层 `[{ "type": "Video", "url": "...", "download_url": "..." }]`

## 注意事项

- 三段式须用同一 `task_id` 串联；不可跳过轮询
- `FAILED` 为终态，需排查请求参数或参考内容
- Submit 请求体中 `input` 与 `parameters` 为同级字段，不可嵌套混淆