Hunyuan Video Text to Video

Name: Tencent Hunyuan Video Text to Video
Price: 0.4 USD
Availability: InStock
Author: Tencent

tencent/hunyuan-video/text-to-video

Hunyuan Video is Tencent's text-to-video AI model. Turn written scripts and prompts into professional-quality video clips with realistic motion, lighting, and scene composition.

Use in agent Get API key

Base price: $0.40USD / run
Execution: async
Model type: video
Input fields: 3

Try the model

Playground

Open playground

Input

Prompt(string)

The prompt to generate the video from.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Resolution(string)

The resolution of the video to generate. Allowed values: 480p, 580p, 720p.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.40 / run

Context & modalities

Input: Schema-defined
Output: video

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: Tencent
Model ID: tencent/hunyuan-video/text-to-video
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

Hunyuan Video Text to Video

Teams can place this named operation inside review, asset preparation, and publishing pipelines while keeping the original request attached to every result. Hunyuan Video is Tencent's text-to-video AI model. Turn written scripts and prompts into professional-quality video clips with realistic motion, lighting, and scene composition. Hunyuan Video Text to Video provides a focused path for the tencent/hunyuan-video/text-to-video workflow for text to video work in video production. Because tencent/hunyuan-video/text-to-video is a separate catalog entry, evaluations should use this route’s own inputs, output expectations, and billing behavior. The endpoint is especially useful when a project has a defined transformation goal and needs a repeatable request contract instead of an ad-hoc desktop step. That scope belongs to this named route, not to a neighboring version.

prompt controls the prompt to generate the video from; resolution controls the resolution of the video to generate; resolution accepts 480p, 580p, 720p; aspect ratio controls the aspect ratio of the generated image; aspect ratio accepts 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16. Hunyuan Video Text to Video exposes prompt, resolution, aspect_ratio as its documented request surface. For example, the route documentation includes “A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage. She wears a black leather jacket, a long red dress, and black boots, and carries a black purse.”. The mandatory portion is prompt. Applications can submit that exact shape asynchronously, retain the chosen arguments in job metadata, and collect the resulting media URL for review or publishing.

Highlights

Coherent motion. Hunyuan Video Text to Video is built to turn the route’s text or reference media into a temporally connected sequence rather than unrelated frames.
Shot direction. Prompts can describe subject action, camera movement, pacing, and atmosphere so Hunyuan Video Text to Video has a concrete motion plan.
Reference-aware generation. When this route accepts source media, Hunyuan Video Text to Video uses it to anchor identity, composition, or the clip boundary throughout generation.
Production variants. Declared duration, resolution, framing, or inference controls support repeatable video options for review and selection.

Pricing

Billing option	Price
Per request	`$0.400000`

When to Use

Scenario	Why it fits
Choose Hunyuan Video Text to Video	Use it when the job specifically calls for text to video and the route’s documented input contract matches assets already available in your workflow.
Keep the request reproducible	Use the required `prompt` explicitly, then record optional choices alongside the prompt for repeatable reruns.
Build controlled creative variations	Change one declared control at a time when comparing framing, format, duration, resolution, style, or other route-supported output decisions.
Integrate asynchronous delivery	Use this endpoint when an application can submit work, track completion, and collect the returned media URL instead of requiring an immediate inline artifact.
Validate before a large batch	Run representative prompts and source assets first, confirm the visual or audio behavior, then lock the successful request shape for scaled production.

Prompt Guide

Lead with the subject or transformation, then add the composition, environment, style, lighting, motion, voice, or fidelity details relevant to this route. Keep every parameter inside the documented schema; the example below uses only fields declared for tencent/hunyuan-video/text-to-video.

{
  "prompt": "A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage. She wears a black leather jacket, a long red dress, and black boots, and carries a black purse.",
  "resolution": "480p",
  "aspect_ratio": "21:9"
}

Technical Specs

Specification	Details
Model ID	`tencent/hunyuan-video/text-to-video`
Execution mode	`async`
Task type	`video`
`prompt`	`string` · required
`resolution`	`string` · optional · choices: `480p`, `580p`, `720p`
`aspect_ratio`	`string` · optional · choices: `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`

Related Models

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

tencent/hunyuan-video/text-to-video

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "tencent/hunyuan-video/text-to-video",
  "prompt": "A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage. She wears a black leather jacket, a long red dress, and black boots, and carries a black purse.",
  "resolution": "720p"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models

Model	Type	Default price	Released
Hunyuan Video Text to VideoThis model `Tencent`	Video	$0.40 / run	Oct 22, 2024
Hunyuan Video 1.5 Text to Video `Tencent`	Video	$0.38 / run	Nov 21, 2025

Questions

FAQ

How do I call Tencent Hunyuan Video Text to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "tencent/hunyuan-video/text-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Tencent account?

No. One SandBase API key and balance gives you access to Tencent Hunyuan Video Text to Video and the other models in the catalog; you do not need to sign up with Tencent separately.