Hunyuan Video

480 credits per standard call; 960 credits per Pro call
ae_hunyuan_video

Create a video from a text description, with options for aspect ratio, resolution, length, quality, and seed.

Video
480 credits per standard call; 960 credits per Pro call

Pricing

480 credits per standard call; 960 credits per Pro call
ConditionCharge
Standard mode (default)480 credits/call
Pro mode960 credits/call

Successful calls are charged 480 credits in standard mode or 960 credits in Pro mode.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedinteger | unknownNoThe seed to use for generating the video.—
request_body.promptstringYesThe prompt to generate the video from.—
request_body.pro_modebooleanNoBy default, generations are done with 35 steps. Pro mode does 55 steps which results in higher quality videos but will take more time and cost 2x more billing units.false
request_body.num_framesenum (129 | 85)NoThe number of frames to generate.129
request_body.resolutionenum (480p | 580p | 720p)NoThe resolution of the video to generate.720p
request_body.aspect_ratioenum (16:9 | 9:16)NoThe aspect ratio of the video to generate.16:9
request_body.enable_safety_checkerbooleanNoIf set to true, the safety checker will be enabled.false

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_hunyuan_video' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "aspect_ratio": "9:16",
      "pro_mode": false,
      "prompt": "A majestic snow mountain peak at sunrise, clouds flowing slowly, cinematic aerial view",
      "resolution": "480p"
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "1e49ecc0-ac47-4e71-b8d4-ecc512a98978"
}