Skip to main content
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.
Generate 3D models from text or images using Tripo3D and other providers. This is an asynchronous API. Create responses return a task identity, and may also return a preferred 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.