Trellis - 3D Image Generator

Generate professional-grade 3D models from single 2D images using Trellis's state-of-the-art neural reconstruction technology. Create detailed GLB files with accurate geometry, preserved textures, and industry-standard formatting for seamless integration into 3D workflows, AR/VR applications, and real-time rendering engines.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	`<api-key>`
Content-Type	`application/json`

Parameters

Parameter	Type	Required	Description
`type`	string	Yes	Feature type identifier. Must be `IMAGE_3D_GENERATOR`
`model`	string	Yes	AI model identifier. Must be `Qubico/trellis`
`promptObject`	object	Yes	Configuration object containing all 3D model generation parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
`imageUrl`	string	Yes	Path to the 2D source image to be reconstructed into a 3D model	-

Supported Input Formats

Format	Description	Best For
`jpeg`	Standard photographic format	Photographs, product images, portraits
`png`	Lossless format with transparency support	Graphics, illustrations, objects with transparency
`webp`	Modern efficient format	Web-optimized images, mixed content types

GLB Output Specifications

Feature	Description
Format	GLB (GL Transmission Format Binary) - industry standard
Compatibility	WebGL, Three.js, Unity, Unreal Engine, Blender, and most 3D software
Content	Complete 3D model with geometry, materials, textures, and metadata
Optimization	Web-ready with efficient compression for real-time rendering
Structure	Self-contained binary file with all assets embedded

Image Requirements

Requirement	Description
Resolution	Minimum 512x512 pixels, recommended 1024x1024+ for detailed models
Subject Clarity	Clear, well-defined objects with distinct boundaries
Lighting	Even, diffused lighting without harsh shadows or extreme contrasts
Background	Simple, uncluttered backgrounds for better subject isolation
Perspective	Front-facing or 3/4 view angles provide optimal reconstruction data

Code Examples

cURL
JavaScript
Python

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_3D_GENERATOR",
"model": "Qubico/trellis",
"promptObject": {
  "imageUrl": "development/images/2025_10_27_16_40_04_213_dress.png"
}
}'

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_3D_GENERATOR',
  model: 'Qubico/trellis',
  promptObject: {
    imageUrl: 'development/images/2025_10_27_16_40_04_213_dress.png'
  }
})
})

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_3D_GENERATOR",
"model": "Qubico/trellis",
"promptObject": {
  "imageUrl": "development/images/2025_10_27_16_40_04_213_dress.png"
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

https://api.1min.ai/api/features

AI Model *

Source Image URL *

Path to the 2D image to be converted into a 3D GLB model

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "IMAGE_3D_GENERATOR",
  "model": "Qubico/trellis",
  "promptObject": {
    "imageUrl": "development/images/2025_10_27_16_40_04_213_dress.png"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "t3d1l2s3-m4o5-6789-def0-123456789abc",
  "userId": "user-12345",
  "teamId": "team-67890",
  "teamUser": {
    "teamId": "team-67890",
    "userId": "user-12345",
    "userName": "John Doe",
    "userAvatar": "https://example.com/avatar.jpg",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 55000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-01-15T15:00:00.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "Qubico/trellis",
  "type": "IMAGE_3D_GENERATOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-01-15T15:00:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/2025_10_27_16_40_04_213_dress.png"
    },
    "resultObject": [
      "development/models/2025_01_15_15_01_20_001_3d_model.glb"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/models/2025_01_15_15_01_20_001_3d_model.glb?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20250115T150000Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

Professional 3D Development

Game Asset Creation: Generate 3D models from concept art for game development pipelines
Architectural Visualization: Convert architectural sketches into 3D models for presentations
Product Prototyping: Create 3D prototypes from product photographs for design validation
Animation Pre-production: Generate reference 3D models for animation and rigging workflows
VFX Reference: Create 3D assets for visual effects and compositing work

E-commerce & Retail

Product Visualization: Transform product photos into interactive 3D models for online stores
Virtual Showrooms: Create immersive shopping experiences with 3D product catalogs
AR Shopping: Generate AR-ready models for virtual try-on and placement applications
Inventory Management: Create 3D representations for digital inventory systems
Marketing Campaigns: Develop engaging 3D content for advertising and social media

Manufacturing & Design

Reverse Engineering: Generate 3D models from photographs for manufacturing reference
Quality Control: Create 3D standards from product images for comparison and inspection
Design Documentation: Convert design sketches into 3D technical documentation
Prototype Development: Generate initial 3D models for rapid prototyping workflows
Training Materials: Create 3D training assets from existing product documentation

Education & Research

Scientific Modeling: Convert scientific specimens and artifacts into 3D educational models
Historical Preservation: Create 3D archives of historical objects and artifacts
Interactive Learning: Develop 3D educational content from 2D reference materials
Research Documentation: Generate 3D models for academic research and publication
Virtual Museums: Create digital 3D collections from photographic archives

Entertainment & Media

Film Production: Generate 3D assets from concept art for movie and TV production
Virtual Production: Create 3D environments and props for virtual set extensions
Content Creation: Develop 3D content for YouTube, streaming, and social media
Interactive Media: Create 3D elements for interactive documentaries and experiences
Digital Art: Transform 2D artwork into immersive 3D installations and exhibitions

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Supported Input Formats​

GLB Output Specifications​

Image Requirements​

Code Examples​

Interactive Playground​