For coding agents, discover the current recommended 3D shortlist first with
GET /v1/models?recommended_for=3d, then send the selected model explicitly to this endpoint.poll_url for status checks.
Public 3D operations are inferred from the request shape: prompt-only requests resolve to text-to-3d, and requests with image or image_url resolve to image-to-3d. This endpoint does not expose an operation request field; do not send the legacy 3d-generation value.
Request Body
string
default:"tripo-h3.1"
Model to use, for example
tripo-h3.1 or tripo-p1.0. Query GET /v1/models?recommended_for=3d before relying on a specific input type or output format.string
required
Text description of the 3D model to generate.
string
Base64-encoded image for image-to-3D generation.
string
URL of image for image-to-3D generation.
string
default:"glb"
Output format:
glb, fbx, obj, or usdz.string
default:"standard"
Quality level:
draft, standard, or high.string
Style preset for the model.
integer
Seed for reproducible generation.
string
A unique identifier for the end-user.
Response
string
Task ID for polling status.
string
Async task identifier alias when returned by the adapter.
string
Preferred polling URL for this task when provided.
string
Task status:
pending, processing, completed, or failed.integer
Unix timestamp of task creation.