Tripo P2

3D AI Studio

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.

Request
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
  }'
Response
{
  "task_id": "a7b8c9d0-e1f2-3456-0123-567890123456",
  "created_at": "2026-09-21T12:00:00Z"
}

Text to 3D Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes—Text description of the 3D model. Max 1024 characters.
negative_promptstringNo—What to avoid in the generation. Max 255 characters.
image_seedintegerNorandomSeed for the internal image generation stage. For reproducible results.
model_seedintegerNorandomSeed for the 3D model generation stage.
face_limitintegerNoadaptiveTarget polygon count: 48–50,000 triangles, or 48–25,000 with quad=true. Omit for an adaptive budget.
quadbooleanNofalseOutput 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.
texturebooleanNotrueGenerate textures. Adds 20 credits (fast / standard), 40 (detailed) or 60 (extreme).
pbrbooleanNotrueGenerate PBR material maps (metallic, roughness, normal).
texture_qualitystringNo"standard"Texture quality: "fast" (texture_model "3.5" only, same cost as standard), "standard", "detailed" or "extreme".
texture_modelstringNo"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_seedintegerNorandomSeed for reproducible texture generation.
auto_sizebooleanNofalseScale 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.

Request
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
  }'
Response
{
  "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.

ParameterTypeRequiredDefaultDescription
imagefileConditional—Base64-encoded image (data:image/...;base64,...). Required if image_url is not provided.
image_urlstringConditional—URL to a publicly accessible image. Required if image is not provided.
texture_alignmentstringNo"original_image"How textures align to the model: "original_image" or "geometry".
orientationstringNo"default"Model orientation: "default" or "align_image" to match the input image viewpoint.
lighting_removalbooleanNotruetexture_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_autofixbooleanNofalseAutomatically 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.

Request
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"
  }'
Response
{
  "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.

ParameterTypeRequiredDefaultDescription
imagesarrayYes—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_alignmentstringNo"original_image"How textures align to the model: "original_image" or "geometry".
orientationstringNo"default"Model orientation: "default" or "align_image" to match the input viewpoint.
lighting_removalbooleanNotruetexture_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.

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

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.

EndpointBase Cost+ Texture (fast / standard)+ Texture (detailed)+ Texture (extreme)
Text to 3D200+20+40+60
Image to 3D200+20+40+60
Multiview to 3D200+20+40+60

Credit Examples

ConfigurationTotal Credits
P2 Text-to-3D, default (texture standard)220
P2 Text-to-3D, texture_model 3.5 + fast texture220
P2 Text-to-3D, detailed texture240
P2 Image-to-3D, default (texture standard)220
P2 Image-to-3D, quad output, standard texture220
P2 Image-to-3D, extreme texture260
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.

FeatureP1P2
Face limit range50–20,00048–50,000 (48–25,000 with quad=true)
Quad mesh outputNot availablequad=true (free, delivered as FBX)
Texture modelFixed"3.0" (default) or "3.5" (newest, experimental)
"fast" texture qualityNot availableWith texture_model "3.5"
lighting_removalNot availableWith texture_model "3.5" (image / multiview)
export_uvAvailableNot accepted (the provider's UV setting breaks P2 output)
compressAccepted (no effect)Not accepted
Base cost (text / image / multiview)60 / 80 / 80200 / 200 / 200

Errors

Common errors for Tripo P2 generation endpoints.

StatusError CodeDescription
400VALIDATION_FAILEDMissing 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).
401INVALID_API_KEYInvalid or missing API key.
402INSUFFICIENT_CREDITSNot enough credits. Purchase more credits.
429RATE_LIMITEDRate limit exceeded. Wait and retry.