Tripo

/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.

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"
  }'

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

/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/).

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"
  }'

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

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

/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/).

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"
  }'

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

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

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

/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.

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

Every request has a base cost determined by the endpoint and model tier, plus surcharges for selected options. Credits are deducted when you submit a request. If generation fails, credits are refunded automatically.

These surcharges are added on top of the base cost for v3.0 and v3.1 generation endpoints.

P1 endpoints have a simpler surcharge structure. Only texture options affect the cost.

Additional surcharges for Texture Model and Convert Model endpoints.

Common errors for Tripo generation endpoints.