API Overview
3D Model Generator API — programmatic access to image-to-3D generation
API Overview
The 3D Model Generator API allows you to convert images into 3D models (GLB format) programmatically.
Key Features
- Image-to-3D: Send one or more images, receive a downloadable 3D model
- Multiple Models: Choose from optimized pipelines (Trellis2, Tripo, Tripo Multi-View)
- Sync & Async: Wait for results or poll at your own pace
- Credit-Based: Transparent, pay-per-use billing via credits
Base URL
https://trellis2.app/api/v1Authentication
All requests require an API key via Bearer token in the Authorization header:
Authorization: Bearer tr_your_api_key_hereAPI keys start with the tr_ prefix. Create and manage your keys in the API Keys settings.
Quick Example
# Create a 3D generation task (async mode)
curl -X POST https://trellis2.app/api/v1/3d/generations \
-H "Authorization: Bearer tr_your_key" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/chair.jpg",
"model": "trellis2",
"mode": "async"
}'
# Response: 202 Accepted
# {
# "id": "task_abc123",
# "object": "task",
# "status": "pending",
# "created": 1723000000,
# "data": null
# }
# Poll for completion
curl https://trellis2.app/api/v1/tasks/task_abc123 \
-H "Authorization: Bearer tr_your_key"