Dokümantasyon - 3DCloud

Başlarken

3DCloud, 3D modellerinizi web üzerinde kolayca paylaşmanızı, görüntülemenizi ve yönetmenizi sağlayan güçlü bir platformdur. Bu rehber, platformu kullanmaya başlamanız için gereken tüm bilgileri içermektedir.

İlk Adımlar

1

Hesap Oluşturun

Ücretsiz kayıt olun ve dashboard'a erişim sağlayın. E-posta doğrulaması ile hesabınızı aktifleştirin.

2

3D Model Yükleyin

GLB, GLTF, OBJ, FBX, STL, DAE, 3DS, PLY, X3D, STEP, IGES gibi popüler formatları destekliyoruz. Sürükle-bırak veya dosya seçici ile yükleyin.

3

Ayarları Yapılandırın

Arka plan rengi, aydınlatma, kamera açısı ve diğer görüntüleme seçeneklerini özelleştirin.

4

Paylaşın veya Gömün

Embed kodu ile web sitenize ekleyin veya doğrudan link ile paylaşın.

İpucu: Ücretsiz plan ile başlayarak platformu test edebilir, daha sonra ihtiyaçlarınıza göre plan yükseltebilirsiniz.

Model Yükleme

3DCloud'a 3D model yüklemek hızlı ve kolaydır. Farklı yükleme yöntemleri ve desteklenen formatlar hakkında bilgi edinin.

Yükleme Yöntemleri

Sürükle & Bırak

Dosyalarınızı doğrudan yükleme alanına sürükleyip bırakın.

Dosya Seçici

Bilgisayarınızdan dosya seçmek için tıklayın.

URL'den Yükleme

Harici bir URL'den 3D model içe aktarın.

Yükleme Limitleri

Maksimum dosya boyutu: Plana göre 50MB - 500MB
Desteklenen formatlar: GLB, GLTF, OBJ, FBX, STL, DAE, 3DS, PLY, X3D, STEP/STP, IGES/IGS, ZIP
Texture dosyaları: PNG, JPG, WebP (otomatik algılanır)

Önemli: En iyi performans için GLB formatını tercih edin. GLB, tüm texture'ları tek bir dosyada içerir ve yükleme süresini kısaltır.

Embed & Widget

3D modellerinizi web sitenize, blogunuza veya e-ticaret platformunuza kolayca gömebilirsiniz. İframe kodu ile saniyeler içinde entegrasyon sağlayın.

Temel Iframe Kodu

Aşağıdaki kodu web sitenize ekleyerek 3D modelinizi görüntüleyebilirsiniz:

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 Parametreleri

Parametre	Tip	Açıklama
autoplay	boolean	Sayfa yüklendiğinde modeli otomatik başlat
autorotate	boolean	Modeli otomatik döndür
ui	boolean	Kontrol butonlarını göster/gizle
bg	string	Arka plan rengi (hex kodu, # olmadan)

Örnek Kullanım

HTML

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

AI Model Oluşturma

3DCloud'un yapay zeka teknolojisi ile 2D fotoğraflarınızı profesyonel 3D modellere dönüştürün. Ürün fotoğraflarınızı yükleyin, saniyeler içinde interaktif 3D model elde edin.

Oluşturma Yöntemleri

Fotoğraftan 3D

Tek veya çoklu fotoğraf yükleyerek 3D model oluşturun.

Metin Açıklaması

Metin açıklaması ile AI destekli 3D model oluşturun.

Oluşturma Adımları

1

Fotoğraf Yükleyin

Nesnenin net, iyi aydınlatılmış fotoğrafını yükleyin. Farklı açılardan çekilmiş fotoğraflar daha iyi sonuç verir.

2

AI İşlemesini Bekleyin

Yapay zeka modelimiz fotoğrafı analiz eder ve 3D geometri oluşturur. Bu işlem genellikle 30-60 saniye sürer.

3

Modeli İndirin veya Paylaşın

Oluşturulan modeli GLB formatında indirin veya doğrudan 3DCloud'da paylaşın.

Not: AI model oluşturma, abonelik planınıza göre aylık kredi limiti ile sınırlıdır. Kalan kredinizi dashboard'dan takip edebilirsiniz.

Desteklenen Formatlar

3DCloud, endüstri standardı 3D dosya formatlarının çoğunu destekler. Yüklenen dosyalar otomatik olarak optimize edilir ve web görüntüleme için hazırlanır.

Desteklenen Formatlar

.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

Önerilen Format: GLB

GLB (GL Binary) formatı web için en optimize edilmiş formattır ve aşağıdaki avantajları sunar:

Tüm texture ve materyalleri tek dosyada içerir
Sıkıştırılmış dosya boyutu
Hızlı yükleme süresi
Tüm tarayıcılarda sorunsuz çalışır

API Dokümantasyonu

3DCloud REST API, kendi uygulamalarınızdan 3D model yönetimi yapmanızı sağlar. API anahtarınızı Dashboard > Ayarlar > API bölümünden alabilirsiniz.

Kimlik Doğrulama

Tüm API istekleri Bearer token ile kimlik doğrulaması gerektirir:

HTTP Header

Authorization: Bearer YOUR_API_KEY

API Endpoint'leri

Modelleri Listele

GET /api/v1/models

Model Detayı

GET /api/v1/models/{id}

Model Yükle

POST /api/v1/models

Parametre	Tip		Açıklama
file	file	Zorunlu	3D model dosyası
name	string	Opsiyonel	Model adı
description	string	Opsiyonel	Model açıklaması
is_public	boolean	Opsiyonel	Herkese açık mı?

Model Sil

DELETE /api/v1/models/{id}

Örnek İstek

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 Görüntüleyici

3DCloud görüntüleyicisi, Google model-viewer tabanlı güçlü bir WebGL motoru kullanır. Modellerinizi masaüstü, tablet ve mobil dahil tüm cihazlarda sorunsuz görüntüleyin.

Görüntüleyici Özellikleri

360° Döndürme

Fare veya dokunmatik ile modeli her açıdan inceleyin. Otomatik döndürme özelliği ile model sürekli dönebilir.

Yakınlaştırma & Kaydırma

Fare tekerleği veya pinch-to-zoom ile yakınlaştırın. Sağ tık ile görünümü kaydırın.

Tam Ekran

Modeli tam ekran modunda görüntüleyin. Detaylı inceleme için ideal.

AR (Artırılmış Gerçeklik)

iOS'ta AR Quick Look, Android'de WebXR ve Scene Viewer desteği. Modeli gerçek ortamınızda görün.

Ekran Görüntüsü

Modelin anlık fotoğrafını PNG formatında indirin. Sunum ve paylaşım için idealdir.

Ürün Ölçüleri

Genişlik, yükseklik ve derinlik bilgilerini görüntüleyin. cm, mm, m ve inch destekler.

Tema Değiştirme

Açık ve koyu tema arasında geçiş yapın. Tercih tarayıcıda hatırlanır.

Kamerayı Sıfırla

Modeli varsayılan açıya ve zoom seviyesine döndürün.

Otomatik Döndürme

Model otomatik olarak döner. Hız ayarlanabilir (3° - 90°/saniye).

Varyant Değiştirme

Farklı renk veya model varyantları arasında tek tıkla geçiş yapın.

QR Kod ile Mobil AR

Masaüstünde AR butonuna tıklayın, QR kodu telefonunuzla tarayarak modeli AR'da görün.

Aydınlatma & Parlaklık

Parlaklık (exposure) ve gölge yoğunluğu ayarlanabilir. Neutral ve Legacy aydınlatma ön ayarları mevcuttur.

Ürün Bilgi Kartı

Ürün adı ve slogan görüntüleyicide gösterilir. Dashboard'dan açılıp kapatılabilir.

Marka Özelleştirme

Logo, başlık, footer, filigran ve özel CSS ile görüntüleyiciyi markanıza uygun hale getirin.

Alan Adı Kısıtlama

Widget'ın yalnızca belirli alan adlarında çalışmasını sağlayın. Wildcard (*.example.com) destekler.

Mobil Uyumluluk

Tüm ekran boyutlarına uyum sağlar. Dokunmatik kontroller ve mobilde AR desteği ile sorunsuz deneyim.

Görüntüleyici Araç Çubuğu

Aşağıdaki butonlar Dashboard > Widget Ayarları bölümünden açılıp kapatılabilir:

Kontrol	Açıklama
Tam Ekran	Modeli tam ekran modunda görüntüleyin. Detaylı inceleme için ideal.
AR (Artırılmış Gerçeklik)	iOS'ta AR Quick Look, Android'de WebXR ve Scene Viewer desteği. Modeli gerçek ortamınızda görün.
Ekran Görüntüsü	Modelin anlık fotoğrafını PNG formatında indirin. Sunum ve paylaşım için idealdir.
Ürün Ölçüleri	Genişlik, yükseklik ve derinlik bilgilerini görüntüleyin. cm, mm, m ve inch destekler.
Tema Değiştirme	Açık ve koyu tema arasında geçiş yapın. Tercih tarayıcıda hatırlanır.
Kamerayı Sıfırla	Modeli varsayılan açıya ve zoom seviyesine döndürün.
Varyant Değiştirme	Farklı renk veya model varyantları arasında tek tıkla geçiş yapın.

Fare & Dokunmatik Kontroller

Kontrol	İşlem
Sol tık + sürükle	Modeli döndür
Sağ tık + sürükle	Görünümü kaydır
Fare tekerleği	Yakınlaştır/uzaklaştır
Çift tıklama	Görünümü sıfırla

Materyal Editörü BETA

Materyal Editörü, 3D modellerinizin yüzey görünümlerini profesyonel seviyede özelleştirmenizi sağlar. Gerçek doku bazlı materyaller, canlı önizleme ve gelişmiş ayarlarla modellerinize hayat verin.

Özellikler

Materyal Kütüphanesi

45'ten fazla gerçek fotoğraf bazlı 2K çözünürlüklü materyal. Metal, ahşap, taş, kumaş, deri, plastik ve daha fazlası. Her materyalin gerçekçi metalness, roughness ve kabartma değerleri önceden ayarlanmıştır.

Canlı Önizleme

Materyal ayarlarını yaparken 3D küre üzerinde anında sonucu görün. Slider değerlerini değiştirdikçe önizleme otomatik güncellenir.

Özel Doku Yükleme

Kendi dokularınızı yükleyin ve kaydedin. JPG, PNG, WEBP formatları desteklenir. Yüklenen dokulara otomatik kabartma (normal map) oluşturulur.

Gelişmiş Ayarlar

Metallik, pürüzlülük, tekrar, döndürme, kaydırma, kabartma yoğunluğu ve renk tonu gibi detaylı parametrelerle materyallerinizi ince ayarlayın.

Hazır Doku Kütüphanesi

ambientCG'den lisanslı 25+ profesyonel seamless doku. Kategorilere göre filtreleyerek hızlıca bulun ve uygulayın.

Varyant Kaydetme

Farklı materyal kombinasyonlarını varyant olarak kaydedin. Her varyant GLB formatında saklanır ve tek tıkla paylaşılabilir.

Düzenleme

Kaydedilmiş materyallerinizi istediğiniz zaman düzenleyin. Doku değiştirin, parametreleri güncelleyin veya silin.

Geri Al / Yinele

Tüm materyal değişikliklerini Ctrl+Z ile geri alın veya Ctrl+Y ile yineleyin. Deneysel çalışma için güvende olun.

Materyal Kategorileri

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 Optimizasyonu

AI ile oluşturulan 3D modellerin dosya boyutunu düşürün ve web performansını artırın. Tek tıkla poly azaltma ve doku optimizasyonu uygulayarak modellerinizi hafifletin.

Optimizasyon Özellikleri

Poly Azaltma

Blender decimation ile polygon sayısını %50 azaltır. Model görünümünü koruyarak dosya boyutunu önemli ölçüde küçültür.

Doku Optimizasyonu

Yüksek çözünürlüklü dokuları 1024px'e düşürerek dosya boyutunu küçültür. Görsel kaliteyi koruyarak web yükleme hızını artırır.

Önce/Sonra Karşılaştırma

Optimizasyon sonrası orijinal ve optimize boyutları, poly sayıları ve kazanım yüzdesini görüntüleyin.

Güvenli İşlem

Orijinal dosyanız korunur. Optimizasyon geri alınamaz olsa da orijinal verileriniz her zaman güvende kalır.

İpucu

AI ile oluşturulan modeller genellikle yüksek poly sayısına sahiptir. Optimize etmek hem dosya boyutunu düşürür hem de widget yükleme hızını artırır. E-ticaret siteleri için önerilir.

AI Canlı Destek BETA

3DCloud AI Destek asistanı, platform hakkındaki sorularınıza anında yanıt verir. Dashboard footer'ındaki "AI Destek" butonuna tıklayarak sohbeti başlatabilirsiniz.

AI Destek Özellikleri

Anında Yanıt

Sorularınıza saniyeler içinde yanıt alın. Model yükleme, embed kodu, widget ayarları ve daha fazlası hakkında yardım alın.

Çok Dilli Destek

Türkçe ve İngilizce dillerinde destek alabilirsiniz. AI asistan her iki dilde de akıcı şekilde yanıt verir.

Platform Bilgisi

3DCloud'un tüm özellikleri, fiyatlandırma, teknik detaylar ve entegrasyon hakkında kapsamlı bilgiye sahiptir.

7/24 Erişim

AI destek asistanı her zaman aktiftir. Mesai saatleri dışında da sorularınıza anında yanıt alabilirsiniz.

İpucu

AI Destek şu anda beta aşamasındadır. Karmaşık teknik sorunlar için geri bildirim formunu kullanarak destek ekibimize ulaşabilirsiniz.

Hesap Yönetimi

Hesap ayarlarınızı, abonelik planınızı ve güvenlik tercihlerinizi yönetin.

Abonelik Planları

3DCloud farklı ihtiyaçlara yönelik esnek planlar sunar:

Free: Temel özellikler, 5 model, 6 AI kredi, 1GB depolama
Starter: (Kaldırıldı)
Professional: 200 model, 10GB depolama, gelişmiş widget, canlı destek
Business: 500 model, 30GB depolama, gelişmiş widget, canlı destek

Güvenlik

Hesabınızın güvenliğini sağlamak için aşağıdaki özellikleri kullanabilirsiniz:

İki faktörlü kimlik doğrulama (2FA)
SSL ile şifrelenmiş tüm bağlantılar
Otomatik yedekleme ve veri koruma

Güvenlik İpucu: Hesabınızda mutlaka iki faktörlü kimlik doğrulamayı aktifleştirin. Bu, hesabınıza yetkisiz erişimi önemli ölçüde azaltır.