AI ajanları ve geliştiriciler

Modelleri ajanın seçsin.

Codels üzerindeki her modelin makinece okunabilir bir ikizi var. API anahtarı gerekmez, CORS açık, URL’ler kalıcı. Bir model sayfasında AI ajanı için kopyala düğmesine bas ya da ajanını https://codels.download/llms.txt adresine yönlendirip kendi başına arama yapmasına izin ver.

“AI ajanı için kopyala” ile panoya ne kopyalanır?

Add the 3D model "Pine Tree" from the Codels library to this three.js project.

1. First read the agent page (preview image, size, parts and ready-to-use code):
   https://codels.download/m/pine-tree.md?snow=true
2. Then integrate it:
   - Preferred: ES module https://codels.download/m/pine-tree.js?snow=true — exports createPineTree(): THREE.Group …
   - Or the binary glTF: https://codels.download/m/pine-tree.glb?snow=true
   - React Three Fiber component: https://codels.download/m/pine-tree.jsx?snow=true

Conventions: meters, +Y up, front faces +Z, origin at the center of the base (y = 0).

Havada duran modeller (toplanabilir eşyalar, gezegenler) orijinde ortalanır; duvara monte prop’ların arka yüzü z = 0 düzlemindedir — her ajan sayfası tam orijin noktasını belirtir.

MCP sunucusu

Codels MCP sunucusunu Claude Code, Cursor, Windsurf ya da herhangi bir MCP istemcisine ekle. Ajanın altı araç kazanır: search_models, get_model (ajanın gerçekten görebildiği 4 görünümlü bir önizleme görseli döndürür), get_model_code, list_packs, get_pack ve list_categories.

claude mcp add --transport http codels https://codels.download/mcp

Diğer istemciler (ör. Cursor mcp.json):

{
  "mcpServers": {
    "codels": {
      "url": "https://codels.download/mcp"
    }
  }
}

Endpoint’ler

/m/<slug>.md

Ajan sayfası: açıklama, önizleme görseli, boyut, parça tablosu, parametreler ve three.js kodunun tamamı — tek istekte her şey.

/m/<slug>.js

create<Name>(): THREE.Group dışa aktaran ES modülü. three dışında hiçbir bağımlılığı yok.

/m/<slug>.jsx

React Three Fiber bileşeni.

/m/<slug>.instanced.js

Instancing modülü: bake<Name>() (materyal başına tek geometri) + create<Name>Instances(count, place) — yüzlerce kopya, birkaç draw call.

/m/<slug>.html

Tek başına çalışan demo sayfası (three.js CDN üzerinden).

/m/<slug>.png · .sheet.png

Önizleme görüntüsü / 4 görünümlü pafta (3/4, ön, yan, üst); böylece ajanlar modeli “görebilir”.

/m/<slug>.glb · .gltf · .obj · .stl · .json

Binary/JSON glTF, vertex renkli OBJ, STL, ham CodelSpec.

/api/v1/models?q=&category=&tags=&sort=

Filtreli (facet) arama. Her sonuç için URL’ler döndürür.

/api/v1/models/<slug> · /api/v1/tags · /api/v1/categories

Meta veriler, sayılarıyla etiket araması, kategori ağacı.

/c/<pack>.md · .js · .zip · .json

Paketler ve herkese açık koleksiyonlar: ajan özeti, tüm modelleri içeren tek bir ES modülü ya da GLB’ler ve modüllerden oluşan bir ZIP.

/llms.txt

Bu site için makinece okunabilir rehber.

/mcp

Arama, önizleme ve kod araçları sunan Model Context Protocol endpoint’i (Streamable HTTP).

Parametrik varyantlar

Parametrik modeller, parametrelerini her URL’de sorgu parametresi (query string) olarak kabul eder. .md sayfası her parametreyi aralığıyla birlikte listeler.

// fetch a taller pine with snow caps as a ready ES module
const src = await fetch('https://codels.download/m/pine-tree.js?height=5.5&snow=true').then((r) => r.text());

Kodu kullan

import * as THREE from 'three';
import { createPineTree } from './pine-tree.js';

const forest = new THREE.Group();
for (let i = 0; i < 40; i++) {
  const tree = createPineTree();
  tree.position.set((Math.random() - 0.5) * 60, 0, (Math.random() - 0.5) * 60);
  tree.rotation.y = Math.random() * Math.PI * 2;
  tree.scale.setScalar(0.8 + Math.random() * 0.5);
  forest.add(tree);
}
scene.add(forest);

Koddan arama yap

const res = await fetch('https://codels.download/api/v1/models?q=medieval+barrel&sort=relevance');
const { items } = await res.json();
console.log(items[0].urls.code); // → https://codels.download/m/<slug>.js

İstek sınırları ve API anahtarları

Her şey anahtarsız da çalışır (IP başına dakikada 120 API isteği). Daha yoğun kullanım için ücretsiz bir API anahtarı oluştur: dakikada 1.200 istek ve kullanım istatistikleri. Anahtarı Authorization: Bearer cdl_… olarak gönder — yanıtlarda X-RateLimit-Remaining başlığı bulunur, 429 yanıtı da ne zaman tekrar denemen gerektiğini söyler.

curl -H "Authorization: Bearer cdl_your_key" "https://codels.download/api/v1/models?q=barrel"
claude mcp add --transport http codels https://codels.download/mcp --header "Authorization: Bearer cdl_your_key"