3D
Create 3D Model
Creates a 3D model generation task
Use GET /v1/models?recommended_for=3d to get current 3D models.
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
Before sending optional fields, check GET /v1/models/{model} for the model’s accepted parameters. The example uses only model and prompt.
tripo-h3.1Model 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.
Text description of the 3D model to generate.
Base64-encoded image for image-to-3D generation.
URL of image for image-to-3D generation.
Output format; support and allowed values depend on the selected model.
Quality setting; support and allowed values depend on the selected model.
Style preset for the model.
Integer seed, when supported by the selected model.
A unique identifier for the end-user.
Response
Task ID for polling status.
Async task identifier alias when returned by the adapter.
Preferred polling URL for this task when provided.
Task status: pending, processing, completed, or failed.
Unix timestamp of task creation.
Request
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'Response
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Authorization
BearerAuth API Key authentication. Create or manage API keys in Dashboard > API > API Keys.
In: header
Headers
Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, request acceptance, or persistent resource creation.
Value in
- "auto"
- "verified"
- "official"
Request Body
application/json
Response
application/json
application/json