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

# 3D Model API

> Turn one image into a textured, downloadable 3D model (GLB, FBX, USDZ or STL) with Tripo H3.1 or Meshy 7.1, through the BudgetPixel API.

**Image → 3D model.** Turn one picture into a textured 3D model you can download. Each
model has its own endpoint, `POST /v1/3d/{model}`.

## Models

3 models. Each name opens its API reference with every parameter.

| Model | Maker | What it does |
| - | - | - |
| [Tripo H3.1](https://docs.budgetpixel.com/api-reference/3d-models/generate-a-3d-model-with-tripo-h31.md) `tripo-h3.1` | Tripo | A textured GLB with PBR materials, the most faithful to the picture, flat cartoons included. |
| [Meshy 7.1](https://docs.budgetpixel.com/api-reference/3d-models/generate-a-3d-model-with-meshy-71.md) `meshy-7.1` | Meshy | A light textured model (\~30K triangles) in GLB, FBX, USDZ and STL. |
| [List 3D model moves](https://docs.budgetpixel.com/api-reference/3d-models/list-3d-model-moves.md) `moves` | Meshy | The moves a rigged Meshy 7.1 character can perform, by category (dancing, everyday, walking and running, moves and stunts, fighting). |

[3D models](https://docs.budgetpixel.com/concepts/models.md#3d-models) explains each model's options, and the
[quickstart](https://docs.budgetpixel.com/quickstart.md#generating-a-3d-model) walks through one request.

## How a request works

1. Send `POST /v1/3d/{model}` with an `image`. The response returns a job `id` right away.
2. Poll [`GET /v1/3d/{job_id}`](https://docs.budgetpixel.com/api-reference/3d-models/get-3d-model-job-status) every 15
   to 30 seconds until `status` is `succeeded`; a model takes 2 to 5 minutes. The response
   then holds the download links.

Download the files promptly: they're deleted after about 24 hours.

## Animating a character

Meshy 7.1 can rig a humanoid character and animate it. Pick the move with `animation_move`,
an id from [`GET /v1/3d/moves`](https://docs.budgetpixel.com/api-reference/3d-models/list-3d-model-moves): about 650
moves in five groups (dancing, everyday, walking and running, moves and stunts, fighting).
For example, 591 is Hip Hop Dance:

```bash theme={null}
curl -X POST https://api.budgetpixel.com/v1/3d/meshy-7.1 \
  -H "Authorization: Bearer $BUDGETPIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image": "https://example.com/character.png", "rigging": true, "animation": true, "animation_move": 591 }'
```

The finished job's `files` hold the model performing the move (`animation_glb`, `animation_fbx`),
the rigged model (`rigged_glb`, `rigged_fbx`), and a walk and a run (`walking_glb`, `running_glb`
and their FBX copies). The move costs nothing extra; without `animation_move` the character
performs move 92, Double Combo Attack.

## Pricing

Each model has a base price, and options such as detailed textures or rigging add to it.
[`GET /v1/models?type=3d`](https://docs.budgetpixel.com/api-reference/models/list-available-models) returns current
prices, and [`POST /v1/cost`](https://docs.budgetpixel.com/api-reference/models/estimate-the-cost-of-a-request) quotes
a request before you send it. You pay only for jobs that succeed; see
[Pricing & credits](https://docs.budgetpixel.com/concepts/pricing-and-credits.md).


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