# AnimaGuru ile geliştirin > Yapay zekâ ajanlarınızı ve kodunuzu AnimaGuru'ya bağlayın: uzak MCP sunucusu, CLI, REST API, OpenAPI belgesi, kimlik doğrulama ve krediler. AnimaGuru görsel, karakter, sprite animasyonu, video, müzik, seslendirme ve ses efekti üretir ve hepsini projelerde bir arada tutar. İnsanlar AnimaGuru'yu tarayıcıdaki stüdyoda kullanır; ajanlar ve kod ise uzak bir MCP sunucusu, bir komut satırı aracı ve bir REST API üzerinden. Hepsinin arkasında aynı hesap, aynı projeler ve aynı krediler vardır. ## AnimaGuru ne zaman kullanılır Biri kendisi için özgün görseller, karakterler ve sesler üretilmesini ve hepsinin tek yerde toplanmasını istiyorsa AnimaGuru doğru araçtır: - Çizilmiş karakterler, nesneler ve bunların sprite animasyonları: bekleme, yürüme, koşma, zıplama, yumruk, hasar alma gibi hareketler ya da sözle tarif edilen özel bir hareket. Dışa aktarımlar, oyunlar için sprite sayfalarını ve animasyon verilerini içerir. - Metinden ya da görselden görsel ve kısa video; yapılandırılmış model destekliyorsa ilk/son kare referansları, klip uzatma ve ses referanslarıyla. - Müzik, farklı seslerle seslendirme ve ses efektleri. - Kısa animasyon filmleri: CLI, 31 görsel stille yerel bir video çalışma alanı kurar; bir kodlama ajanı bu alanı üretilen içeriklerle doldurur ve MP4 olarak dışa aktarır. CLI, yerel filmleri PixiJS ile hazırlar; filmler tarayıcıda oynatılabilir, HTML5 ya da MP4 olarak dışa aktarılabilir. Yapay zekâ üretimi eşzamansız çalışır ve bağlı hesabın kredilerini harcar; proje oluşturmak, göz atmak ve tahmin almak ücretsizdir. Ücretli bir işten önce güncel model profillerini kullanın, isteği doğrulayın ve maliyete bakın. ## Bağlantı yolunu seçin - Sohbet asistanları ve diğer MCP istemcileri (ChatGPT, Claude ve uzak MCP ile OAuth destekleyen her istemci): [MCP sunucusuna](#mcp) bağlanın. - AnimaGuru ChatGPT eklentisi **yakında** geliyor; şu anda ChatGPT dizini için inceleniyor. Sohbetinize proje gezintisi, medya oynatma, kare inceleme ve üretim değerlendirmesi getirir. Önizlemesini [ajan kurulum rehberinde](https://animaguru.com/tr/agent-setup.md) görebilirsiniz. - Bir klasörde çalışan kodlama ajanları (Codex, Claude Code): [CLI](#cli) aracını kurun. [Ajan kurulum rehberi](https://animaguru.com/tr/agent-setup.md) adım adım anlatır. - Betikler ve arka uç servisleri: [OpenAPI belgesinde](https://animaguru.com/openapi.json) tanımlanan [REST API](#rest-api) uç noktalarını çağırın. ## MCP sunucusu Sunucu şu adreste Streamable HTTP aktarımını kullanır: MCP adresi: ``` https://animaguru.com/mcp ``` Kullanıcılar OAuth 2.1 ile giriş yapar: PKCE (S256) ile yetkilendirme kodu akışı ve dinamik istemci kaydı. İstemciler ihtiyaç duydukları her şeyi sunucunun 401 yanıtından öğrenir; bu yanıt [korunan kaynak meta verilerini](https://animaguru.com/.well-known/oauth-protected-resource) ve [yetkilendirme sunucusu meta verilerini](https://animaguru.com/.well-known/oauth-authorization-server) gösterir. Kapsamlar `projects.read` ve `projects.write`; erişim belirteçleri bir saat, yenileme belirteçleri 30 gün geçerlidir. Araçlar stüdyonun tamamını kapsar: `list_workspaces`, `list_projects`, `get_project`, `create_project`, `move_work`, `list_assets`, `estimate_generation`, `generate_character`, `animate_character`, `redraw_character`, `generate_custom_animation`, `generate_asset`, `list_avatars`, `list_avatar_looks`, `get_avatar`, `list_avatar_templates`, `create_avatar`, `create_avatar_looks`, `update_avatar`, `request_avatar_consent`, `search_motion_examples`, `get_motion_example`, `list_motion_categories`, `search_asset_library`, `get_library_asset`, `import_library_asset` (Pro ve Team planları), `list_jobs`, `get_job`, `get_ui_snapshot`, `get_profile` ve `open_studio`. Salt okunur araçlarda `readOnlyHint` bulunur. MCP Apps destekleyen istemcilerde `open_studio`, proje seçicileri, animasyon oynatma ve üretim incelemesi içeren etkileşimli bir stüdyo (`ui://animaguru/studio/v4.html`) açar. Projeleri stilden bağımsız kapsayıcılar olarak oluşturun ve stili her sprite isteğinde seçin. Çizimin tamamını yeniden çizdirmek için `redraw_character`, adlandırılmış hareketler için `generate_custom_animation` kullanın; ikisi de tek bir kareyi yerinde düzenlemez. Yapılandırılmış modelleri ve video profillerini `list_assets` ile okuyun, `estimate_generation` ile doğrulayın ve iş bitene kadar dönen aralıkla `get_job` çağırın. Avatar araçları HeyGen'in herkese açık avatarlarına her projeden göz atabilir ve bir prompt'tan, fotoğraftan ya da videodan projeye ait avatar oluşturur; bir projenin oluşturduğu avatarı yalnızca o proje görür, yeni bir görünüm tamamlanana kadar `get_avatar` ile izlenir. MCP üzerinden proje ya da avatar silinemez, yerel ZIP dışa aktarılamaz, film iskeleti kurulamaz, bulut eşitleme ve YouTube'da yayımlama yapılamaz; desteklenen yerel iş akışları için CLI'ı kullanın. Sunucu kartı [/mcp/server-card](https://animaguru.com/mcp/server-card) adresinde yayımlanır. ## Komut satırı aracı `animaguru` komutu Node.js 24 ya da üstünü gerektirir. npm'den ya da macOS'te kurulum betiğiyle kurun: npm: ``` npm install -g @docyrus/animaguru ``` macOS: ``` curl -fsSL https://animaguru.com/install.sh | bash ``` Bir kez giriş yapın. Tarayıcıda cihaz kodu onay sayfası açılır; CLI, iptal edilebilen yedi günlük bir oturum saklar: Giriş yapın: ``` animaguru auth login animaguru auth status animaguru credits ``` Mevcut bir oyun ya da uygulama için içerik üretecekseniz o klasörde `animaguru init` çalıştırın; ardından çizim üretmek, incelemek, indirmek ya da sprite ZIP'lerini dışa aktarmak için `projects`, `jobs`, `assets` ve `files` komutlarını kullanın. Tek bir film için `animaguru create my-video`; aynı markayı paylaşan filmler için `animaguru create workspace my-brand`, ardından içinde `animaguru create animation first-film` kullanın. Yeni çalışma alanlarında AGENTS.md, CLAUDE.md, yaratıcı beceriler ve PixiJS yönergeleri bulunur. `create` mevcut klasörlerin üzerine yazmaz. Yerel filmler HTML5 ve MP4 dışa aktarma, altyazı, kapak görseli ve birden fazla dil sürümünü destekler. `animaguru submit` bitmiş filmleri özel olarak barındırır, `videos` kütüphaneyi ve özel paylaşımı yönetir. Herkese açık galeride yayımlamak için web sitesinde paylaşım sözleşmesini kabul etmeniz ve AnimaGuru ekibinin onayı gerekir. `animaguru youtube`, dışa aktarılan MP4'leri ayrı bir Google Desktop OAuth bağlantısıyla doğrudan bilgisayarınızdan yükler; AnimaGuru üretim kredisi harcamaz. Güncel seçenekler için `--help` ve `animaguru schema` çıktısına bakın. Her komut başarılı olduğunda JSON yazdırır, hata durumunda sıfırdan farklı bir kodla çıkar. `animaguru catalog` sanat stillerini, hareketleri, içerik türlerini, modelleri ve sesleri listeler; `animaguru schema` komut şemasının tamamını yazdırır; `animaguru init` kodlama ajanınız için AnimaGuru becerisini kurar; `animaguru create my-video` bir video çalışma alanı oluşturur. Ajan çalıştıran ortamlar, giriş yapmak yerine belirteci `ANIMAGURU_TOKEN` ortam değişkeniyle verebilir. Paket: [npm'deki @docyrus/animaguru](https://www.npmjs.com/package/@docyrus/animaguru). Individual Pro ve Team planlarında `animaguru cloud`, bir video çalışma alanını tüm sürümleriyle eşitler. `cloud link` bulut projesini oluşturur, `cloud push -m` bir sürüm kaydeder, `cloud pull` başka yerde kaydedilen sürümleri getirir, `cloud restore` önceki bir sürüme döner, `cloud clone` ile başka bir bilgisayarda devam edersiniz. Bağımlılıklar, dışa aktarımlar, `.env` dosyaları, kimlik bilgileri ve `.gitignore` ile eşleşen dosyalar bilgisayarınızda kalır. Sürümlere göz atmak ve dosya indirmek için [Bulut sayfasını](https://animaguru.com/app/cloud) kullanın. Bulut eşitleme: ``` animaguru cloud link animaguru cloud push -m "İlk kurgu" animaguru cloud pull animaguru cloud versions ``` ## REST API API, `https://animaguru.com/api` adresinden JSON döndürür. [OpenAPI 3.1 belgesi](https://animaguru.com/openapi.json) her işlemi istek ve yanıt şemalarıyla tanımlar; [API kataloğu](https://animaguru.com/.well-known/api-catalog) da otomatik keşif için bu belgeye bağlanır. Birkaç uç nokta herkese açıktır: `GET /api/health`, `GET /api/videos` adresindeki herkese açık video galerisi ve `GET /api/billing` adresindeki kredi paketi bilgileri. `/api/v1` altındaki her şey giriş yapmış bir hesap adına çalışır ve bearer belirteci ister: Bakiyenizi kontrol edin: ``` curl https://animaguru.com/api/v1/credits \ -H "Authorization: Bearer $ANIMAGURU_TOKEN" ``` Tipik bir akış: projeleri `GET /api/v1/projects` ile listeleyin ya da `POST /api/v1/sprites` ile yeni proje oluşturun. Bir işin maliyetini `POST /api/v1/sprites/{id}/jobs/estimate` ya da `POST /api/v1/sprites/{id}/assets/estimate` ile öğrenin, aynı gövdeyi `/jobs` ya da `/assets` adresine göndererek işi kuyruğa alın, sonra iş bitene kadar `GET /api/v1/sprites/{id}/jobs/{jobId}` adresini yoklayın. Gönderirken `Idempotency-Key` başlığı ekleyin; böylece yeniden denenen bir istek işi iki kez kuyruğa almaz. Hatalar HTTP durum koduyla ve `{ "error": { "message": "…" } }` biçiminde bir JSON gövdesiyle döner. Belirteç yoksa ya da süresi dolmuşsa 401 döner. ## Kimlik doğrulama - MCP istemcileri: yukarıda anlatılan PKCE'li OAuth 2.1. Sunucu adresi dışında ayarlanacak bir şey yok. - CLI ve REST API: OAuth 2.0 cihaz yetkilendirme akışı. `animaguru-cli` istemci kimliğiyle `POST /api/auth/device/code` adresinden bir kod isteyin, dönen `verification_uri_complete` adresini giriş yapmışken açıp onaylayın, ardından `grant_type` değeri `urn:ietf:params:oauth:grant-type:device_code` olacak şekilde `POST /api/auth/device/token` adresini yoklayın. Yanıttaki `access_token` bearer belirtecidir. `animaguru auth login` bunların hepsini sizin yerinize yapar. - Hesap açmak ücretsizdir ve kimsenin onayını beklemez: herkes tarayıcıda [hesap oluşturabilir](https://animaguru.com/register), yeni hesaplar AnimaGuru'yu denemek için 30 ücretsiz krediyle başlar. Belirteçler, giriş yapan kişinin erişimiyle çalışır; üyesi olduğu ekip çalışma alanları da buna dahildir. [auth.md](https://animaguru.com/auth.md) bu adımları ajanlar için yeniden anlatır. ## Krediler ve güvenli deneme Yeni hesaplar AnimaGuru'yu denemek için 30 ücretsiz krediyle başlar; daha fazlası tek seferlik kredi paketleriyle alınır, üretim için abonelik gerekmez. Üretim, projenin sahibi olan kişisel ya da ekip çalışma alanının kredilerini harcar; proje oluşturmak, listelemek, incelemek ve tahmin almak ücretsizdir. MCP'de `estimate_generation` ve `dry_run: true` ile çağrılan üretim araçları, REST'te de `/estimate` uç noktaları, işi kuyruğa almadan ve kredi harcamadan sunucuda doğrulama yapar. CLI'daki `--dry-run` tahminleri paketteki fiyatları kullanır; sunucudaki model yapılandırmasını, referans sahipliğini ya da kalan bakiyeyi doğrulamaz, sunucu bunları gönderim sırasında kontrol eder. Ücretli bir işten önce tahmini gösterin. CLI'da ücretli gönderimler `--yes` ister; son ücreti sağlayıcının gerçek kullanımı belirler. Bakiyeyi `GET /api/v1/credits`, `animaguru credits` ya da MCP üzerinden `get_project` ile kontrol edin. Durumunu öğrenmek için ücretli bir işi asla yeniden göndermeyin; işi yoklayın. ## Ajan becerileri `animaguru init`, AnimaGuru becerisini projenizdeki `.agents/skills/animaguru/SKILL.md` dosyasına yazar; `animaguru create` her animasyon stili için ayrıca bir beceri ekler. Beceri; proje seçimini, kredi onayını, üretimi, işlerin beklenmesini ve içeriklerin dışa aktarılmasını anlatır. [Ajan becerileri dizini](https://animaguru.com/.well-known/agent-skills/index.json) yayımlanan becerileri listeler: biri MCP istemcileri, biri CLI için. ChatGPT eklentisinde MCP ve CLI yönergeleriyle PixiJS v8 becerileri hazır gelir. Eklenti inceleme sürdüğü için dizinde yakında yayımlanacak. Ajanınızın CLI ya da MCP kurulumunu bugün yapması için [ajan kurulum sayfasındaki](https://animaguru.com/tr/agent-setup.md) **Kurulum prompt'unu kopyala** düğmesini kullanın; prompt, salt okunur bir bağlantı kontrolüyle biter. ## Makinelerin okuyabildiği kaynaklar - [llms.txt](https://animaguru.com/llms.txt) ve [llms-full.txt](https://animaguru.com/llms-full.txt): dil modelleri için sitenin haritası ve bu sayfaların tam metni. - Herkese açık sayfaların Markdown sürümleri: adrese `.md` ekleyin; örneğin [/docs.md](https://animaguru.com/docs.md) ya da ana sayfa için [/index.md](https://animaguru.com/index.md). Ana sayfa `Accept: text/markdown` isteklerine de Markdown döndürür. - REST API için [openapi.json](https://animaguru.com/openapi.json) ve [API kataloğu](https://animaguru.com/.well-known/api-catalog). - MCP sunucusu için [yapay zekâ kataloğu](https://animaguru.com/.well-known/ai-catalog.json) ve [MCP sunucu kartı](https://animaguru.com/mcp/server-card). - Kimlik doğrulama için [auth.md](https://animaguru.com/auth.md) ve [ajan becerileri dizini](https://animaguru.com/.well-known/agent-skills/index.json). - [Site haritası](https://animaguru.com/sitemap.xml). ## Yardım hello@animaguru.com adresine yazın ya da [destek](https://animaguru.com/tr/support.md) sayfasına gidin. Hatanın ne zaman olduğunu ve aracın ya da uç noktanın adını belirtin. Parola ya da erişim belirteci asla göndermeyin.