> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summerengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hunyuan 3D Pro

> Hunyuan 3D Pro on the Summer API: $0.525 per model, about 5 min, GLB saved to your Summer library. Model id 3d/hunyuan-3d.

High-quality geometry and textures from Tencent's Hunyuan 3D v3.1.

| | |
| - | - |
| Model id | `3d/hunyuan-3d` |
| Default for | `3d/default` |
| Price | \$0.525 per model |
| Typical time | about 5 min |
| Does | [Text to 3D](https://docs.summerengine.com/api/models.md#text-to-3d), [Picture to 3D](https://docs.summerengine.com/api/models.md#picture-to-3d) |
| Output | GLB |
| Made by | Tencent |
| Try it | [Examples and playground on summerengine.com](https://www.summerengine.com/models/hunyuan-3d-3-1-pro) |
| Commercial use | Yes |

## Examples

Real outputs of `3d/hunyuan-3d`, each with the input that made it. Drag a model to turn it.

[![Hunyuan 3D Pro: Moss, a small forest creature with leaf ears, a mossy round body and big dark eyes](https://media.summer.games/preview/v3/model-pages/hunyuan-3d-3-1-pro/moss-turntable.jpg)](https://media.summer.games/preview/v3/glb/mp-hunyuan-3d-3-1-pro-moss.glb)

From a picture: Moss, a small forest creature with leaf ears, a mossy round body and big dark eyes

[![Hunyuan 3D Pro: Original playful fire lizard creature for a colorful monster-collecting game, not based on any existing franchise.…](https://media.summer.games/preview/v3/create/3d/store/emberling.jpg)](https://www.summerengine.com/api/media/assets/5adff7c5-1fc3-439c-ab4a-ae4797d231ff/original)

Prompt: Original playful fire lizard creature for a colorful monster-collecting game, not based on any existing franchise. Small bipedal orange-red reptile with a cream belly, wide…

[![Hunyuan 3D Pro: Stylized toon cel-shaded low-poly 3D creature for a cozy collectible-creature game (Kubii Pets). Smooth glossy toon…](https://media.summer.games/preview/v3/create/3d/store/vallune.jpg)](https://www.summerengine.com/api/media/assets/4e6847f0-89e3-4fda-a60a-07ed92fcb1e8/original)

Prompt: Stylized toon cel-shaded low-poly 3D creature for a cozy collectible-creature game (Kubii Pets). Smooth glossy toon shading, warm saturated colors, NO realism, clean topology,…

[![Hunyuan 3D Pro: Emberfox, a stylized fox creature with a flaming tail, cute game character](https://media.summer.games/preview/v3/create/3d/store/emberfox.jpg)](https://www.summerengine.com/api/media/assets/5428a020-f8f3-459f-b44c-be85ef728641/original)

From a picture: Emberfox, a stylized fox creature with a flaming tail, cute game character

## Best for

* The default 3D model: what `3d/default` runs today.
* Props and set dressing such as crates, furniture, and weapons.
* Hero objects that need detailed geometry and textures.
* Characters to rig and animate in Summer.

## Price

**\$0.525 per model**. Exact list price: `0.525 USD`.

| When | Price |
| - | - |
| `kind` is `"image-to-3d"` | adds \$0.042 |
| `rig` is `true` | adds \$1.075 |

No markup: this is the provider's list price, checked 2026-09-24. A failed job costs nothing. Get the exact price of one request, free and without a key, from [`POST /v1/estimate`](https://docs.summerengine.com/api/jobs#know-the-price-first).

## Example call

Sign in once with `summer login`; over HTTP, send `Authorization: Bearer $SUMMER_TOKEN` after `export SUMMER_TOKEN=$(summer token)` ([sign-in](https://docs.summerengine.com/api/sign-in.md)). This job takes minutes. The CLI follows it and saves the file. Over HTTP the call answers `running` with a job id: check `GET /v1/jobs/{id}` until `state` is `done` ([jobs](https://docs.summerengine.com/api/jobs.md)); the [quickstart](https://docs.summerengine.com/api/quickstart.md) has the full loop.

```bash CLI theme={null}
npx -y summer-engine@latest api run 3d/hunyuan-3d \
  --input '{"kind":"text-to-3d","prompt":"a stylized treasure chest, game prop"}' \
  --download .
```

```bash curl theme={null}
curl https://www.summerengine.com/v1/jobs \
  -H "Authorization: Bearer $SUMMER_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=60" \
  -d '{"model":"3d/hunyuan-3d","input":{"kind":"text-to-3d","prompt":"a stylized treasure chest, game prop"}}'
```

```ts TypeScript theme={null}
const res = await fetch("https://www.summerengine.com/v1/jobs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SUMMER_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
    Prefer: "wait=60",
  },
  body: JSON.stringify({
    "model": "3d/hunyuan-3d",
    "input": {
      "kind": "text-to-3d",
      "prompt": "a stylized treasure chest, game prop"
    }
  }),
});
const { job } = await res.json();
console.log(job.state, job.id);
```

```python Python theme={null}
import os, uuid, requests

res = requests.post(
    "https://www.summerengine.com/v1/jobs",
    headers={
        "Authorization": f"Bearer {os.environ['SUMMER_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
        "Prefer": "wait=60",
    },
    json={"model": "3d/hunyuan-3d", "input": {"kind": "text-to-3d", "prompt": "a stylized treasure chest, game prop"}},
)
job = res.json()["job"]
print(job["state"], job["id"])
```

```js MCP theme={null}
// Summer's MCP server: npx -y summer-engine@latest setup <agent> --yes
summer_api_run({
  model: "3d/hunyuan-3d",
  input: {
    kind: "text-to-3d",
    prompt: "a stylized treasure chest, game prop"
  },
  out: "assets",
})
// It answers `next` while the job runs: follow it to the end.
summer_api_job({ jobId: "<jobId>", wait: true, out: "assets" })
```

The finished job has `state` `"done"` and `result.assets`: one entry per file, each with `assetId`, `fileUrl` (a Summer URL) and `thumbnailUrl`. Download the file into your project, or import it in Summer Engine by its asset id.

## Input

Send these fields in `input`. The full JSON Schema is `inputSchema` in [`GET /v1/models/3d/hunyuan-3d`](https://docs.summerengine.com/api/reference/get-models-model).

| Field | Type | About |
| - | - | - |
| `kind` | `text-to-3d`, `image-to-3d` | Default `"text-to-3d"`. |
| `prompt` | string | What to model. up to 600 characters |
| `imageUrl` | string | A public picture of the object. up to 2048 characters |
| `imageUrls` | array of string | Image-to-3d from 2 to 4 views of the same object. 2 to 4 items |
| `title` | string | up to 200 characters |
| `assetIntent` | `character`, `object` | Character: a clean, riggable humanoid reference first. |
| `referencePreparation` | `auto`, `always`, `never` | Clean up the picture before modeling it. Default `"auto"`. |
| `poseMode` | `a-pose`, `t-pose` | A neutral pose for rigging later. |
| `rig` | boolean | Auto-rig the model. Default `false`. |
| `animationNames` | array of string | With rig: animate a humanoid, e.g. Idle, Walk, Run, Jump. 0 to 12 items |
| `actionIds` | array of integer | With rig: Library action ids. 0 to 12 items |
| `riggingHeightMeters` | number | up to 10 |
| `targetPolycount` | integer | About how many polygons, e.g. 800 for a low-poly kit piece. 100 to 300000 |
| `topology` | `triangle`, `quad` | Quad: a quad mesh (where the model can). |
| `seed` | integer | 0 to 9007199254740991 |

## Related models

> **[TRELLIS Multi-image](https://docs.summerengine.com/api/models/3d/trellis-multi.md)**
>
> `3d/trellis-multi`: \$0.062 per model

> **[Rodin 2.5 Fast](https://docs.summerengine.com/api/models/3d/rodin-2-5-fast.md)**
>
> `3d/rodin-2.5-fast`: \$0.10 per model

> **[Tripo H3.1](https://docs.summerengine.com/api/models/3d/tripo-h3-1.md)**
>
> `3d/tripo-h3.1`: \$0.20 per model

> **[Hunyuan 3D Rapid](https://docs.summerengine.com/api/models/3d/hunyuan-3d-rapid.md)**
>
> `3d/hunyuan-3d-rapid`: \$0.225 per model

## For agents

This page as Markdown: [https://docs.summerengine.com/api/models/3d/hunyuan-3d.md](https://docs.summerengine.com/api/models/3d/hunyuan-3d.md). The live record with the JSON Schema: `GET https://www.summerengine.com/v1/models/3d/hunyuan-3d`, public, no sign-in.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.