tencent/hunyuan_world/image-to-world

Name: Hunyuan World
Author: Tencent

Hunyuan_world Image To World by Tencent - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.

Input

Image URL or upload(string)

Upload

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

The URL of the image to convert to a world.

This field is required.

Classes(string)

Classes to use for the world generation.

Labels Fg2(string)

Labels for the second foreground object.

Export Drc(boolean)

Whether to export DRC (Dynamic Resource Configuration).

Labels Fg1(string)

Labels for the first foreground object.

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/image-to-world

Input Schema

5 parameters · 1 required · 4 optional

Parameter	Type	Required	Description
`image`	string	Required	The URL of the image to convert to a world.
`classes`	string	Optional	Classes to use for the world generation.
`export_drc`	boolean	Optional	Whether to export DRC (Dynamic Resource Configuration). · Default: false
`labels_fg1`	string	Optional	Labels for the first foreground object.
`labels_fg2`	string	Optional	Labels for the second foreground object.

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-to-world",
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan_world/image-to-world/output_url_0.png",
  "classes": "nature, landscape",
  "export_drc": false,
  "labels_fg1": "tree, grass, sky",
  "labels_fg2": "mountain, water",
  "prompt": "a beautiful sunset over mountains"
}'

# 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

Hunyuan World occupies a clearly bounded position in a image production pipeline under the route tencent/hunyuan_world/image-to-world. It is best evaluated as a named workflow endpoint rather than as a generic substitute for neighboring versions: planners can assign the route to a specific brief, record the chosen revision, and keep approval history tied to one predictable integration surface from intake through delivery.

A practical rollout of Hunyuan World should begin with source-readiness checks, ownership of the submitted material, an agreed budget, and a written definition of the final image to world deliverable. Before automation is enabled, the acceptance pass should verify that the returned asset opens correctly, fits the intended downstream toolchain, satisfies the project’s review criteria, and can be reproduced from the stored request and route identity tencent/hunyuan_world/image-to-world.

Highlights

Distinct output behavior. For Hunyuan World, for Hunyuan World, generate textured 3D assets from single photos for games In Hunyuan World, this capability is applied through the exact tencent/hunyuan_world/image-to-world workflow with image as a relevant request control; the image control exposes the corresponding choice in this route; the image control exposes the corresponding choice in this route.
Creative control. For Hunyuan World, for Hunyuan World, digital content creation In Hunyuan World, this capability is applied through the exact tencent/hunyuan_world/image-to-world workflow with classes as a relevant request control; the classes control exposes the corresponding choice in this route; the classes control exposes the corresponding choice in this route.
Workflow fit. For Hunyuan World, for Hunyuan World, image to 3d In Hunyuan World, this capability is applied through the exact tencent/hunyuan_world/image-to-world workflow with export drc as a relevant request control; the export drc control exposes the corresponding choice in this route; the export drc control exposes the corresponding choice in this route.
Production detail. For Hunyuan World, for Hunyuan World, classes to use for the world generation In Hunyuan World, this capability is applied through the exact tencent/hunyuan_world/image-to-world workflow with labels fg1 as a relevant request control; the labels fg1 control exposes the corresponding choice in this route; the labels fg1 control exposes the corresponding choice in this route.

Pricing

Configuration	Price
Per request	$0.3

When to Use

Scenario	Why this model fits
Choose Hunyuan World	Use it when the required deliverable is specifically the image-to-world result documented for `tencent/hunyuan_world/image-to-world`.
Match the source material	Select this route when your inputs naturally map to `image`, `classes`, `export_drc`, `labels_fg1`.
Use its distinguishing capability	For Hunyuan World, generate textured 3D assets from single photos for games In Hunyuan World, this capability is applied through the exact tencent/hunyuan_world/image-to-world workflow with image as a relevant request control; the image control exposes the corresponding choice in this route
Plan repeatable production	For Hunyuan World, digital content creation In Hunyuan World, this capability is applied through the exact tencent/hunyuan_world/image-to-world workflow with classes as a relevant request control; the classes control exposes the corresponding choice in this route
Confirm cost and delivery	Use the pricing combinations below and the output contract above when budgeting or automating Hunyuan World jobs.

Prompt Guide

Build the request around the exact tencent/hunyuan_world/image-to-world schema. Start with required fields, then add only the controls needed for the intended output; keep URLs reachable and enum values exactly as shown in Technical Specs.

{
  "image": "https://static.sandbase.ai/examples/tencent/hunyuan_world/image-to-world/output_url_0.png",
  "classes": "nature, landscape",
  "export_drc": false,
  "labels_fg1": "tree, grass, sky"
}

Technical Specs

Specification	Value
Model ID	`tencent/hunyuan_world/image-to-world`
Execution mode	`async`
Required inputs	`image`
Request fields	`image` (string, required); `classes` (string, optional); `export_drc` (boolean, optional); `labels_fg1` (string, optional); `labels_fg2` (string, optional)
Output	`url` (string); `content_type` (string)