Tripo

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

Generate a 3D model from a text prompt. Optionally specify model version 3.0, 3.1 or 3.2 by appending it to the URL (e.g. /text-to-3d/3.2/). 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.

Three model versions are available for generation. Specify the version by appending it to the endpoint URL. If omitted, defaults to 3.0 for backwards compatibility — new integrations should use 3.2.

/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 the 3.0, 3.1 and 3.2 generation endpoints.

P Series endpoints have a simpler surcharge structure. Only texture options affect the cost; P2's quad output and texture_model choice are free. See the dedicated Tripo P1 and Tripo P2 pages for the full parameter sets.

Additional surcharges for Texture Model and Convert Model endpoints.

Common errors for Tripo generation endpoints.