Getting Started

Getting Started

API

MCP Server

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/v1

Authentication

All requests require an API key via Bearer token in the Authorization header:

Authorization: Bearer tr_your_api_key_here

API 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"

Next Steps

Authentication

Learn how API keys work

Available Models

Explore the model options

Quickstart

Full step-by-step guide

API Reference

Interactive try-it-out playground

Table of Contents

API Overview
Key Features
Base URL
Authentication
Quick Example
Next Steps