## 创建任务
`POST /v1/video/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/video/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "happyhorse-1.0-t2v",
"prompt": "一只猫在草地上奔跑",
"parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
}'
```
```json 200 theme={null}
{
"id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"object": "video",
"model": "happyhorse-1.0-t2v",
"status": "queued",
"progress": 0,
"created_at": 1777343862
}
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
## 请求参数
必须为 `happyhorse-1.0-t2v`。
视频内容描述。
## 查询任务（单个）
`GET /v1/video/generations/{task_id}`
### 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
### 路径参数
创建任务时返回的任务 ID。
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/v1/video/generations/TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
```
```json 200 theme={null}
{
"code": "success",
"message": "",
"data": {
"task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
"action": "generate",
"status": "SUCCESS",
"result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"submit_time": 1777343862,
"start_time": 1777343866,
"finish_time": 1777343961,
"progress": "100%",
"request_id": "20260731061043150392831bGTNOtlT",
"data": {
"output": {
"task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
"task_status": "SUCCEEDED",
"video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"orig_prompt": "A cat running on grass",
"submit_time": "2026-04-28 10:37:42.625",
"scheduled_time": "2026-04-28 10:37:42.652",
"end_time": "2026-04-28 10:39:04.185"
},
"request_id": "53121cad-c008-9b96-af1d-4289a4fc714b",
"usage": {
"SR": 720,
"duration": 5,
"input_video_duration": 0,
"output_video_duration": 5,
"ratio": "16:9",
"video_count": 1
}
}
}
}
```
### 响应字段
查询成功时为 `success`。
附加响应消息。
AnyFast 任务 ID。
任务使用的工作流动作。
任务状态，例如 `QUEUED`、`IN_PROGRESS`、`SUCCESS` 或 `FAILURE`。
任务成功后的结果视频 URL。
上游任务服务返回的失败详情；成功响应中该字段也可能被填充为结果 URL。
任务提交时间，Unix 时间戳。
任务开始处理时间，Unix 时间戳。
任务完成时间，Unix 时间戳。
任务进度百分比。
AnyFast 外层响应的请求 ID。
上游任务输出详情。
上游任务 ID。
上游任务状态，例如 `SUCCEEDED`。
上游结果视频 URL。
任务提交时使用的原始提示词。
上游任务提交时间。
上游任务调度时间。
上游任务完成时间。
上游任务服务返回的请求 ID。
上游任务服务返回的用量和输出指标。
输出超分辨率值。
请求或生成的视频时长。
输入视频时长。
输出视频时长。
输出画面比例。
生成的视频数量。
## 创建任务
`POST /v1/video/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/video/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "happyhorse-1.0-i2v",
"prompt": "镜头缓缓拉近，画面逐渐动起来",
"image": "https://example.com/first-frame.png",
"parameters": {"resolution": "720P", "duration": 5, "watermark": false}
}'
```
```json 200 theme={null}
{
"id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"object": "video",
"model": "happyhorse-1.0-i2v",
"status": "queued",
"progress": 0,
"created_at": 1777343862
}
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
## 请求参数
必须为 `happyhorse-1.0-i2v`。
预期动作的文本描述。
首帧图片 URL。也支持 `images`，但只使用其中第一张。
## 查询任务（单个）
`GET /v1/video/generations/{task_id}`
### 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
### 路径参数
创建任务时返回的任务 ID。
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/v1/video/generations/TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
```
```json 200 theme={null}
{
"code": "success",
"message": "",
"data": {
"task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
"action": "firstTailGenerate",
"status": "SUCCESS",
"result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"submit_time": 1777343862,
"start_time": 1777343866,
"finish_time": 1777348588,
"progress": "100%",
"request_id": "20260731061043150392831bGTNOtlT",
"data": {
"output": {
"task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
"task_status": "SUCCEEDED",
"video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"orig_prompt": "A cat running on grass",
"submit_time": "2026-04-28 10:37:42.625",
"scheduled_time": "2026-04-28 10:37:42.652",
"end_time": "2026-04-28 10:39:04.185"
},
"request_id": "53121cad-c008-9b96-af1d-4289a4fc714b",
"usage": {
"SR": 720,
"duration": 5,
"input_video_duration": 0,
"output_video_duration": 5,
"ratio": "16:9",
"video_count": 1
}
}
}
}
```
### 响应字段
### 响应字段
查询成功时为 `success`。
附加响应消息。
AnyFast 任务 ID。
任务使用的工作流动作。
任务状态，例如 `QUEUED`、`IN_PROGRESS`、`SUCCESS` 或 `FAILURE`。
任务成功后的结果视频 URL。
上游任务服务返回的失败详情；成功响应中该字段也可能被填充为结果 URL。
任务提交时间，Unix 时间戳。
任务开始处理时间，Unix 时间戳。
任务完成时间，Unix 时间戳。
任务进度百分比。
AnyFast 外层响应的请求 ID。
上游任务输出详情。
上游任务 ID。
上游任务状态，例如 `SUCCEEDED`。
上游结果视频 URL。
任务提交时使用的原始提示词。
上游任务提交时间。
上游任务调度时间。
上游任务完成时间。
上游任务服务返回的请求 ID。
上游任务服务返回的用量和输出指标。
输出超分辨率值。
请求或生成的视频时长。
输入视频时长。
输出视频时长。
输出画面比例。
生成的视频数量。
## 创建任务
`POST /v1/video/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/video/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "happyhorse-1.0-r2v",
"prompt": "身着红色旗袍的女性轻抬玉手展开折扇",
"images": ["https://example.com/ref1.jpg", "https://example.com/ref2.jpg"],
"parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
}'
```
```json 200 theme={null}
{
"id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"object": "video",
"model": "happyhorse-1.0-r2v",
"status": "queued",
"progress": 0,
"created_at": 1777343862
}
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
## 请求参数
必须为 `happyhorse-1.0-r2v`。
视频内容描述。
1 至 3 张参考图 URL。
## 查询任务（单个）
`GET /v1/video/generations/{task_id}`
### 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
### 路径参数
创建任务时返回的任务 ID。
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/v1/video/generations/TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
```
```json 200 theme={null}
{
"code": "success",
"message": "",
"data": {
"task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
"action": "referenceGenerate",
"status": "SUCCESS",
"result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"submit_time": 1777343862,
"start_time": 1777343866,
"finish_time": 1777348588,
"progress": "100%",
"request_id": "20260731061043150392831bGTNOtlT",
"data": {
"output": {
"task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
"task_status": "SUCCEEDED",
"video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"orig_prompt": "A cat running on grass",
"submit_time": "2026-04-28 10:37:42.625",
"scheduled_time": "2026-04-28 10:37:42.652",
"end_time": "2026-04-28 10:39:04.185"
},
"request_id": "53121cad-c008-9b96-af1d-4289a4fc714b",
"usage": {
"SR": 720,
"duration": 5,
"input_video_duration": 0,
"output_video_duration": 5,
"ratio": "16:9",
"video_count": 1
}
}
}
}
```
### 响应字段
### 响应字段
查询成功时为 `success`。
附加响应消息。
AnyFast 任务 ID。
任务使用的工作流动作。
任务状态，例如 `QUEUED`、`IN_PROGRESS`、`SUCCESS` 或 `FAILURE`。
任务成功后的结果视频 URL。
上游任务服务返回的失败详情；成功响应中该字段也可能被填充为结果 URL。
任务提交时间，Unix 时间戳。
任务开始处理时间，Unix 时间戳。
任务完成时间，Unix 时间戳。
任务进度百分比。
AnyFast 外层响应的请求 ID。
上游任务输出详情。
上游任务 ID。
上游任务状态，例如 `SUCCEEDED`。
上游结果视频 URL。
任务提交时使用的原始提示词。
上游任务提交时间。
上游任务调度时间。
上游任务完成时间。
上游任务服务返回的请求 ID。
上游任务服务返回的用量和输出指标。
输出超分辨率值。
请求或生成的视频时长。
输入视频时长。
输出视频时长。
输出画面比例。
生成的视频数量。
## 创建任务
`POST /v1/video/generations`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/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.png"}
]
},
"parameters": {"resolution": "720P", "watermark": false}
}'
```
```json 200 theme={null}
{
"id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"object": "video",
"model": "happyhorse-1.0-video-edit",
"status": "queued",
"progress": 0,
"created_at": 1777343862
}
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
## 请求参数
必须为 `happyhorse-1.0-video-edit`。
编辑指令，最多 5000 个非中文字符或 2500 个中文字符。
有且仅有一条原始视频，另可选包含 0 至 5 张参考图。
原始视频使用 `video`，可选参考图使用 `reference_image`。
公网可访问的媒体 URL。
`720P` 或 `1080P`。
输出时长由原始视频决定，该参数可能不生效。
## 查询任务（单个）
`GET /v1/video/generations/{task_id}`
### 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
请求体格式。
### 路径参数
创建任务时返回的任务 ID。
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/v1/video/generations/TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
```
```json 200 theme={null}
{
"code": "success",
"message": "",
"data": {
"task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
"action": "videoEdit",
"status": "SUCCESS",
"result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"submit_time": 1777343862,
"start_time": 1777343866,
"finish_time": 1777348588,
"progress": "100%",
"request_id": "20260731061043150392831bGTNOtlT",
"data": {
"output": {
"task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
"task_status": "SUCCEEDED",
"video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"orig_prompt": "A cat running on grass",
"submit_time": "2026-04-28 10:37:42.625",
"scheduled_time": "2026-04-28 10:37:42.652",
"end_time": "2026-04-28 10:39:04.185"
},
"request_id": "53121cad-c008-9b96-af1d-4289a4fc714b",
"usage": {
"SR": 720,
"duration": 5,
"input_video_duration": 0,
"output_video_duration": 5,
"ratio": "16:9",
"video_count": 1
}
}
}
}
```
### 响应字段
### 响应字段
查询成功时为 `success`。
附加响应消息。
AnyFast 任务 ID。
任务使用的工作流动作。
任务状态，例如 `QUEUED`、`IN_PROGRESS`、`SUCCESS` 或 `FAILURE`。
任务成功后的结果视频 URL。
上游任务服务返回的失败详情；成功响应中该字段也可能被填充为结果 URL。
任务提交时间，Unix 时间戳。
任务开始处理时间，Unix 时间戳。
任务完成时间，Unix 时间戳。
任务进度百分比。
AnyFast 外层响应的请求 ID。
上游任务输出详情。
上游任务 ID。
上游任务状态，例如 `SUCCEEDED`。
上游结果视频 URL。
任务提交时使用的原始提示词。
上游任务提交时间。
上游任务调度时间。
上游任务完成时间。
上游任务服务返回的请求 ID。
上游任务服务返回的用量和输出指标。
输出超分辨率值。
请求或生成的视频时长。
输入视频时长。
输出视频时长。
输出画面比例。
生成的视频数量。
## 通用请求参数