Hunyuan Video Serverless API

Hunyuan AI Video is a new, state of the art, AI Video Generator that creates high-quality videos from text descriptions. With 13B parameters and state-of-the-art performance, it's the most powerful open-source video generation model available.

~211.32s

~$1.464

Playground API

Pricing

~211.32s

~$1.464

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/hunyuan-video"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "seed": 96501778,
12    "width": 854,
13    "height": 480,
14    "prompt": "A cat walks on the grass, realistic style.",
15    "flow_shift": 7,
16    "infer_steps": 40,
17    "video_length": 77,
18    "negative_prompt": "Aerial view, overexposed, low quality, deformation",
19    "embedded_guidance_scale": 6
20}
21
22response = requests.post(url, headers=headers, json=data)
23
24if response.status_code == 200:
25    result = response.json()
26    print(json.dumps(result, indent=2))
27else:
28    print(f"Error: {response.status_code}")
29    print(response.text)

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/hunyuan-video"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "seed": 96501778,
12    "width": 854,
13    "height": 480,
14    "prompt": "A cat walks on the grass, realistic style.",
15    "flow_shift": 7,
16    "infer_steps": 40,
17    "video_length": 77,
18    "negative_prompt": "Aerial view, overexposed, low quality, deformation",
19    "embedded_guidance_scale": 6
20}
21
22response = requests.post(url, headers=headers, json=data)
23
24if response.status_code == 200:
25    result = response.json()
26    print(json.dumps(result, indent=2))
27else:
28    print(f"Error: {response.status_code}")
29    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/hunyuan-video

Parameters

promptrequired

string

Text prompt to generate video.

Default: "A cat walks on the grass, realistic style."

embedded_guidance_scaleoptional

integer

Embedded guidance scale for generation.

Default: 6Range: 1 - 10

flow_shiftoptional

number

Flow-shift parameter.

Default: 7Range: 1 - 15

heightoptional

integer

Height of the video in pixels.

Default: 480Range: 1 - 1280

infer_stepsoptional

integer

Number of inference steps.

Default: 40Range: 1 - 70

negative_promptoptional

string

Text prompt to specify what you don't want in the video.

Default: "Aerial view, overexposed, low quality, deformation"

seedoptional

integer

Random seed for reproducibility.

Default: 96501778

video_lengthoptional

integer

Length of the video in frames.

Default: 77Range: 1 - 129

widthoptional

integer

Width of the video in pixels.

Default: 854Range: 1 - 1280

Response Type

Returns: Video

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out