Tripo P2
Tripo P2 game-ready model API reference. Next-generation P Series text-to-3D, image-to-3D, and multiview-to-3D with native quad mesh output and an optional newest-generation texture model.

Overview
Tripo P2 is the next generation of the P Series (the successor to P1): game-ready topology with efficient polygon budgets, native quad mesh output, and an opt-in newest texture model. P2 has dedicated endpoints separate from the v3.0/v3.1/v3.2 models and from P1.
Text to 3D
POST/v1/3d-models/tripo/text-to-3d/p2/
Generate a game-ready 3D model from a text prompt using the Tripo P2 model. Base cost is 200 credits plus texture options.
curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/text-to-3d/p2/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a stylized wooden treasure chest with iron bands",
"texture": true,
"pbr": true,
"texture_quality": "standard",
"face_limit": 10000
}'{
"task_id": "a7b8c9d0-e1f2-3456-0123-567890123456",
"created_at": "2026-09-21T12: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 | adaptive | Target polygon count: 48–50,000 triangles, or 48–25,000 with quad=true. Omit for an adaptive budget. |
| quad | boolean | No | false | Output a quad mesh (four-sided polygons) instead of triangles. No extra cost. The result is delivered as an FBX file (glTF cannot represent quads) — see Checking Status. |
| texture | boolean | No | true | Generate textures. Adds 20 credits (fast / standard), 40 (detailed) or 60 (extreme). |
| pbr | boolean | No | true | Generate PBR material maps (metallic, roughness, normal). |
| texture_quality | string | No | "standard" | Texture quality: "fast" (texture_model "3.5" only, same cost as standard), "standard", "detailed" or "extreme". |
| texture_model | string | No | "3.0" | Texture model: "3.0" (default, proven) or "3.5" (newest texturing pass, experimental, same cost). "3.5" unlocks texture_quality="fast" and lighting_removal. |
| texture_seed | integer | No | random | Seed for reproducible texture generation. |
| auto_size | boolean | No | false | Scale the model to approximate real-world dimensions (meters). |
Image to 3D
POST/v1/3d-models/tripo/image-to-3d/p2/
Generate a game-ready 3D model from a single reference image using the P2 model. Base cost is 200 credits plus texture options.
curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/image-to-3d/p2/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/reference.png",
"texture": true,
"pbr": true,
"texture_model": "3.5",
"texture_quality": "fast",
"lighting_removal": true,
"quad": true
}'{
"task_id": "b8c9d0e1-f2a3-4567-1234-678901234567",
"created_at": "2026-09-21T12:00:00Z"
}Image to 3D Parameters
Accepts all shared P2 parameters from the Text to 3D table above (except prompt, negative_prompt, and image_seed), plus the following image-specific parameters.
Provide the input image in one of two ways: a public URL via image_url, or the raw image inline as a base64 data URI via image. Send exactly one of the two — not both.
| 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. |
| lighting_removal | boolean | No | true | texture_model "3.5" only. Removes baked-in lighting from the reference image before texturing. Set false to keep the image's original shading. Rejected with texture_model "3.0". |
| enable_image_autofix | boolean | No | false | Automatically enhance low-resolution or low-quality input images before generation. |
Multiview to 3D
POST/v1/3d-models/tripo/multiview-to-3d/p2/
Generate a game-ready 3D model from 2–4 reference images using the P2 model. Images are positional: front, left, back, right (front is required). Base cost is 200 credits plus texture options.
curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/multiview-to-3d/p2/ \
-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/left.png" },
{ "image_url": "https://example.com/back.png" },
{ "image_url": "https://example.com/right.png" }
],
"texture": true,
"orientation": "align_image"
}'{
"task_id": "c9d0e1f2-a3b4-5678-2345-789012345678",
"created_at": "2026-09-21T12:00:00Z"
}Multiview to 3D Parameters
Accepts all shared P2 parameters from the Text to 3D table above (except prompt, negative_prompt, and image_seed), plus the following multiview-specific parameters.
For each entry in images, provide the image in one of two ways: a public URL via image_url, or the raw image inline as a base64 data URI via image. Send exactly one of the two per entry — not both.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| images | array | Yes | — | Array of 2–4 image objects in the order front, left, back, right. 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. |
| lighting_removal | boolean | No | true | texture_model "3.5" only. Removes baked-in lighting from the reference images before texturing. Rejected with texture_model "3.0". |
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 model: a GLB file by default, or an FBX file when quad=true (the quad topology cannot be stored in glTF). Results expire after 24 hours.
curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"{
"status": "FINISHED",
"progress": 100,
"failure_reason": null,
"results": [
{
"asset": "https://storage.3daistudio.com/assets/model.glb",
"asset_type": "3D_MODEL",
"metadata": null
}
]
}Credit Costs
P2 has a flat base cost of 200 credits for text, image and multiview input, reflecting the model's higher generation cost. Only texture options affect the price on top of that — quad output, the texture model choice and lighting_removal are free. Credits are deducted on submission and refunded automatically on failure.
| Endpoint | Base Cost | + Texture (fast / standard) | + Texture (detailed) | + Texture (extreme) |
|---|---|---|---|---|
| Text to 3D | 200 | +20 | +40 | +60 |
| Image to 3D | 200 | +20 | +40 | +60 |
| Multiview to 3D | 200 | +20 | +40 | +60 |
Credit Examples
| Configuration | Total Credits |
|---|---|
| P2 Text-to-3D, default (texture standard) | 220 |
| P2 Text-to-3D, texture_model 3.5 + fast texture | 220 |
| P2 Text-to-3D, detailed texture | 240 |
| P2 Image-to-3D, default (texture standard) | 220 |
| P2 Image-to-3D, quad output, standard texture | 220 |
| P2 Image-to-3D, extreme texture | 260 |
| P2 Multiview-to-3D, default (texture standard) | 220 |
| P2 Text-to-3D, geometry only (texture=false) | 200 |
Differences from P1
P2 is a drop-in upgrade of P1 with the same request shape; these are the differences.
| Feature | P1 | P2 |
|---|---|---|
| Face limit range | 50–20,000 | 48–50,000 (48–25,000 with quad=true) |
| Quad mesh output | Not available | quad=true (free, delivered as FBX) |
| Texture model | Fixed | "3.0" (default) or "3.5" (newest, experimental) |
| "fast" texture quality | Not available | With texture_model "3.5" |
| lighting_removal | Not available | With texture_model "3.5" (image / multiview) |
| export_uv | Available | Not accepted (the provider's UV setting breaks P2 output) |
| compress | Accepted (no effect) | Not accepted |
| Base cost (text / image / multiview) | 60 / 80 / 80 | 200 / 200 / 200 |
Errors
Common errors for Tripo P2 generation endpoints.
| Status | Error Code | Description |
|---|---|---|
| 400 | VALIDATION_FAILED | Missing or invalid parameters — including texture_quality="fast" or lighting_removal without texture_model "3.5", and face_limit outside the P2 range (or above 25,000 with quad=true). |
| 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. |