---
title: "Create a 3D model from image upload, sprite ID, or text prompt"
method: POST
path: "/v1/models-3d"
tags: ["3D Studio"]
---

# Create a 3D model from image upload, sprite ID, or text prompt

`POST /v1/models-3d`

## Request

- Base URL: `https://api.sprixen.com`
- URL: `https://api.sprixen.com/v1/models-3d`
- Auth: `bearer` (a scheme the document does not define)

Dispatches async job to the TRELLIS GPU server. Cost: 5 credits. Poll GET /models-3d/:id for status. When status=completed, modelUrl holds the GLB URL.

## Request body

- object
  - `image` string, binary: Source image (PNG/JPG/WebP, max 10 MB)
  - `projectId` string
  - `prompt` string
  - `spriteId` string
  - `name` string

## Response `201`

3D model job created (pending)

## Other responses

- `400`: Invalid input or rate limit exceeded
- `402`: Insufficient credits
- `403`: Access denied to project or sprite
- `404`: Project or sprite not found

---

[API](https://skmtc.dev/sprixen/apis/sprixen-api.md) · [All operations](https://skmtc.dev/sprixen/apis/sprixen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sprixen/apis/sprixen-api/revisions/6c0c57f6da58?raw)