Login3D Geliştirici API & MCP Dokümantasyonu
Login3D üretim hattını doğrudan oyun motorunuza, CI/CD iş akışlarınıza veya Claude Desktop, Claude Code ve Cursor gibi yapay zeka asistanlarınıza bağlayın. Metinden ve referans görselden PBR dokulu 3D modeller üretin, Unity / Unreal Engine / Godot paketleri oluşturun ve 3D baskıya hazır mesh çıktıları alın.
🔑 Kimlik Doğrulama (API Anahtarları)
API anahtarlarınızı Profil Ayarları → 🔑 Geliştirici / API sekmesinden oluşturabilirsiniz. Her anahtar l3d_live_ öneki ve 32 kriptografik rastgele bayttan (64 hex karakter) oluşur.
SHA-256 özeti (key_hash) saklanır ve uygulama günlüklerine (loglara) asla yazılmaz.
İsteklerinizde anahtarı iki başlıktan biriyle gönderebilirsiniz:
Authorization: Bearer l3d_live_0123456789abcdef0123456789abcdef...
X-API-Key: l3d_live_0123456789abcdef0123456789abcdef...
Kullanıcı başına en fazla 5 aktif API anahtarı oluşturulabilir. İptal edilen (revoked) anahtarlar anında geçersiz olur ve 401 Unauthorized döndürür.
💎 Kredi Maliyeti & Hız Sınırları
⏱️ Hız Sınırları (Rate Limits) & Kotalar
- API Anahtarı Başına Hız Sınırı: Dakikada en fazla
30 istek / dk. Sınır aşıldığında429 Too Many RequestsveRetry-Afterbaşlığı döner. - Aktif Anahtar Sınırı: Hesap başına maksimum
5aktif anahtar. - Sahiplik ve İzolasyon (IDOR Koruması): API anahtarı yalnızca sahibine (
user_id) ait modelleri ve üretim işlerini okuyabilir/dışa aktarabilir. - Varsayılan Red (Default-Deny): Profil, şifre değiştirme, ödeme, mağaza ilanı ve anahtar yönetimi uç noktaları API anahtarıyla çağrılamaz (
403 Forbidden).
📡 İzin Verilen API Uç Noktaları ve Kapsamlar (Scopes)
Geliştirici API anahtarları yalnızca aşağıdaki beyaz listedeki (allowlist) uç noktalarda çalışır. Diğer tüm uç noktalar güvenlik gereği 403 Forbidden ile reddedilir.
| Metot | Uç Nokta | Gerekli Kapsam | Açıklama |
|---|---|---|---|
| POST | /api/generate_3d |
generate_3d | Metin istemi (prompt) veya referans görsel (image_url / image_urls) ile asenkron 3D model üretimi başlatır ve job_id döndürür. |
| GET / POST | /api/job_status |
job_status | ?job_id=... sorgu parametresi veya JSON gövdesiyle üretim işinin durumunu (processing, completed, failed) ve glb_url adresini döndürür. |
| GET | /api/gallery |
gallery | Yalnızca API anahtarı sahibine ait tamamlanmış 3D modelleri ve önizleme adreslerini listeler. |
| POST | /api/export_game_pack |
export_game_pack | Modelinizi unity, unreal veya godot motoruna uygun PBR dokular, LOD0/LOD1/LOD2 ve kurulum betikleriyle .zip paketi olarak dışa aktarır. |
| POST | /api/export_model |
export_model | Modeli glb, fbx, obj, stl, usdz veya renkli 3mf formatına dönüştürür; isteğe bağlı poligon azaltma ve 3D baskı onarımı uygular. |
| GET | /api/auth/me |
account_read | Anahtar sahibinin kullanıcı bilgilerini, aktif anahtar önekini ve güncel credits bakiyesini döndürür. |
💻 Örnek İstek ve Yanıtlar (curl, Python, JavaScript)
Aşağıdaki örnekler 3D model üretimini başlatma, iş durumunu sorgulama ve oyun motoru paketi dışa aktarma akışını gösterir.
# 1) Hesap ve Kredi Bakiyesi Sorgulama
curl -sS https://login3d.com/api/auth/me \
-H "Authorization: Bearer l3d_live_YOUR_API_KEY"
# 2) Metin veya Görselden 3D Model Üretimi Başlatma
curl -sS -X POST https://login3d.com/api/generate_3d \
-H "Authorization: Bearer l3d_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Altın işlemeli antik samuray katana kılıcı, PBR 4K oyun modeli",
"category": "weapon"
}'
# 3) Üretim İşi Durumu Sorgulama
curl -sS "https://login3d.com/api/job_status?job_id=job_1730000000_abcd1234" \
-H "Authorization: Bearer l3d_live_YOUR_API_KEY"
# 4) Unity / Unreal / Godot Oyun Motoru Paketi (.zip) Oluşturma
curl -sS -X POST https://login3d.com/api/export_game_pack \
-H "Authorization: Bearer l3d_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model_url": "/outputs/samurai_katana.glb",
"engine": "unity",
"include_lods": true
}'
import json
import time
import urllib.request
BASE_URL = "https://login3d.com"
API_KEY = "l3d_live_YOUR_API_KEY"
def api_request(method: str, path: str, payload: dict | None = None) -> dict:
data = json.dumps(payload).encode("utf-8") if payload is not None else None
req = urllib.request.Request(
f"{BASE_URL}{path}",
data=data,
method=method,
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
)
with urllib.request.urlopen(req, timeout=30) as resp:
return json.loads(resp.read().decode("utf-8"))
# 1) Kredi bakiyesini kontrol et
me = api_request("GET", "/api/auth/me")
print("Güncel Kredi:", me["user"]["credits"])
# 2) 3D üretim işi başlat
job = api_request("POST", "/api/generate_3d", {
"prompt": "Zümrüt kristalli büyülü hazine sandığı",
"category": "props",
})
job_id = job["job_id"]
# 3) İş tamamlanana kadar sorgula
while True:
status = api_request("GET", f"/api/job_status?job_id={job_id}")
if status.get("status") == "completed":
print("3D Model Hazır:", status.get("glb_url"))
break
if status.get("status") == "failed":
raise RuntimeError(status.get("error"))
time.sleep(5)
const BASE_URL = "https://login3d.com";
const API_KEY = process.env.LOGIN3D_API_KEY || "l3d_live_YOUR_API_KEY";
async function generateAndExportPack() {
const headers = {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
};
// 1) 3D model üretimini başlat
const genRes = await fetch(`${BASE_URL}/api/generate_3d`, {
method: "POST",
headers,
body: JSON.stringify({
prompt: "Cyberpunk otonom keşif dronu, PBR metalik doku",
category: "vehicle"
})
});
const { job_id } = await genRes.json();
// 2) İş durumunu kontrol et
const statusRes = await fetch(`${BASE_URL}/api/job_status?job_id=${encodeURIComponent(job_id)}`, { headers });
const statusData = await statusRes.json();
console.log("Job status:", statusData);
// 3) Godot 4 oyun paketi üret
if (statusData.glb_url) {
const packRes = await fetch(`${BASE_URL}/api/export_game_pack`, {
method: "POST",
headers,
body: JSON.stringify({
model_url: statusData.glb_url,
engine: "godot",
include_lods: true
})
});
console.log("Game pack:", await packRes.json());
}
}
generateAndExportPack();
Örnek Başarılı Yanıt (POST /api/generate_3d & GET /api/job_status)
// POST /api/generate_3d yanıtı:
{
"success": true,
"async": true,
"job_id": "job_1730000000_9f8e7d6c",
"status": "processing"
}
// GET /api/job_status?job_id=job_1730000000_9f8e7d6c yanıtı:
{
"success": true,
"status": "completed",
"glb_url": "/outputs/Cyberpunk_otonom_kesif_dronu_20261108.glb",
"is_rigged": false
}
⚠️ HTTP Durum ve Hata Kodları
Tüm API hataları standart JSON formatında {"success": false, "error": "..."} şemasıyla döner.
| HTTP Kodu | Durum | Açıklama ve Çözüm |
|---|---|---|
200 OK |
Başarılı | İstek başarıyla işlendi. |
400 Bad Request |
Geçersiz Parametre / Yetersiz Kredi | Eksik/hatalı parametre gönderildi, 5 aktif anahtar sınırına ulaşıldı veya hesapta yeterli kredi bulunmuyor. |
401 Unauthorized |
Kimlik Doğrulama Hatası | API anahtarı eksik, hatalı formatta veya kullanıcı tarafından iptal edilmiş (revoked). |
403 Forbidden |
Yetkisiz Uç Nokta / Kapsam / Sahiplik | API anahtarı izin verilmeyen bir uç noktada (örn. profil/ödeme/anahtar yönetimi) kullanıldı, kapsamı (scope) yetersiz veya başka bir kullanıcıya ait modele erişilmeye çalışıldı. |
404 Not Found |
Kaynak Bulunamadı | İstenen job_id, model dosyası veya API uç noktası mevcut değil. |
429 Too Many Requests |
Hız Sınırı Aşıldı | Dakikada 30 istek (veya kullanıcı üretim kuyruğu) sınırı aşıldı. Retry-After başlığındaki süre kadar bekleyin. |
500 Internal Server Error |
Sunucu Hatası | Beklenmeyen işlem hatası. Üretim hatası durumunda rezerve edilen kredi otomatik iade edilir. |
🤖 Model Context Protocol (MCP) Sunucusu
Login3D deposundaki integrations/mcp/login3d_mcp.py betiği sayesinde Claude Desktop, Claude Code ve Cursor içinden doğrudan doğal dille 3D model üretebilir ve oyun motoru paketlerinizi yerel diskinize indirebilirsiniz.
Kullanılabilir MCP Araçları (Tools)
generate_3d_model— Metin istemi (prompt) veyaimage_urlile 3D model üretim işi başlatır.get_job_status— Verilenjob_idiçin üretim durumunu ve çıktı model adresini sorgular.list_my_models— Hesabınıza ait kişisel 3D modelleri listeler.get_credits— Hesabınızın güncel kredi bakiyesini ve aktif API anahtarı kapsamlarını gösterir.export_game_pack— Seçilen modeli Unity, Unreal veya Godot.zippaketi olarak yerel diske indirir.
Claude Desktop / Claude Code / Cursor (mcp.json) Yapılandırması
{
"mcpServers": {
"login3d": {
"command": "python",
"args": ["/tam/yol/login3d/integrations/mcp/login3d_mcp.py"],
"env": {
"LOGIN3D_API_KEY": "l3d_live_BURAYA_ANAHTARINIZI_YAZIN",
"LOGIN3D_BASE_URL": "https://login3d.com"
}
}
}
}
🎨 Blender Eklentisi (Blender 3.6 LTS & 4.x)
Login3D resmi Blender eklentisiyle Blender'dan çıkmadan 3D Viewport yan panelinden (N Paneli → Login3D) kredi bakiyenizi görebilir, kişisel galerinizdeki .glb modellerini iskelet (Armature) ve animasyonlarıyla sahneye aktarabilir, metin isteminden veya referans görselden yeni 3B model üretip otomatik içe aktarabilir ve Unity / Unreal / Godot oyuna hazır paketlerini indirebilirsiniz.
Blender 3.6 LTS, 4.0, 4.1, 4.2 LTS ve 4.3+ sürümleriyle tam uyumludur. Arayüzü dondurmayan arka plan iş parçacığı (non-blocking) mimarisiyle çalışır.
1. Kurulum Adımları
- Yukarıdaki düğmeden
/static/downloads/login3d_blender.zipdosyasını indirin. - Blender'da Edit → Preferences → Add-ons menüsünü açın ve Install from Disk... (veya Install...) ile
login3d_blender.zipdosyasını seçin. - Import-Export: Login3D AI Studio eklentisini etkinleştirip API Anahtarı alanına
l3d_live_...anahtarınızı yapıştırın.
2. N Paneli Özellikleri (VIEW_3D → UI → Login3D)
- Galerimden İçe Aktar:
/api/gallerymodellerinizi listeler, seçilen.glbdosyasını indirir vebpy.ops.import_scene.gltfile iskelet/animasyonları koruyarak sahneye ekler. - Yeni 3B Model Üret: Metin istemi veya görsel ile
/api/generate_3dbaşlatır,/api/job_statusile arka planda takip eder ve bitince sahneye otomatik aktarır. - Oyuna Hazır Paket İndir:
/api/export_game_packile Unity, Unreal veya Godot PBR + LOD paketini seçtiğiniz klasöre indirir.