Skip to main content
POST
Generate a 3D model with Tripo H3.1

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
image
string
required

The picture to turn into a 3D model: a public URL, a data URI, raw base64, or a URL from POST /v1/uploads. One subject on a plain or transparent background works best.

detailed_geometry
boolean
default:false

Finer shape detail (+270 credits).

texture
boolean
default:true

Paint the model (true) or return the plain shape (false, 270 credits).

texture_quality
enum<string>
default:standard

detailed: higher-resolution textures (540 credits instead of 400).

Available options:
standard,
detailed

Response

Job accepted.

credits
integer

Credits this job will charge on success (held until it finishes).

id
string

Opaque job id — use it to poll status.

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout