AnimaGuru ile geliştirin

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 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 görebilirsiniz.
• Bir klasörde çalışan kodlama ajanları (Codex, Claude Code): CLI aracını kurun. Ajan kurulum rehberi adım adım anlatır.
• Betikler ve arka uç servisleri: OpenAPI belgesinde tanımlanan REST API uç noktalarını çağırın.

MCP sunucusu

Sunucu şu adreste Streamable HTTP aktarımını kullanır:

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 ve yetkilendirme sunucusu meta verilerini 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 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 install -g @docyrus/animaguru

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:

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.

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ı kullanın.

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 her işlemi istek ve yanıt şemalarıyla tanımlar; API kataloğu 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:

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, 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 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 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 **Kurulum prompt'unu kopyala** düğmesini kullanın; prompt, salt okunur bir bağlantı kontrolüyle biter.

Makinelerin okuyabildiği kaynaklar

• llms.txt ve 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 ya da ana sayfa için /index.md. Ana sayfa Accept: text/markdown isteklerine de Markdown döndürür.
• REST API için openapi.json ve API kataloğu.
• MCP sunucusu için yapay zekâ kataloğu ve MCP sunucu kartı.
• Kimlik doğrulama için auth.md ve ajan becerileri dizini.
• Site haritası.

Yardım

hello@animaguru.com adresine yazın ya da destek 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.