Bygg med AnimaGuru

När du ska använda AnimaGuru

Använd AnimaGuru när du vill ha originalbilder, karaktärer och annat kreativt innehåll skapat åt dig och samlat på ett ställe:

• Illustrerade karaktärer och rekvisita samt spriteanimationer av dem: vila, gå, springa, hoppa, slå, ta stryk och andra handlingar, eller en egen rörelse som du beskriver med ord. Exporterna omfattar spritesheets och animationsdata för spel.
• Bilder och korta videor från text eller bilder, inklusive referenser till första och sista bildrutan, förlängning av klipp och ljudreferenser där den konfigurerade modellen stöder det.
• Musik, tal i en rad olika röster och ljudeffekter.
• Korta animerade filmer: CLI:t skapar en lokal videoarbetsyta med 48 visuella stilar, som en kodningsagent fyller med genererat innehåll och exporterar till MP4.

CLI:t sätter ihop lokala filmer med PixiJS för uppspelning i webbläsaren och export till HTML5 eller MP4. AI-generering körs asynkront och drar krediter från det anslutna kontot; att skapa projekt, bläddra och beräkna kostnad är gratis. Använd aktuella modellprofiler, validera begäran och granska kostnaden innan du startar betalt arbete.

Välj gränssnitt

• Chattassistenter och andra MCP-klienter (ChatGPT, Claude och alla klienter med fjärr-MCP och OAuth): anslut MCP-servern.
• AnimaGuru-pluginet för ChatGPT kommer **snart** och granskas just nu för ChatGPT-katalogen. Det ger dig projektbläddring, mediauppspelning, bildruteinspektion och granskning av generering direkt i konversationen. Se förhandsvisningen i guiden för att ansluta agenter.
• Kodningsagenter som arbetar i en mapp (Codex, Claude Code): installera CLI:t. Guiden för att ansluta agenter går igenom det steg för steg.
• Skript och backends: anropa REST-API:et som beskrivs i OpenAPI-dokumentet.

MCP-server

Servern använder transporten Streamable HTTP på den här adressen:

https://animaguru.com/mcp

Den loggar in användare med OAuth 2.1: auktoriseringskodflödet med PKCE (S256) och dynamisk klientregistrering. Klienter hittar allt utifrån serverns 401-svar, som pekar på metadata för den skyddade resursen och metadata för auktoriseringsservern. Scopen är projects.read och projects.write; åtkomsttoken gäller i en timme och uppdateringstoken i 30 dagar.

Verktygen täcker hela studion: 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 (planerna Pro och Team), list_jobs, get_job, get_ui_snapshot, get_profile och open_studio. Skrivskyddade verktyg har readOnlyHint. I klienter som stöder MCP Apps visar open_studio en interaktiv studio (ui://animaguru/studio/v4.html) med projektväljare, uppspelning av animationer och granskning av generering.

Skapa neutrala projektbehållare och välj en stil för varje sprite-begäran. Använd redraw_character för revideringar av hela bilden och generate_custom_animation för namngivna rörelser; de redigerar inte enskilda bildrutor på plats. Läs konfigurerade modeller och videoprofiler med list_assets, validera med estimate_generation och polla get_job med det returnerade intervallet tills jobbet är klart. Avatarverktygen bläddrar bland HeyGens offentliga avatarer från vilket projekt som helst och skapar ett projekts egna avatarer från en prompt, ett foto eller filmmaterial; en avatar som ett projekt skapar syns bara i det projektet, och en ny look pollas med get_avatar tills den är klar. MCP erbjuder inte borttagning av projekt eller avatarer, lokal ZIP-export, uppsättning av filmprojekt, molnsynkronisering eller publicering på YouTube; använd CLI:t för de lokala arbetsflöden som stöds.

Serverkortet publiceras på /mcp/server-card.

Kommandoradsgränssnitt

Kommandot animaguru kräver Node.js 24 eller senare. Installera det från npm, eller på macOS med installationsskriptet:

npm install -g @docyrus/animaguru

curl -fsSL https://animaguru.com/install.sh | bash

Logga in en gång. Webbläsaren öppnar en godkännandesida för enhetskod, och CLI:t lagrar en återkallelsebar session som gäller i sju dagar:

animaguru auth login
animaguru auth status
animaguru credits

För innehåll i ett befintligt spel eller en befintlig app kör du animaguru init i den mappen och använder sedan projects, jobs, assets och files för att generera, granska och ladda ner bilder eller exportera sprite-ZIP-filer. För en enskild film använder du animaguru create my-video; för gemensam varumärkesprofil använder du animaguru create workspace my-brand och sedan animaguru create animation first-film inuti den. Nya arbetsytor innehåller AGENTS.md, CLAUDE.md, kreativa skills och PixiJS-vägledning. Befintliga mappar ersätts inte av create.

Lokala filmer stöder export till HTML5 och MP4, undertexter, affischbilder och flera språkversioner. animaguru submit laddar upp färdiga filmer för privat hosting, och videos hanterar biblioteket och privat delning. Publicering i det offentliga galleriet kräver att du godkänner delningsavtalet på webbplatsen samt granskning av AnimaGuru-teamet. animaguru youtube laddar upp exporterade MP4-filer direkt från din dator via en separat Google Desktop OAuth-anslutning; det använder inga krediter för generering i AnimaGuru. Kontrollera --help och animaguru schema för aktuella flaggor.

Varje kommando skriver ut JSON när det lyckas och avslutas med en felkod vid fel. animaguru catalog listar konststilar, handlingar, innehållstyper, modeller och röster; animaguru schema skriver ut hela kommandoschemat; animaguru init installerar AnimaGuru-skillen för din kodningsagent; animaguru create my-video skapar en videoarbetsyta. Agentkörare kan ange en token med miljövariabeln ANIMAGURU_TOKEN i stället för att logga in. Paketet är @docyrus/animaguru på npm.

I Individual Starter, Individual Pro och Team synkroniserar animaguru cloud en videoarbetsyta med ett projekts animationer och sparar varje version. cloud link skapar ett projekt för mappen (eller --project synkroniserar med ett befintligt), cloud push -m sparar en version, cloud pull hämtar versioner som sparats någon annanstans, cloud restore går tillbaka till en tidigare och cloud clone fortsätter på en annan dator. Beroenden, exporter, .env-filer, inloggningsuppgifter och sådant som matchar .gitignore stannar lokalt. Bläddra bland filmer, versioner och filer på projektets flik Animationer i Projekt.

animaguru cloud link
animaguru cloud push -m "First cut"
animaguru cloud pull
animaguru cloud versions

REST-API

API:et levererar JSON från https://animaguru.com/api. OpenAPI 3.1-dokumentet beskriver varje operation med scheman för begäran och svar, och API-katalogen länkar till det för automatisk upptäckt.

Några få slutpunkter är offentliga: GET /api/health, det offentliga videogalleriet på GET /api/videos och information om kreditpaket på GET /api/billing. Allt under /api/v1 agerar för ett inloggat konto och kräver en bearer-token:

curl https://animaguru.com/api/v1/credits \
  -H "Authorization: Bearer $ANIMAGURU_TOKEN"

Ett typiskt flöde: lista projekt med GET /api/v1/projects eller skapa ett med POST /api/v1/sprites. Beräkna kostnaden för ett jobb med POST /api/v1/sprites/{id}/jobs/estimate eller POST /api/v1/sprites/{id}/assets/estimate, köa det med samma body på /jobs eller /assets och polla sedan GET /api/v1/sprites/{id}/jobs/{jobId} tills det är klart. Skicka med rubriken Idempotency-Key när du skickar in, så att en begäran som görs om inte köar jobbet två gånger.

Fel returneras som HTTP-statuskoder med en JSON-body på formen { "error": { "message": "…" } }. En saknad eller utgången token ger 401.

Autentisering

• MCP-klienter: OAuth 2.1 med PKCE, enligt beskrivningen ovan. Inget att konfigurera utöver server-URL:en.
• CLI och REST-API: OAuth 2.0 device authorization grant. Begär en kod med POST /api/auth/device/code och klient-ID:t animaguru-cli, öppna den returnerade verification_uri_complete för att godkänna den medan du är inloggad och polla sedan POST /api/auth/device/token med grant_type satt till urn:ietf:params:oauth:grant-type:device_code. Svarets access_token är bearer-token. animaguru auth login gör allt det här åt dig.
• Konton skapar du själv och de är gratis: vem som helst kan skapa ett konto i webbläsaren, och nya konton startar med 100 gratis krediter för att prova AnimaGuru. Tokens agerar med den inloggade personens behörighet, inklusive teamarbetsytor som personen tillhör.

auth.md sammanfattar de här stegen för agenter.

Krediter och säker testning

Nya konton startar med 100 gratis krediter för att prova AnimaGuru, och fler får du i engångspaket med krediter; ingen prenumeration krävs för att generera. Generering drar krediter från den personliga arbetsyta eller teamarbetsyta som äger projektet; att skapa projekt, lista, granska och beräkna kostnad är gratis.

MCP estimate_generation och genereringsverktyg med dry_run: true, samt REST-slutpunkterna /estimate, validerar mot servern utan att köa arbete eller dra krediter. Uppskattningar med CLI:ts --dry-run använder inbyggda priser och verifierar inte serverns modellkonfiguration, ägarskap för referenser eller återstående saldo; servern kontrollerar detta vid inskickning. Visa uppskattningen innan du startar betalt arbete. Betalda inskickningar med CLI kräver --yes; den faktiska användningen hos leverantören avgör slutlig kostnad.

Kontrollera saldot med GET /api/v1/credits, animaguru credits eller get_project via MCP. Skicka aldrig om ett betalt jobb för att kolla läget; polla jobbet i stället.

Skills för agenter

animaguru init skriver AnimaGuru-skillen till .agents/skills/animaguru/SKILL.md i ditt projekt, och animaguru create lägger till en skill för varje animationsstil. Skillen beskriver hur man väljer projekt, godkänner krediter, genererar, väntar på jobb och exporterar innehåll. Indexet över agentskills listar de publicerade skills: en för MCP-klienter och en för CLI:t.

ChatGPT-pluginet innehåller vägledning för MCP och CLI samt PixiJS v8-skills. Katalogutgåvan kommer snart medan granskningen pågår. Vill du låta en agent sköta CLI- eller MCP-installationen redan nu använder du **Kopiera installationsprompt** på sidan för att ansluta agenter; prompten avslutas med en skrivskyddad anslutningskontroll.

Maskinläsbara resurser

• llms.txt och llms-full.txt: en karta över webbplatsen för språkmodeller och hela texten på de här sidorna.
• Markdown-versioner av offentliga sidor: lägg till .md i sökvägen, som i /docs.md eller /index.md för startsidan. Startsidan svarar också på Accept: text/markdown.
• openapi.json och API-katalogen för REST-API:et.
• AI-katalogen och MCP-serverkortet för MCP-servern.
• auth.md för autentisering och indexet över agentskills.
• Webbplatskartan.

Hjälp

Skicka e-post till hello@animaguru.com eller besök support. Ange tidpunkten för felet och namnet på verktyget eller slutpunkten. Skicka aldrig lösenord eller åtkomsttoken.