3D AI Studio Guide

A complete guide to 3D AI Studio — the AI-powered platform for creating stunning 3D models and content.

What is 3D AI Studio?

3D AI Studio is an AI-powered 3D content creation platform that lets you generate high-quality 3D models, textures, and scenes from text descriptions or images. No 3D modeling experience required — just describe what you want and let AI do the work.

Tech Stack

AI Models: State-of-the-art generative AI for 3D content
Framework: Next.js App Router with TypeScript
Auth: Better Auth (GitHub + Google OAuth, email/password)
Database: PostgreSQL with Drizzle ORM
Payments: Stripe (subscriptions, one-time purchases, credit packages)
UI: Tailwind CSS + Radix UI + Lucide icons
i18n: next-intl (English + Chinese)
Email: Resend with React Email templates
Content: Fumadocs for documentation, MDX for blog

Quick Start

Prerequisites

Node.js 18+
pnpm (recommended)
PostgreSQL database

Installation

git clone https://github.com/zhangst23/3d-ai-studio.git
cd 3d-ai-studio
pnpm install

Environment Setup

Copy the example environment file and fill in your values:

cp env.example .env.local

Key environment variables:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/3d-ai-studio

# Auth
BETTER_AUTH_SECRET=your-secret-key
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret

# Stripe
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# Email
RESEND_API_KEY=re_...

Database Setup

Generate and run migrations:

pnpm db:generate
pnpm db:migrate

Start Development

pnpm dev

Visit http://localhost:3000 to see your app.

Key Features

AI 3D Generation

Generate 3D models from text or images:

Text to 3D: Describe any object, character, or scene in natural language
Image to 3D: Upload reference photos to create textured 3D models
PBR Textures: Automatically generated physically-based rendering materials
Scene Composition: Generate complete 3D environments

Multi-format Export

Export your creations in any format:

OBJ — Universal 3D format
FBX — Autodesk standard for animation
GLB/GLTF — Web-ready 3D format for Three.js
USDZ — Apple AR and Unreal Engine
STL — 3D printing ready

Tool Integrations

Seamless workflow with popular 3D tools:

Blender — Direct import with full material support
Unity — Optimized meshes with LOD generation
Unreal Engine — PBR materials and Nanite support
Godot — Native integration for indie game dev

Credit System

Flexible usage-based billing:

Monthly credit refresh for subscribers
Registration bonus credits
Credit packages for additional generations
Usage tracking with transaction history

Supported Use Cases

Game Development — Game-ready 3D assets with optimized topology
Product Visualization — Photorealistic 3D product models for e-commerce
Architecture & Design — Rapid prototyping of architectural concepts
Film & Animation — Pre-production 3D props and environments
3D Printing — Print-ready STL models with proper wall thickness
Education — 3D educational models for science and engineering

API Integration

3D AI Studio provides a REST API for programmatic 3D generation:

# Generate a 3D model from text
POST /api/v1/generate
{
  "prompt": "A medieval stone castle with towers",
  "quality": "high",
  "format": "glb"
}

API keys can be managed from your dashboard under Settings → API Keys.

Common Tasks

Adding a New Page

Create a new file in src/app/[locale]/(marketing)/
Add the route to src/routes.ts
Add navigation links in src/config/navbar-config.tsx

Deploying to Production

pnpm build

The app is ready for deployment on Vercel, Docker, or any Node.js hosting platform.

Learn More

Configuration Guide — Customize the platform for your needs
API Reference — Explore available endpoints and actions