tencent/hunyuan-world

Name: Hunyuan World
Author: Tencent

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.

Input

Prompt(string)

The prompt to use for the panorama generation.

Image URL or upload(string)

Upload

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

The URL of the image to convert to a panorama.

This field is required.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

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

Model IDtencent/hunyuan-world

Input Schema

2 parameters · 2 required · 0 optional

Parameter	Type	Required	Description
`image`	string	Required	The URL of the image to convert to a panorama.
`prompt`	string	Required	The prompt to use for the panorama generation.

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "tencent/hunyuan-world",
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan-world/output_url_0.png",
  "prompt": "A skyland of wonders"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Hunyuan World

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