happyhorse-1.0

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-t2v",
    "input": {"prompt": "夜色中的未来城市，镜头贴近地面快速向前推进"},
    "parameters": {
      "resolution": "720P",
      "ratio": "21:9",
      "duration": 3,
      "watermark": false,
      "seed": 0
    }
  }'

请求头

string

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

请求体格式。

请求体

string

required

使用 happyhorse-1.0-t2v。

object

required

文生视频输入。

string

required

视频内容描述。非中文最多 5,000 字符，中文最多 2,500 字符，超出部分自动截断。

object

输出控制参数。

string

default:"1080P"

可选值：720P、1080P。

string

default:"16:9"

可选值：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9。

integer

default:5

视频时长，3–15 秒。

boolean

default:true

是否添加水印。

integer

随机种子，范围为 0–2147483647。

创建响应

200

{
  "id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "happyhorse-1.0-t2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1785464914
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的模型 ID。

string

创建后的初始状态，固定为 queued。

integer

创建时的初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-i2v",
    "input": {
      "prompt": "镜头缓缓拉近，画面中的人物自然转头",
      "media": [
        {"type": "first_frame", "url": "https://example.com/first-frame.png"}
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 3,
      "watermark": false,
      "seed": 1
    }
  }'

请求头

string

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

请求体格式。

请求体

string

required

使用 happyhorse-1.0-i2v。

object

required

图生视频输入。

string

动作和镜头描述。非中文最多 5,000 字符，中文最多 2,500 字符，超出部分自动截断。

object[]

required

必须且只能包含 1 个首帧图片对象。

string

required

固定为 first_frame。

string

required

公网可下载的首帧图片 URL。

object

输出控制参数。图生视频不支持 ratio，输出比例跟随首帧。

string

default:"1080P"

可选值：720P、1080P。

integer

default:5

视频时长，3–15 秒。

boolean

default:true

是否添加水印。

integer

随机种子，范围为 0–2147483647。

创建响应

200

{
  "id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "happyhorse-1.0-i2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1785464914
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的模型 ID。

string

创建后的初始状态，固定为 queued。

integer

创建时的初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-r2v",
    "input": {
      "prompt": "让参考人物手持折扇走过灯火通明的长廊",
      "media": [
        {"type": "reference_image", "url": "https://example.com/person.jpg"},
        {"type": "reference_image", "url": "https://example.com/fan.jpg"},
        {"type": "reference_image", "url": "https://example.com/earrings.jpg"}
      ]
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "9:21",
      "duration": 3,
      "watermark": false,
      "seed": 2
    }
  }'

请求头

string

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

请求体格式。

请求体

string

required

使用 happyhorse-1.0-r2v。

object

required

参考生视频输入。

string

required

视频内容描述。非中文最多 5,000 字符，中文最多 2,500 字符，超出部分自动截断。

object[]

required

AnyFast 当前节点接受 1–3 张参考图片。

string

required

固定为 reference_image；不支持参考视频。

string

required

公网可下载的参考图片 URL。

object

输出控制参数。

string

default:"1080P"

可选值：720P、1080P。

string

default:"16:9"

可选值：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9。

integer

default:5

视频时长，3–15 秒。

boolean

default:true

是否添加水印。

integer

随机种子，范围为 0–2147483647。

创建响应

200

{
  "id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "happyhorse-1.0-r2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1785464914
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的模型 ID。

string

创建后的初始状态，固定为 queued。

integer

创建时的初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-video-edit",
    "input": {
      "prompt": "让视频中的角色穿上参考图片中的条纹毛衣",
      "media": [
        {"type": "video", "url": "https://example.com/source.mp4"},
        {"type": "reference_image", "url": "https://example.com/sweater.webp"}
      ]
    },
    "parameters": {
      "resolution": "720P",
      "watermark": false,
      "audio_setting": "origin",
      "seed": 2147483647
    }
  }'

请求头

string

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

请求体格式。

请求体

string

required

使用 happyhorse-1.0-video-edit。

object

required

视频编辑输入。

string

required

编辑指令。非中文最多 5,000 字符，中文最多 2,500 字符，超出部分自动截断。

object[]

required

必须且只能包含 1 个视频，还可包含 0–5 张参考图片。

string

required

视频使用 video，图片使用 reference_image。

string

required

公网可下载的素材 URL。

object

输出控制参数。不要传 ratio 或 duration。

string

default:"1080P"

可选值：720P、1080P。

boolean

default:true

是否添加水印。

string

default:"auto"

auto 自动处理音频；origin 保留原视频音频。

integer

随机种子，范围为 0–2147483647。

创建响应

200

{
  "id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "happyhorse-1.0-video-edit",
  "status": "queued",
  "progress": 0,
  "created_at": 1785464914
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的模型 ID。

string

创建后的初始状态，固定为 queued。

integer

创建时的初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

查询任务

GET /v1/video/generations/{task_id}

cURL

curl --request GET \
  --url https://www.anyfast.com.cn/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

请求头

string

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

路径参数

string

required

创建响应返回的任务 ID。

任务响应

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "action": "textGenerate",
    "status": "SUCCESS",
    "result_url": "https://example.com/generated-video.mp4",
    "fail_reason": "https://example.com/generated-video.mp4",
    "submit_time": 1785464914,
    "start_time": 1785464918,
    "finish_time": 1785464980,
    "progress": "100%",
    "request_id": "request_xxxxxxxxxxxxxxxx",
    "data": {
      "output": {
        "task_id": "upstream-task-id",
        "task_status": "SUCCEEDED",
        "video_url": "https://example.com/generated-video.mp4",
        "orig_prompt": "夜色中的未来城市",
        "submit_time": "2026-07-31 10:00:00.000",
        "scheduled_time": "2026-07-31 10:00:01.000",
        "end_time": "2026-07-31 10:01:06.000"
      },
      "request_id": "upstream-request-id",
      "usage": {
        "SR": 720,
        "duration": 3,
        "input_video_duration": 0,
        "output_video_duration": 3,
        "ratio": "21:9",
        "video_count": 1
      }
    }
  }
}

string

查询成功时为 success。

string

附加消息。

object

任务状态、结果和上游数据。

string

AnyFast 任务 ID。

string

工作流动作：文生视频为 textGenerate，图生视频为 generate，参考生视频为 referenceGenerate，视频编辑为 videoEdit。

string

NOT_START、QUEUED、IN_PROGRESS、SUCCESS 或 FAILURE。

string

成功后的结果视频 URL。

string

失败详情。兼容层在成功响应中也可能把此字段填为结果 URL，因此应以 data.status 判断结果。

integer

任务提交时间，Unix 秒级时间戳。

integer

任务开始时间；未开始时可为 0。

integer

任务结束时间。

string

百分比字符串，例如 100%。

string

AnyFast 请求追踪 ID。

object

上游原始输出和用量；任务未完成时可能缺失。

object

上游输出详情。

string

上游任务 ID。

string

上游状态，例如 PENDING、RUNNING、SUCCEEDED、FAILED 或 CANCELED。

string

上游结果视频 URL。

string

原始提示词。

string

上游提交时间。

string

上游调度时间。

string

上游结束时间。

string

上游请求 ID。

object

上游用量和输出指标。

integer

输出分辨率档位，例如 720 或 1080。

number

计费用量中的总时长。

number

输入视频时长；非视频编辑任务通常为 0。

number

输出视频时长。

string

输出比例；图生视频和视频编辑响应可能不返回。

integer

生成的视频数量。

概览

模型 API

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

查询任务

请求头

路径参数

任务响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​查询任务

​请求头

​路径参数

​任务响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

查询任务

请求头

路径参数

任务响应