Hunyuan World

Name: Tencent Hunyuan World
Price: 0.15 USD
Availability: InStock
Author: Tencent

tencent/hunyuan-world

Hunyuan World is Tencent's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Use in agent Get API key

Base price: $0.15USD / run
Execution: async
Model type: image
Input fields: 2

Try the model

Playground

Open playground

Input

Prompt(string)

The prompt to use for the panorama generation.

Image Url(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

The URL of the image to convert to a panorama.

This field is required.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.15 / run

Context & modalities

Input: Schema-defined
Output: image

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-world
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

Hunyuan World

Teams can place this named operation inside review, asset preparation, and publishing pipelines while keeping the original request attached to every result. Hunyuan World is centered on the tencent/hunyuan-world workflow for hunyuan world work in image production. 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. Hunyuan World is Tencent's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion. Because tencent/hunyuan-world is a separate catalog entry, evaluations should use this route’s own inputs, output expectations, and billing behavior. This is the creative remit of the exact endpoint, not a family-wide promise.

Hunyuan World exposes image, prompt as its documented request surface. image controls the URL of the image to convert to a panorama; prompt controls the prompt to use for the panorama generation. The mandatory portion is image, 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. For example, the route documentation includes “https://static.sandbase.ai/examples/tencent/hunyuan-world/output_url_0.png”.

Highlights

Structured 3D creation. Hunyuan World converts the route’s text or visual references into a spatial asset rather than a flat rendered image.
Geometry reconstruction. The model reasons about visible form and unseen surfaces to produce a coherent object that can be inspected from multiple viewpoints.
Appearance-aware output. Surface color and material cues are carried into the result so the asset retains the visual character of its source or brief.
Downstream 3D utility. Generated assets provide a starting point for visualization, concept development, interactive scenes, and further mesh refinement.

Pricing

Billing option	Price
Per request	`$0.150000`

When to Use

Scenario	Why it fits
Choose Hunyuan World	Use it when the job specifically calls for hunyuan world and the route’s documented input contract matches assets already available in your workflow.
Keep the request reproducible	Use the required `image`, `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-world.

{
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan-world/output_url_0.png",
  "prompt": "A skyland of wonders"
}

Technical Specs

Specification	Details
Model ID	`tencent/hunyuan-world`
Execution mode	`async`
Task type	`image`
`image`	`string` · required
`prompt`	`string` · required

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-world

# 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-world",
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan-world/output_url_0.png",
  "prompt": "A skyland of wonders"
}
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 WorldThis model `Tencent`	Image	$0.15 / run	Jul 28, 2025
Hunyuan Image 3.0 Edit `Tencent`	Image	$0.45 / run	Jan 28, 2026
Hunyuan 3D 3.1 Pro Text to 3D `Tencent`	Image	$0.38 / run	Jan 27, 2026
Hunyuan 3D 3.1 Pro Image to 3D `Tencent`	Image	$0.38 / run	Jan 27, 2026
Hunyuan 3D 3.0 Image to 3D `Tencent`	Image	$0.63 / run	Dec 16, 2025
Hunyuan Image 3.0 Text to Image `Tencent`	Image	$0.10 / run	Sep 28, 2025

Questions

FAQ

How do I call Tencent Hunyuan World through SandBase?

Create a SandBase API key, then send requests with the model ID "tencent/hunyuan-world" 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 World and the other models in the catalog; you do not need to sign up with Tencent separately.