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.

​
Request Body

​
model
string
default:"tripo3d-v2.5"
Model to use (e.g., tripo3d-v2.5, tripo3d-v2).
​
prompt
string
required
Text description of the 3D model to generate.
​
image
string
Base64-encoded image for image-to-3D generation.
​
image_url
string
URL of image for image-to-3D generation.
​
format
string
default:"glb"
Output format: glb, fbx, obj, or usdz.
​
quality
string
default:"standard"
Quality level: draft, standard, or high.
​
style
string
Style preset for the model.
​
seed
integer
Seed for reproducible generation.
​
user
string
A unique identifier for the end-user.

​
Response

​
id
string
Task ID for polling status.
​
task_id
string
Async task identifier alias when returned by the adapter.
​
poll_url
string
Preferred polling URL for this task when provided.
​
status
string
Task status: pending, processing, completed, or failed.
​
created
integer
Unix timestamp of task creation.
curl -X POST "https://api.lemondata.cc/v1/3d/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo3d-v2.5",
    "prompt": "A detailed medieval castle with towers",
    "format": "glb",
    "quality": "high"
  }'

{
  "id": "3d_abc123",
  "task_id": "3d_abc123",
  "poll_url": "/v1/3d/generations/3d_abc123",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo3d-v2.5"
}