# Bygg med AnimaGuru > Anslut AI-assistenter och kod till AnimaGuru: den fjärranslutna MCP-servern, CLI:t, REST-API:et med OpenAPI-specifikation, autentisering och krediter. AnimaGuru genererar bilder, karaktärer och spriteanimationer, video, musik, tal och ljudeffekter och samlar dem i projekt. Människor använder tjänsten i studion i webbläsaren. AI-assistenter och kod använder den via en fjärransluten MCP-server, ett kommandoradsgränssnitt och ett REST-API, alla kopplade till samma konto, samma projekt och samma krediter. ## 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 55 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](#mcp). - 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](https://animaguru.com/sv/agent-setup.md). - Kodningsagenter som arbetar i en mapp (Codex, Claude Code): installera [CLI:t](#cli). [Guiden för att ansluta agenter](https://animaguru.com/sv/agent-setup.md) går igenom det steg för steg. - Skript och backends: anropa [REST-API:et](#rest-api) som beskrivs i [OpenAPI-dokumentet](https://animaguru.com/openapi.json). ## MCP-server Servern använder transporten Streamable HTTP på den här adressen: MCP-URL: ``` 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](https://animaguru.com/.well-known/oauth-protected-resource) och [metadata för auktoriseringsservern](https://animaguru.com/.well-known/oauth-authorization-server). 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](https://animaguru.com/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: ``` npm install -g @docyrus/animaguru ``` macOS: ``` 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: Logga in: ``` 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](https://www.npmjs.com/package/@docyrus/animaguru). 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](https://animaguru.com/app). Molnsynkronisering: ``` 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](https://animaguru.com/openapi.json) beskriver varje operation med scheman för begäran och svar, och [API-katalogen](https://animaguru.com/.well-known/api-catalog) 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: Kontrollera ditt saldo: ``` 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](https://animaguru.com/register) 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](https://animaguru.com/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](https://animaguru.com/.well-known/agent-skills/index.json) 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](https://animaguru.com/sv/agent-setup.md); prompten avslutas med en skrivskyddad anslutningskontroll. ## Maskinläsbara resurser - [llms.txt](https://animaguru.com/llms.txt) och [llms-full.txt](https://animaguru.com/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](https://animaguru.com/docs.md) eller [/index.md](https://animaguru.com/index.md) för startsidan. Startsidan svarar också på `Accept: text/markdown`. - [openapi.json](https://animaguru.com/openapi.json) och [API-katalogen](https://animaguru.com/.well-known/api-catalog) för REST-API:et. - [AI-katalogen](https://animaguru.com/.well-known/ai-catalog.json) och [MCP-serverkortet](https://animaguru.com/mcp/server-card) för MCP-servern. - [auth.md](https://animaguru.com/auth.md) för autentisering och [indexet över agentskills](https://animaguru.com/.well-known/agent-skills/index.json). - [Webbplatskartan](https://animaguru.com/sitemap.xml). ## Hjälp Skicka e-post till hello@animaguru.com eller besök [support](https://animaguru.com/sv/support.md). Ange tidpunkten för felet och namnet på verktyget eller slutpunkten. Skicka aldrig lösenord eller åtkomsttoken.