Authentication
How to authenticate API requests with API keys
Authentication
The 3D Model Generator API uses API keys for authentication. API keys are per-user, meaning they inherit your account's credit balance and subscription tier.
API Key Format
All API keys start with the tr_ prefix:
tr_a1b2c3d4e5f6...API keys are shown only once when created. Store them securely. If lost, you must create a new key.
Creating an API Key
- Navigate to Settings → API Keys
- Click Create Key
- Enter a descriptive name (e.g., "Production App")
- Copy the generated key immediately — it won't be shown again
Using Your API Key
Pass your API key as a Bearer token in the Authorization header:
curl https://trellis2.app/api/v1/models \
-H "Authorization: Bearer tr_your_key_here"Rate Limiting
Each API key has built-in rate limiting:
| Tier | Rate Limit |
|---|---|
| Free | 5 requests/minute |
| Pro | 20 requests/minute |
| Enterprise | Unlimited |
When rate limited, the API returns a 429 status code:
{
"error": {
"message": "Rate limit exceeded",
"type": "rate_limit_error"
}
}Deleting a Key
You can delete an API key at any time from Settings → API Keys. Deleted keys immediately stop working.
Deleting a key does not cancel in-progress tasks. They will continue to completion.