Documentation - 3DCloud

Getting Started

3DCloud is a powerful platform that allows you to easily share, view, and manage your 3D models on the web. This guide contains all the information you need to get started with the platform.

First Steps

1

Create an Account

Sign up for free and access the dashboard. Activate your account with email verification.

2

Upload a 3D Model

We support popular formats like GLB, GLTF, OBJ, FBX, STL, DAE, 3DS, PLY, X3D, STEP, IGES. Upload via drag-and-drop or file picker.

3

Configure Settings

Customize background color, lighting, camera angle, and other viewing options.

4

Share or Embed

Add to your website with embed code or share directly with a link.

Tip: Start with the free plan to test the platform, then upgrade according to your needs later.

Model Upload

Uploading 3D models to 3DCloud is fast and easy. Learn about different upload methods and supported formats.

Upload Methods

Drag & Drop

Drag and drop your files directly to the upload area.

File Picker

Click to select files from your computer.

URL Upload

Import a 3D model from an external URL.

Upload Limits

Maximum file size: 50MB - 500MB depending on plan
Supported formats: GLB, GLTF, OBJ, FBX, STL, DAE, 3DS, PLY, X3D, STEP/STP, IGES/IGS, ZIP
Texture files: PNG, JPG, WebP (auto-detected)

Important: Prefer GLB format for best performance. GLB contains all textures in a single file and reduces upload time.

Embed & Widget

You can easily embed your 3D models on your website, blog, or e-commerce platform. Integrate in seconds with iframe code.

Basic Iframe Code

Add the following code to your website to display your 3D model:

HTML

<iframe
  src="https://3dcloud.com.tr/embed/MODEL_ID"
  width="100%"
  height="500"
  frameborder="0"
  allowfullscreen
  allow="autoplay; fullscreen; xr-spatial-tracking"
></iframe>

URL Parameters

Parameter	Type	Description
autoplay	boolean	Auto-start model when page loads
autorotate	boolean	Auto-rotate the model
ui	boolean	Show/hide control buttons
bg	string	Background color (hex code, without #)

Example Usage

HTML

<iframe
  src="https://3dcloud.com.tr/embed/abc123?autorotate=true&bg=f5f5f5"
  width="800"
  height="600"
  frameborder="0"
></iframe>

AI Model Generation

Transform your 2D photos into professional 3D models with 3DCloud's AI technology. Upload your product photos, get an interactive 3D model in seconds.

Generation Methods

Photo to 3D

Create 3D models by uploading single or multiple photos.

Text Description

Create AI-powered 3D models from text descriptions.

Generation Steps

1

Upload Photo

Upload a clear, well-lit photo of the object. Photos from different angles give better results.

2

Wait for AI Processing

Our AI model analyzes the photo and creates 3D geometry. This process usually takes 30-60 seconds.

3

Download or Share

Download the generated model in GLB format or share directly on 3DCloud.

Note: AI model generation is limited by monthly credits according to your subscription plan. You can track remaining credits from the dashboard.

Supported Formats

3DCloud supports most industry-standard 3D file formats. Uploaded files are automatically optimized and prepared for web viewing.

Supported Formats

.GLB

GL Binary

.GLTF

GL Transmission

.OBJ

Wavefront

.FBX

Filmbox

.STL

Stereolithography

.DAE

Collada

.3DS

3D Studio

.PLY

Polygon File

.X3D

X3D / VRML

.STEP

CAD STEP/STP

.IGES

CAD IGES/IGS

.ZIP

Model + Textures

Recommended Format: GLB

GLB (GL Binary) format is the most optimized format for the web and offers the following advantages:

Contains all textures and materials in a single file
Compressed file size
Fast loading time
Works seamlessly in all browsers

API Documentation

3DCloud REST API allows you to manage 3D models from your own applications. You can get your API key from Dashboard > Settings > API.

Authentication

All API requests require authentication with Bearer token:

HTTP Header

Authorization: Bearer YOUR_API_KEY

API Endpoints

List Models

GET /api/v1/models

Model Details

GET /api/v1/models/{id}

Upload Model

POST /api/v1/models

Parameter	Type		Description
file	file	Required	3D model file
name	string	Optional	Model name
description	string	Optional	Model description
is_public	boolean	Optional	Is public?

Delete Model

DELETE /api/v1/models/{id}

Example Request

cURL

curl -X POST https://3dcloud.com.tr/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "name=My 3D Model" \
  -F "is_public=true"

3D Viewer

The 3DCloud viewer uses a powerful WebGL engine based on Google model-viewer. View your models seamlessly on all devices including desktop, tablet, and mobile.

Viewer Features

360° Rotation

Examine the model from every angle with mouse or touch. Auto-rotate keeps the model spinning continuously.

Zoom & Pan

Zoom in with mouse wheel or pinch-to-zoom. Right-click drag to pan the view.

Fullscreen

View the model in fullscreen mode. Ideal for detailed inspection.

AR (Augmented Reality)

AR Quick Look on iOS, WebXR and Scene Viewer on Android. See the model in your real environment.

Screenshot

Download an instant photo of the model in PNG format. Perfect for presentations and sharing.

Product Dimensions

View width, height, and depth information. Supports cm, mm, m, and inch units.

Theme Switching

Switch between light and dark themes. Preference is remembered in the browser.

Reset Camera

Return the model to its default angle and zoom level.

Auto-Rotate

Model rotates automatically. Speed is adjustable (3° - 90°/second).

Variant Switching

Switch between different color or model variants with a single click.

QR Code for Mobile AR

Click the AR button on desktop, scan the QR code with your phone to view the model in AR.

Lighting & Brightness

Brightness (exposure) and shadow intensity are adjustable. Neutral and Legacy lighting presets available.

Product Info Card

Product name and tagline displayed in the viewer. Can be toggled from the Dashboard.

Brand Customization

Customize the viewer with logo, title, footer, watermark, and custom CSS to match your brand.

Domain Restriction

Restrict the widget to work only on specific domains. Supports wildcards (*.example.com).

Mobile Compatibility

Adapts to all screen sizes. Touch controls and mobile AR support for a seamless experience.

Viewer Toolbar

The following buttons can be toggled on/off from Dashboard > Widget Settings:

Control	Description
Fullscreen	View the model in fullscreen mode. Ideal for detailed inspection.
AR (Augmented Reality)	AR Quick Look on iOS, WebXR and Scene Viewer on Android. See the model in your real environment.
Screenshot	Download an instant photo of the model in PNG format. Perfect for presentations and sharing.
Product Dimensions	View width, height, and depth information. Supports cm, mm, m, and inch units.
Theme Switching	Switch between light and dark themes. Preference is remembered in the browser.
Reset Camera	Return the model to its default angle and zoom level.
Variant Switching	Switch between different color or model variants with a single click.

Mouse & Touch Controls

Control	Action
Left click + drag	Rotate model
Right click + drag	Pan view
Mouse wheel	Zoom in/out
Double click	Reset view

Material Editor BETA

The Material Editor allows you to customize the surface appearance of your 3D models at a professional level. Bring your models to life with real texture-based materials, live preview and advanced settings.

Features

Material Library

45+ real photo-based materials at 2K resolution. Metal, wood, stone, fabric, leather, plastic and more. Each material has realistic metalness, roughness and bump values pre-configured.

Live Preview

See instant results on a 3D sphere while adjusting material settings. The preview updates automatically as you change slider values.

Custom Texture Upload

Upload and save your own textures. JPG, PNG, WEBP formats are supported. Automatic bump maps (normal maps) are generated from uploaded textures.

Advanced Settings

Fine-tune your materials with detailed parameters like metalness, roughness, repeat, rotation, offset, bump intensity and color tint.

Preset Texture Library

25+ professional seamless textures licensed from ambientCG. Filter by category to quickly find and apply the perfect texture.

Save Variants

Save different material combinations as variants. Each variant is stored in GLB format and can be shared with a single click.

Editing

Edit your saved materials anytime. Change textures, update parameters or delete them.

Undo / Redo

Undo all material changes with Ctrl+Z or redo with Ctrl+Y. Stay safe while experimenting.

Material Categories

Kategori	Materyal Sayısı	Örnekler
Metal	13	Krom, Çelik, Altın, Bakır, Demir, Alüminyum...
Ahşap	9	Meşe, Ceviz, Çam, Kiraz, Tik, Maun...
Taş	6	Beyaz Mermer, Siyah Mermer, Granit, Beton...
Kumaş & Deri	11	Kahve Deri, Kadife, Keten, Denim, Yün...
Plastik	2	Parlak Beyaz, Parlak Siyah
Diğer	4	Fayans, Tuğla, Karbon Fiber, Mantar

Model Optimization

Reduce file size and improve web performance of AI-generated 3D models. Apply poly reduction and texture optimization with a single click.

Optimization Features

Poly Reduction

Reduces polygon count by 50% using Blender decimation. Significantly reduces file size while preserving model appearance.

Texture Optimization

Downsizes high-resolution textures to 1024px, reducing file size. Improves web loading speed while maintaining visual quality.

Before/After Comparison

View original and optimized sizes, poly counts, and reduction percentage after optimization.

Safe Processing

Your original file is preserved. While optimization is irreversible, your original data always remains safe.

Tip

AI-generated models typically have high poly counts. Optimizing reduces file size and improves widget loading speed. Recommended for e-commerce sites.

AI Live Support BETA

The 3DCloud AI Support assistant provides instant answers to your questions about the platform. Click the "AI Support" button in the dashboard footer to start a chat.

AI Support Features

Instant Response

Get answers to your questions in seconds. Get help with model uploading, embed codes, widget settings, and more.

Multilingual Support

Get support in Turkish and English. The AI assistant responds fluently in both languages.

Platform Knowledge

Has comprehensive knowledge about all 3DCloud features, pricing, technical details, and integrations.

24/7 Access

The AI support assistant is always active. Get instant answers to your questions even outside business hours.

Tip

AI Support is currently in beta. For complex technical issues, you can reach our support team through the feedback form.

Account Management

Manage your account settings, subscription plan, and security preferences.

Subscription Plans

3DCloud offers flexible plans for different needs:

Free: Basic features, 5 models, 6 AI credits, 1GB storage
Starter: (Discontinued)
Professional: 200 models, 10GB storage, advanced widget, live support
Business: 500 models, 30GB storage, advanced widget, live support

Security

Use the following features to secure your account:

Two-factor authentication (2FA)
All connections encrypted with SSL
Automatic backup and data protection

Security Tip: Make sure to enable two-factor authentication on your account. This significantly reduces unauthorized access to your account.