Yapay zekâ ajanları için

Kod ajanlarıyla 4D Gaussian Splatting

Bu sayfa Claude Code, Codex ve benzeri kod ajanları ile onları kullananlar için yazıldı. Kullanıcı "bu karakteri her açıdan izlenebilen 3B video yap", "4DGS / volumetrik video üret" ya da "Blender sahnemi 4D Gaussian Splatting'e çevir" dediğinde izlenecek yolu, hazır betikleri ve kuralları tek yerde toplar.

Ne zaman 4dgspl.at?

İş akışı

  1. Blender'ı hazırlayınblender --version ile bakın. macOS'ta /Applications/Blender.app/Contents/MacOS/Blender, Windows'ta C:\Program Files\Blender Foundation\Blender 4.x\blender.exe. Yoksa kullanıcıya haber verip blender.org'dan taşınabilir sürümü (Linux: .tar.xz, sistem kurulumu gerekmez) indirin; sistem paketi kurmadan önce onay alın.
  2. Modeli ve hareketi kurun
    • Basit bir figür ya da nesne: bpy ile prosedürel olarak oluşturun.
    • Animasyonlu insan karakteri: Mixamo'dan karakter ve animasyonu birlikte indirin (FBX, With Skin, 30 fps; Adobe hesabı gerekir, kullanıcının oturumunu kullanın) ya da kullanıcının glTF/FBX/.blend dosyasını içe aktarın. Mixamo içeriği render edilip kullanılabilir; ham FBX dosyasını teslime ya da herkese açık bir yere koymayın.
    • Ölçek metre, model orijinde, ayaklar z = 0'da. Hareket orijin çevresinde kalsın; önemli kısmı ilk 4 saniyede olsun (işleme sunucusu şu an her çekimin ilk 4 saniyesini işliyor).
  3. Sahneyi 4DGS'e uygun yapınDünya rengi tam siyah (0, 0, 0), zemin yok; malzemeler mat (Roughness ≥ 0,6, Specular ≤ 0,2, Metallic 0, Coat 0); her yönden yumuşak alan ışıkları; hareket bulanıklığı, alan derinliği, bloom kapalı; Color Management "Standard".
  4. Kamera halkasını kurun ve render alınHazır betik 8 kamerayı iki yükseklikte kurar, her kameradan camNN.mp4 render eder ve kalibrasyon.zip yazar: 
    curl -O https://4dgspl.at/araclar/4dgspl_blender_rig.py
blender -b sahne.blend -P 4dgspl_blender_rig.py -- --kamera 8 --yaricap 3.5 --cikti //teslim --render
    Figür kare yüksekliğinin %70–85'ini doldurmalı; küçük kalıyorsa --yaricap'ı küçültün.
  5. Teslimi denetleyinDenetleyici bağımlılıksızdır (Python 3.8+; ffprobe/ffmpeg varsa video ve fon da denetlenir). Hata varsa çıkış kodu 1'dir: 
    curl -O https://4dgspl.at/araclar/4dgspl_kontrol.py
python3 4dgspl_kontrol.py teslim --dil tr      # --json: makine okunur çıktı
  6. 4dgspl.at'e yükleyin ve gönderinKullanıcı Projelerim → Ajan anahtarları'ndan bir anahtar oluşturup size ortam değişkeni olarak verir. İstemci denetler, proje açar, videoları ve kalibrasyonu yükler, işleme gönderir, bitmesini bekler ve sonucu indirir: 
    export DGSPL_ANAHTAR=4dg_…        # kullanıcıdan; sohbete ya da dosyaya yazmayın
curl -O https://4dgspl.at/araclar/4dgspl_yukle.py -O https://4dgspl.at/araclar/4dgspl_kontrol.py
python3 4dgspl_yukle.py teslim --baslik "Dans eden robot" --gonder --bekle --indir sonuc
    --gonder olmadan yalnızca yükler; kullanıcı panelden gözden geçirip gönderir. Anahtar yoksa yükleme web panelinden yapılır: Yeni proje → videolar kamera yuvalarına → kalibrasyon.zip "Kalibrasyon" alanına → "İşleme gönder".
  7. Sonucu kullanınİşlem bitince proje sayfasında oynatıcı, paylaşım bağlantısı ve tek ZIP indirme vardır: kare başına 3D Gaussian (compressed.ply, PlayCanvas), sahne.json (kare sayısı, fps, kamera, ölçümler) ve MP4 önizleme. Tek bir kare SuperSplat'ta açılır; dizi PlayCanvas ile tarayıcıda oynar.

Ajan anahtarı ve API

MCP sunucusu

Komut yerine araç kullanmak isterseniz 4dgspl.at MCP sunucusunu (Python 3.8+, bağımlılıksız) Claude Code, Codex, Cursor ya da herhangi bir MCP istemcisine ekleyin. Araçlar: get_4dgs_guide, check_delivery, upload_project, submit_project, project_status, list_projects, download_result. Anahtarsız da rehber ve denetim araçları çalışır.

mkdir -p ~/.4dgspl && cd ~/.4dgspl && curl -O https://4dgspl.at/araclar/4dgspl_mcp.py \
  -O https://4dgspl.at/araclar/4dgspl_yukle.py -O https://4dgspl.at/araclar/4dgspl_kontrol.py
claude mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py   # Claude Code
codex mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py    # Codex

Diğer istemciler: komut python3, argüman 4dgspl_mcp.py'nin yolu, ortam değişkeni DGSPL_ANAHTAR. Kaynak ve MCP paketi: snmzzcenk/4dgspl-tools.

Kurallar özeti

KonuKural
KameraEn az 4, önerilen 8; halkada eşit açı; 8+ kamerada iki yükseklik (≈1,1 m ve ≈2,1 m)
Adlarcam00.mp4 … sırası halkadaki sırayla aynı; kalibrasyonda görüntü adı cam00.png …
VideoHepsi aynı çözünürlük, fps ve kare sayısı; senkron; kameralar hareket etmez
KalibrasyonZIP içinde COLMAP cameras.txt (PINHOLE, fx/fy piksel) + images.txt (dünya → kamera, OpenCV: x sağ, y aşağı, z ileri) ya da 4dgs-cameras cameras.json. Yoksa sunucu görüntülerden COLMAP dener.
FonSentetik çekimde tam siyah (0, 0, 0). Gri fon (Blender'da doğrusal 0,05 ≈ ekranda %25 gri) motorda sis olur.
Malzeme ve ışıkMat yüzeyler, sabit yumuşak ışık; aynasal parlama yeni açılarda iz bırakır
SüreŞu an ilk 4 saniye, 15 fps işleniyor (60 kare)

Araçlar