## Create task
`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": "A cat running on grass",
"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
}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
## Request parameters
Must be `happyhorse-1.0-t2v`.
Text description of the video.
## Query task by ID
`GET /v1/video/generations/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
### Path parameters
Task ID returned by the create request.
```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
}
}
}
}
```
### Response fields
`success` when the task query succeeds.
Additional response message.
AnyFast task ID.
Workflow action used to process the task.
Task status, such as `QUEUED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE`.
Result video URL when the task succeeds.
Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.
Task submission time as a Unix timestamp.
Task processing start time as a Unix timestamp.
Task completion time as a Unix timestamp.
Task progress percentage.
Request ID for the outer AnyFast response.
Upstream task output details.
Upstream task ID.
Upstream task status, such as `SUCCEEDED`.
Upstream result video URL.
Original prompt submitted for the task.
Upstream task submission time.
Upstream task scheduling time.
Upstream task completion time.
Request ID returned by the upstream task service.
Usage and output metrics returned by the upstream task service.
Output super-resolution value.
Requested or generated video duration.
Input video duration.
Output video duration.
Output aspect ratio.
Number of generated videos.
## Create task
`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": "Camera slowly zooms in as the scene comes to life",
"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
}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
## Request parameters
Must be `happyhorse-1.0-i2v`.
Text description of the desired motion.
First-frame image URL. `images` is also accepted, but only its first item is used.
## Query task by ID
`GET /v1/video/generations/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
### Path parameters
Task ID returned by the create request.
```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
}
}
}
}
```
### Response fields
### Response fields
`success` when the task query succeeds.
Additional response message.
AnyFast task ID.
Workflow action used to process the task.
Task status, such as `QUEUED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE`.
Result video URL when the task succeeds.
Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.
Task submission time as a Unix timestamp.
Task processing start time as a Unix timestamp.
Task completion time as a Unix timestamp.
Task progress percentage.
Request ID for the outer AnyFast response.
Upstream task output details.
Upstream task ID.
Upstream task status, such as `SUCCEEDED`.
Upstream result video URL.
Original prompt submitted for the task.
Upstream task submission time.
Upstream task scheduling time.
Upstream task completion time.
Request ID returned by the upstream task service.
Usage and output metrics returned by the upstream task service.
Output super-resolution value.
Requested or generated video duration.
Input video duration.
Output video duration.
Output aspect ratio.
Number of generated videos.
## Create task
`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": "A woman in a red qipao gracefully unfolds a folding fan",
"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
}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
## Request parameters
Must be `happyhorse-1.0-r2v`.
Text description of the video.
1-3 reference image URLs.
## Query task by ID
`GET /v1/video/generations/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
### Path parameters
Task ID returned by the create request.
```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
}
}
}
}
```
### Response fields
### Response fields
`success` when the task query succeeds.
Additional response message.
AnyFast task ID.
Workflow action used to process the task.
Task status, such as `QUEUED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE`.
Result video URL when the task succeeds.
Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.
Task submission time as a Unix timestamp.
Task processing start time as a Unix timestamp.
Task completion time as a Unix timestamp.
Task progress percentage.
Request ID for the outer AnyFast response.
Upstream task output details.
Upstream task ID.
Upstream task status, such as `SUCCEEDED`.
Upstream result video URL.
Original prompt submitted for the task.
Upstream task submission time.
Upstream task scheduling time.
Upstream task completion time.
Request ID returned by the upstream task service.
Usage and output metrics returned by the upstream task service.
Output super-resolution value.
Requested or generated video duration.
Input video duration.
Output video duration.
Output aspect ratio.
Number of generated videos.
## Create task
`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": "Make the character wear the striped sweater from the image.",
"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
}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
## Request parameters
Must be `happyhorse-1.0-video-edit`.
Editing instruction. Maximum 5,000 non-Chinese or 2,500 Chinese characters.
Contains exactly one source-video item and 0-5 optional reference-image items.
`video` for the one source video or `reference_image` for an optional reference image.
Publicly accessible media URL.
`720P` or `1080P`.
Output duration follows the source video and this parameter might not take effect.
## Query task by ID
`GET /v1/video/generations/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Request body format.
### Path parameters
Task ID returned by the create request.
```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
}
}
}
}
```
### Response fields
### Response fields
`success` when the task query succeeds.
Additional response message.
AnyFast task ID.
Workflow action used to process the task.
Task status, such as `QUEUED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE`.
Result video URL when the task succeeds.
Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.
Task submission time as a Unix timestamp.
Task processing start time as a Unix timestamp.
Task completion time as a Unix timestamp.
Task progress percentage.
Request ID for the outer AnyFast response.
Upstream task output details.
Upstream task ID.
Upstream task status, such as `SUCCEEDED`.
Upstream result video URL.
Original prompt submitted for the task.
Upstream task submission time.
Upstream task scheduling time.
Upstream task completion time.
Request ID returned by the upstream task service.
Usage and output metrics returned by the upstream task service.
Output super-resolution value.
Requested or generated video duration.
Input video duration.
Output video duration.
Output aspect ratio.
Number of generated videos.
## Shared request parameters