Tripo

Tripo 3D generation API reference. Text-to-3D, image-to-3D, and multiview-to-3D with models v3.0 and v3.1. GLB output with optional PBR textures, quad remeshing, and smart low-poly.

Text to 3D

POST

/v1/3d-models/tripo/text-to-3d/

Generate a 3D model from a text prompt. Optionally specify model version 3.0 or 3.1 by appending it to the URL (e.g. /text-to-3d/3.1/). Defaults to 3.0 when omitted.

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/text-to-3d/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a medieval sword with ornate handle",
    "texture": true,
    "pbr": true,
    "texture_quality": "standard"
  }'

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-03-26T12:00:00Z"
}

Text to 3D Parameters

Parameter	Type	Required	Default	Description
prompt	string	Yes	—	Text description of the 3D model to generate. Max 1024 characters.
negative_prompt	string	No	—	Text describing what to avoid in the generation. Max 1024 characters.
texture	boolean	No	true	Generate textures. Adds 20 credits (standard) or 40 credits (detailed).
pbr	boolean	No	true	Generate PBR material maps.
texture_quality	string	No	"standard"	Texture quality: "standard" or "detailed". Detailed adds 20 credits.
texture_seed	integer	No	random	Seed for reproducible texture generation.
geometry_quality	string	No	"standard"	Geometry quality: "standard" or "detailed". Detailed adds 40 credits.
face_limit	integer	No	—	Target polygon count (500–500,000).
quad	boolean	No	false	Enable quad remeshing. Adds 10 credits. Not compatible with generate_parts.
smart_low_poly	boolean	No	false	Intelligent low-poly optimization. Adds 20 credits.
generate_parts	boolean	No	false	Generate segmented parts. Adds 40 credits. Requires texture=false and pbr=false.
export_uv	boolean	No	true	Export UV coordinates.
auto_size	boolean	No	false	Automatically determine model size.
compress	string	No	—	Compression mode. Only option: "geometry".

Image to 3D

POST

/v1/3d-models/tripo/image-to-3d/

Generate a 3D model from a single reference image. Provide either a base64-encoded image or a publicly accessible URL. Optionally append model version to the URL (e.g. /image-to-3d/3.1/).

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/image-to-3d/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/reference.png",
    "texture": true,
    "pbr": true,
    "texture_alignment": "original_image"
  }'

Response

{
  "task_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "created_at": "2026-03-26T12:00:00Z"
}

Image to 3D Parameters

Accepts all shared generation parameters from the Text to 3D table above, plus the following image-specific parameters.

Parameter	Type	Required	Default	Description
image	file	Conditional	—	Base64-encoded image (data:image/...;base64,...). Required if image_url is not provided.
image_url	string	Conditional	—	URL to a publicly accessible image. Required if image is not provided.
texture_alignment	string	No	"original_image"	How textures align to the model: "original_image" or "geometry".
enable_image_autofix	boolean	No	false	Automatically fix image issues before generation.

Multiview to 3D

POST

/v1/3d-models/tripo/multiview-to-3d/

Generate a 3D model from 2–4 reference images taken from different angles. Optionally append model version to the URL (e.g. /multiview-to-3d/3.1/).

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/multiview-to-3d/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      { "image_url": "https://example.com/front.png" },
      { "image_url": "https://example.com/side.png" },
      { "image_url": "https://example.com/back.png" }
    ],
    "texture": true,
    "texture_alignment": "original_image"
  }'

Response

{
  "task_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "created_at": "2026-03-26T12:00:00Z"
}

Multiview to 3D Parameters

Accepts all shared generation parameters from the Text to 3D table above, plus the following multiview-specific parameters.

Parameter	Type	Required	Default	Description
images	array	Yes	—	Array of 2–4 image objects. Each object must contain either image (base64) or image_url (public URL).
texture_alignment	string	No	"original_image"	How textures align to the model: "original_image" or "geometry".

Model Versions

Tripo offers two model versions for generation. Specify the version by appending it to the endpoint URL. If omitted, defaults to 3.0.

Version	URL Suffix	Description
3.0	/text-to-3d/ or /text-to-3d/3.0/	Default model. Stable and well-tested.
3.1	/text-to-3d/3.1/	Newer model with improved quality.

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the generation response. When status is "FINISHED", the results array contains a download URL for your GLB model. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "failure_reason": null,
  "results": [
    {
      "asset": "https://storage.3daistudio.com/assets/abc123.glb",
      "asset_type": "3D_MODEL",
      "metadata": null
    }
  ]
}

Credit Costs

Credits are calculated based on selected options. With default settings (texture enabled, standard quality), the base cost is 20 credits. Credits are deducted when you submit a request. If generation fails, credits are refunded automatically.

Option	Credits	Condition
texture (standard)	+20	texture=true, texture_quality="standard"
texture (detailed)	+40	texture=true, texture_quality="detailed"
texture_quality detailed	+20	texture_quality="detailed"
geometry_quality detailed	+40	geometry_quality="detailed"
smart_low_poly	+20	smart_low_poly=true
generate_parts	+40	generate_parts=true
quad	+10	quad=true

Credit Examples

Configuration	Total Credits
Default (texture=true, standard quality)	20
Detailed texture + detailed geometry	120
Standard texture + quad remeshing	30
Standard texture + smart low-poly	40
Geometry only (texture=false)	0

Errors

Common errors for Tripo generation endpoints.

Status	Error Code	Description
400	VALIDATION_FAILED	Missing or invalid parameters.
401	INVALID_API_KEY	Invalid or missing API key.
402	INSUFFICIENT_CREDITS	Not enough credits. Purchase more credits.
429	RATE_LIMITED	Rate limit exceeded. Wait and retry.