Hunyuan 3D API

Tencent Hunyuan 3D 3.1. Generate 3D meshes from a text prompt or a single image. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide

3D Generation

Credit Cost

4 credits

Type

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/hunyuan-3d/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/hunyuan-3d.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt`	string	Text instruction describing what to generate or edit.	-
`image`	url	Reference image URL.	-
`enable_pbr`	boolean	Generate PBR (physically-based rendering) textures — base color, normal, roughness, metallic — alongside the mesh.	-
`face_count`	number	Target mesh face count (40,000–1,500,000). More faces = more detail, larger file. min: 40000 \| max: 1500000	-
`generate_type`	enum	Output mode: "Normal" produces a textured mesh; "Geometry" produces an untextured mesh. `NormalGeometry`	-

Example Outputs

Real outputs generated by this model

3D asset

View Details

a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."

4 credits

128.9s

3D asset

View Details

4 credits

151.6s

Code Examples

Image → 3D — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/hunyuan-3d/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://..."
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 4,
  "creditsRemaining": 95,
  "expiresAt": "2026-07-18T05:20:51Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.glb"
    ]
  },
  "creditCost": 4,
  "expiresAt": "2026-07-18T05:20:51Z"
}

3D models return the mesh file (glTF/GLB) as the first entry in output.images — download it and save with a .glb extension.

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits