Tripo P1

Tripo P1 premium model API reference. Higher-fidelity text-to-3D, image-to-3D, and multiview-to-3D generation with orientation control and fine-grained face limits.

Overview

Tripo P1 is the premium generation model, offering higher-fidelity 3D output with additional controls like model seed, image seed, and orientation alignment. P1 has dedicated endpoints separate from the v3.0/v3.1 models.

Text to 3D

POST

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

Generate a high-fidelity 3D model from a text prompt using the Tripo P1 model. Base cost is 60 credits plus texture options.

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/text-to-3d/p1/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a detailed medieval castle with towers and drawbridge",
    "texture": true,
    "pbr": true,
    "texture_quality": "standard",
    "face_limit": 10000
  }'

Response

{
  "task_id": "d4e5f6a7-b8c9-0123-def0-234567890123",
  "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. Max 1024 characters.
negative_prompt	string	No	—	What to avoid in the generation. Max 255 characters.
image_seed	integer	No	random	Seed for the internal image generation stage. For reproducible results.
model_seed	integer	No	random	Seed for the 3D model generation stage.
face_limit	integer	No	—	Target polygon count (48–20,000).
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.
auto_size	boolean	No	false	Automatically determine model size.
export_uv	boolean	No	true	Export UV coordinates.
compress	string	No	—	Compression mode. Only option: "geometry".

Image to 3D

POST

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

Generate a high-fidelity 3D model from a single reference image using the P1 model. Supports orientation alignment for consistent model orientation. Base cost is 80 credits plus texture options.

Request

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

Response

{
  "task_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
  "created_at": "2026-03-26T12:00:00Z"
}

Image to 3D Parameters

Accepts all shared P1 parameters from the Text to 3D table above (except prompt, negative_prompt, and image_seed), 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".
orientation	string	No	"default"	Model orientation: "default" or "align_image" to match the input image viewpoint.
enable_image_autofix	boolean	No	false	Automatically fix image issues before generation.

Multiview to 3D

POST

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

Generate a high-fidelity 3D model from 2–4 reference images using the P1 model. Base cost is 80 credits plus texture options.

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/multiview-to-3d/p1/ \
  -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" },
      { "image_url": "https://example.com/top.png" }
    ],
    "texture": true,
    "orientation": "align_image"
  }'

Response

{
  "task_id": "f6a7b8c9-d0e1-2345-f012-456789012345",
  "created_at": "2026-03-26T12:00:00Z"
}

Multiview to 3D Parameters

Accepts all shared P1 parameters from the Text to 3D table above (except prompt, negative_prompt, and image_seed), 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".
orientation	string	No	"default"	Model orientation: "default" or "align_image" to match the input viewpoint.

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/model.glb",
      "asset_type": "3D_MODEL",
      "metadata": null
    }
  ]
}

Credit Costs

P1 models have a higher base cost reflecting the premium quality. Credits are deducted on submission and refunded automatically on failure.

Endpoint	Base Cost	+ Texture (standard)	+ Texture (detailed)	+ Detailed quality bonus
Text to 3D	60	+20	+40	+20
Image to 3D	80	+20	+40	+20
Multiview to 3D	80	+20	+40	+20

Credit Examples

Configuration	Total Credits
P1 Text-to-3D, default (texture standard)	80
P1 Text-to-3D, detailed texture	140
P1 Image-to-3D, default (texture standard)	100
P1 Image-to-3D, detailed texture	160
P1 Multiview-to-3D, default (texture standard)	100
P1 Text-to-3D, geometry only (texture=false)	60

Differences from v3.0/v3.1

The P1 model differs from v3.0/v3.1 in several ways.

Feature	v3.0 / v3.1	P1
Face limit range	500–500,000	48–20,000
Model seed	Not available	Available
Image seed (text-to-3D)	Not available	Available
Orientation control	Not available	"default" or "align_image"
Smart low-poly	Available	Not available
Generate parts	Available	Not available
Quad remeshing	Available	Not available
Geometry quality	"standard" or "detailed"	Not available

Errors

Common errors for Tripo P1 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.