Getting Started

Getting Started

API

MCP Server

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

  1. Navigate to Settings → API Keys
  2. Click Create Key
  3. Enter a descriptive name (e.g., "Production App")
  4. 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:

TierRate Limit
Free5 requests/minute
Pro20 requests/minute
EnterpriseUnlimited

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.

Table of Contents

Authentication
API Key Format
Creating an API Key
Using Your API Key
Rate Limiting
Deleting a Key