Login3D Developers & MCP
⚡ REST API v1 & Model Context Protocol (MCP)

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.

🛡️ Tek Seferlik Gösterim & SHA-256 Saklama: Ham anahtar yalnızca oluşturulduğu anda bir kez gösterilir. Sunucuda düz metin olarak tutulmaz; yalnızca 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ı

💎 Kredi Kullanımı ve Otomatik İade: Güncel kredi bedelleri hesabınızda görünür. Üretim işlemleri başlatılırken hesap bakiyeniz kontrol edilir; herhangi bir nedenle başarısız olan üretim işlerinde rezerve edilen kredi otomatik olarak hesabınıza iade edilir.

⏱️ 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ığında 429 Too Many Requests ve Retry-After başlığı döner.
  • Aktif Anahtar Sınırı: Hesap başına maksimum 5 aktif 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)

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.

📦 Sıfır Harici Bağımlılık (Yalnızca Python Standart Kütüphanesi):
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.
⬇️ Blender Eklentisini İndir (login3d_blender.zip)

1. Kurulum Adımları

  1. Yukarıdaki düğmeden /static/downloads/login3d_blender.zip dosyasını indirin.
  2. Blender'da Edit → Preferences → Add-ons menüsünü açın ve Install from Disk... (veya Install...) ile login3d_blender.zip dosyasını seçin.
  3. 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/gallery modellerinizi listeler, seçilen .glb dosyasını indirir ve bpy.ops.import_scene.gltf ile iskelet/animasyonları koruyarak sahneye ekler.
  • Yeni 3B Model Üret: Metin istemi veya görsel ile /api/generate_3d başlatır, /api/job_status ile arka planda takip eder ve bitince sahneye otomatik aktarır.
  • Oyuna Hazır Paket İndir: /api/export_game_pack ile Unity, Unreal veya Godot PBR + LOD paketini seçtiğiniz klasöre indirir.