POST
/
v3
/
async
/
hunyuan-video-fast
curl --request POST \
  --url https://api.novita.ai/v3/async/hunyuan-video-fast \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "model_name": "<string>",
  "width": 123,
  "height": 123,
  "seed": 123,
  "steps": 123,
  "prompt": "<string>",
  "frames": 123
}'
{
  "task_id": "<string>"
}

Accelerated inference for HunyuanVideo with high resolution, a state-of-the-art text-to-video generation model capable of creating high-quality videos with realistic motion from text descriptions.

This is an asynchronous API; only the task_id will be returned. You should use the task_id to request the Task Result API to retrieve the video generation results.

​
Request Headers

​
Content-Type
string
required

Supports: application/json

​
Authorization
string
required

Bearer authentication format, for example: Bearer {{API Key}}.

​
Request Body

​
model_name
string
required

Name of the model checkpoint.

Supports: hunyuan-video-fast.

​
width
integer
required

Width of the output video.

Supports: 480, 640, 720, 864, 1280.

​
height
integer
required

Height of the output video.

Supports:

  • 480 for width of 640
  • 640 for width of 480
  • 864 for width of 480
  • 480 for width of 864
  • 720 for width of 1280
  • 1280 for width of 720
​
seed
integer
required

A seed is a number generates noise, which, makes generation deterministic. Using the same seed and set of parameters will produce identical content each time.

Range: -1 <= x <= 9999999999.

​
steps
integer
required

The number of denoising steps. More steps usually produce higher quality content but take more time to generate.

Range: 2 <= x <= 30.

​
prompt
string
required

Prompt text required to guide the generation.

Range: 1 <= x <= 2000.

​
frames
integer
required

The number of frames in the output video.

Range: 85 <= x <= 129.

​
Response

​
task_id
string
required

Use the task_id to request the Task Result API to retrieve the generated outputs.

​
Example

Here is an example of how to use the Hunyuan Video Fast API.

  1. Generate a task_id by sending a POST request to the Hunyuan Video Fast API.

Request:

curl --location 'https://api.novita.ai/v3/async/hunyuan-video-fast' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "hunyuan-video-fast",
    "height": 720,
    "width": 1280,
    "seed": -1,
    "steps": 30,
    "prompt": "A close up view of a glass sphere that has a zen garden within it. There is a small dwarf in the sphere who is raking the zen garden and creating patterns in the sand.",
    "frames": 85
}'

Response:

{
    "task_id": "{Returned Task ID}"
}
  1. Use task_id to get output videos.

HTTP status codes in the 2xx range indicate that the request has been successfully accepted, while status codes in the 5xx range indicate internal server errors.

You can get videos url in videos of response.

Request:

curl --location --request GET 'https://api.novita.ai/v3/async/task-result?task_id={Returned Task ID}' \
--header 'Authorization: Bearer {{API Key}}'

Response:

{
    "task": {
        "task_id": "{Returned Task ID}",
        "task_type": "HUNYUAN_VIDEO_FAST",
        "status": "TASK_STATUS_SUCCEED",
        "reason": "",
        "eta": 0,
        "progress_percent": 100
    },
    "images": [],
    "videos": [
        {
            "video_url": "{The URL of the generated video}",
            "video_url_ttl": "3600",
            "video_type": "mp4"
        }
    ]
}

Video files:

Was this page helpful?

Image to VideoWan 2.1 T2V