## 创建任务 `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.1-t2v", "input": {"prompt": "夜晚，一座纸板搭建的微缩城市苏醒。"}, "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false, "seed": 42} }' ``` ```json 200 theme={null} { "id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya", "task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya", "object": "video", "model": "happyhorse-1.1-t2v", "status": "queued", "progress": 0, "created_at": 1784520000 } ```

## 请求头 Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。请求体格式。 ## 请求参数必须为 `happyhorse-1.1-t2v`。文本提示，最多 5000 个非中文字符或 2500 个中文字符。 `720P` 或 `1080P`。 `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21` 或 `21:9`。 ## 查询任务（单个） `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.1-i2v", "input": { "prompt": "小猫从草地上快速跑过。", "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}] }, "parameters": {"resolution": "720P", "duration": 5, "watermark": false} }' ``` ```json 200 theme={null} { "id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya", "task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya", "object": "video", "model": "happyhorse-1.1-i2v", "status": "queued", "progress": 0, "created_at": 1784520000 } ```

## 请求头 Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。请求体格式。 ## 请求参数必须为 `happyhorse-1.1-i2v`。必须且只能包含一张首帧图片对象。必须为 `first_frame`。公网图片 URL 或 Base64 Data 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": "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.1-r2v", "input": { "prompt": "[Image 1]展开[Image 2]中的折扇。", "media": [ {"type": "reference_image", "url": "https://example.com/person.jpg"}, {"type": "reference_image", "url": "https://example.com/fan.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.1-r2v", "status": "queued", "progress": 0, "created_at": 1784520000 } ```

## 请求头 Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。请求体格式。 ## 请求参数必须为 `happyhorse-1.1-r2v`。包含 1 至 9 张参考图对象。必须为 `reference_image`。公网图片 URL 或 Base64 Data URL。 `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21` 或 `21:9`。 ## 查询任务（单个） `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 } } } } ```