About Tripo P1
Turn a toy or prop photo into a compact, clean low-poly mesh.
Call it with the model name tripo/p1/image-to-3d on POST /jobs/createTask, from $0.72.
Introduction
Tripo P1, also called Smart Mesh P1.0, is Tripo AI’s image-to-3D model for clean, low-polygon objects. It builds a mesh directly from a picture, with a target range of 50–20,000 faces. The emphasis is a manageable shape for games, mobile scenes and user-created props, with optional textures packed into a GLB.
tripo/p1/image-to-3d
Request parameters
| Parameter | Required | Description |
|---|---|---|
auto_size | No | Scale the mesh to estimated real-world dimensions. Off by default. Default: false |
face_limit | No | Target face count, 1,000 to 2,000,000. Leave empty to let the model decide (often over a million faces). ≥ 50 · ≤ 20000 |
generate_pbr | No | Add PBR material maps (metal-roughness and normal). On by default and switches texturing on. Default: true |
generate_texture | No | Paint a texture onto the mesh. On by default; turning it off only removes texturing if generate_pbr is off too. Default: true |
image_autofix | No | Clean up a blurry, noisy or low-resolution picture before generation. Slower. Default: false |
image_url | Yes | The picture to start from. |
model_orientation | No | default keeps the standard orientation; align_image rotates the model to match the picture. default · align_image · Default: default |
remove_lighting | No | Remove the lighting and shadows baked into the picture before texturing, so the texture reacts cleanly to scene lights. On by default; only takes effect with the v3.5 texture model. Default: true |
seed | No | Use the same seed and settings for more controlled comparisons. ≥ 0 · ≤ 2147483647 |
texture_alignment | No | Align the texture to the original picture (the default) or to the generated geometry. original_image · geometry · Default: original_image |
texture_quality | No | Texture resolution: standard (the default) or detailed. detailed costs more and only applies to textured meshes. standard · detailed · extreme · fast · Default: standard |
texture_seed | No | Seed for the texture step. Keep seed fixed and change this to try new textures on the same shape. ≥ 0 · ≤ 2147483647 |
texture_version | No | Texture model version: v3.0-20250812 (the default) or the newer v3.5-20260815. texture_quality fast and remove_lighting use v3.5. v3.0-20250812 · v3.5-20260815 · Default: v3.0-20250812 |
uv_unwrap | No | Unwrap UV coordinates during generation. On by default; turning it off is faster and gives a smaller file, but the mesh then has no UVs for texturing later. Default: true |
Pricing
Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per run |
|---|---|
| Standard | $0.72 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
API quick start
Call the Tripo P1 API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
- Send the request. POST /jobs/createTask with model tripo/p1/image-to-3d and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/p1/image-to-3d",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"generate_texture": true,
"generate_pbr": true,
"texture_quality": "standard",
"texture_version": "v3.0-20250812",
"model_orientation": "default"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
Tripo P1 API questions
How much does the Tripo P1 API cost?
Tripo P1 costs $0.72 per run. The API uses a separate USD balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What is the model name for Tripo P1 in the API?
Put tripo/p1/image-to-3d for Image to 3D in the model field of POST /jobs/createTask.
Can P1 return a plain model?
Yes: disable generate_texture and generate_pbr together. Our boot test also disabled uv_unwrap, leaving neither materials nor UV coordinates.
Can I lock an exact result?
Seeds help compare settings while changing one thing at a time; they do not promise an identical mesh or texture.
What are the limits of the Tripo P1 API?
Largest upload: 10 MB. Requests outside these limits are rejected before anything is charged.
Can I try Tripo P1 without writing code?
Run Tripo P1 in the Playground with your API USD balance, without an API key. Each run appears in your developer history with its matching code.