Hunyuan Video Generation API Documentation

Overview

PiAPI's Hunyuan Video Generation service provides text-to-video capabilities with two different models optimized for different use cases. The service supports both standard and fast video generation options, each with specific characteristics and pricing. Hunyuan Video Model Can Do NSFW

Pricing

Model	Resolution	FPS	Steps	Price (USD)
txt2video	480x848/640x640	85	20	$0.09
fast-txt2video	480x848/640x640	85	6	$0.03
img2video-concat	544x960/720x720	85	20	$0.09
img2video-replace	544x960/720x720	85	20	$0.09

Model Information

Standard Text-to-Video (txt2video)

Model Name: Qubico/hunyuan

Task Type: txt2video

Quality Focus: Higher quality with more processing steps (20 steps)

Best For: Projects requiring higher quality output

Fast Text-to-Video (fastvideo-txt2video)

Model Name: Qubico/hunyuan

Task Type: fast-txt2video

Speed Focus: Faster generation with fewer steps (6 steps)

Best For: Quick iterations and preview purposes

Hunyuan-img2video-concat

Model Name: Qubico/hunyuan

Task Type: img2video-concat

Speed Focus: Faster generation with more processing steps (20 steps)

Best For: Generate videos based on images for better movement.

Hunyuan-img2video-replace

Model Name: Qubico/hunyuan

Task Type: img2video-replace

Speed Focus: Faster generation with more processing steps (20 steps)

Best For: Generate videos following the guilding image better.

Request

Header Params

x-api-key

string

optional

your api key

Body Params application/json

model

enum<string>

required

Model name for video generation

Allowed value:

Qubico/hunyuan

task_type

enum<string>

required

Task type for video generation

Allowed values:

txt2videofastvideo-txt2videomg2video-concatimg2video-replace

input

object

required

prompt

string

required

Text prompt for video generation

image

string

optional

Must be required when choose task_types including img2video-concat and img2video-replace.

aspect_ratio

string

optional

Default is 16:9 with options for 16:9, 9:16, and 1:1.

config

object

required

webhook_config

object

optional

Example

{
  "model": "Qubico/hunyuan",
  "task_type": "txt2video",
  "input": {
    "prompt": "A cat walks on the grass, realistic style."
  },
  "config": {
    "webhook_config": {
      "endpoint": "",
      "secret": ""
    }
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful response

Body

code

enum<integer>

required

Response status code

Allowed value:

200

message

string

required

Response message

data

object

required

task_id

string <uuid>

required

Unique task identifier

status

string

required

Current status of the task

output

object

optional

Example

{
  "code": 200,
  "message": "string",
  "data": {
    "task_id": "736fde4d-9029-4915-8189-01353d6982cb",
    "status": "string",
    "output": {
      "video_url": "http://example.com"
    }
  }
}

Generate Video

Hunyuan Video Generation API Documentation#

Overview#

Pricing#

Model Information#

Standard Text-to-Video (txt2video)#

Fast Text-to-Video (fastvideo-txt2video)#

Hunyuan-img2video-concat#

Hunyuan-img2video-replace#

Request

Request samples

Responses

Hunyuan Video Generation API Documentation

Overview

Pricing

Model Information

Standard Text-to-Video (txt2video)

Fast Text-to-Video (fastvideo-txt2video)

Hunyuan-img2video-concat

Hunyuan-img2video-replace