Was ist die Ink Studio AI CLI?

Es ist ein npm-Paket namens inkstudioai. Es erstellt Tattoo-Designs im Terminal, läuft als MCP-Server für KI-Agenten und nutzt dasselbe Konto wie die Website von Ink Studio AI.

Ist die Tattoo-Generator-API kostenlos?

Ein neues Konto erhält ein kostenloses Design. Danach gibt dir ein Zugangsplan unbegrenzt viele Designs auf der Website und bis zu 50 API-Designs pro Tag. Die Stilliste und die Galeriesuche sind kostenlos.

Wie bekomme ich einen API-Schlüssel?

Führe npx inkstudioai login aus und bestätige die Anfrage im Browser. Die CLI speichert den Schlüssel für dich. Du kannst auch auf deiner Kontoseite unter API-Schlüssel einen Schlüssel erstellen. Der vollständige Schlüssel wird nur einmal gezeigt.

Welche KI-Agenten können den MCP-Server nutzen?

Jeder MCP-Client, der einen lokalen Befehl starten kann. Dazu gehören Claude Code, Claude Desktop, Cursor und Windsurf. Der Server startet mit npx -y inkstudioai mcp.

Wo werden die Designs gespeichert?

Jedes Design wird privat im Designverlauf deines Kontos gespeichert. Du siehst es auf der Website und mit dem Befehl designs. API-Designs kommen nicht in die öffentliche Galerie.

Was passiert, wenn eine Generierung fehlschlägt?

Wenn der Bildanbieter ausfällt oder nicht rechtzeitig antwortet, zahlst du nichts, und ein kostenloses Design wird zurückgegeben. Ein Prompt, den die Inhaltsprüfung blockiert, verbraucht nie ein Design.

Kann ich im Terminal bezahlen?

Ja. Der Befehl buy öffnet eine Stripe-Bezahlseite in deinem Browser, und der Kauf wird deinem Konto hinzugefügt. Ein Credit-Paket braucht einen aktiven Plan.

Jeder Schlüssel kann 60 Anfragen pro Minute senden. Jedes Konto kann mit der API 50 Designs pro UTC-Tag erstellen. Wenn du ein Limit erreichst, antwortet die API mit 429 und einem Retry-After-Header.

For AI agents: the developer docs index is at https://inkstudioai.com/developers/llms.txt. Add .md to a docs page URL to get markdown.

KI-Tattoo-Generator: API, CLI und MCP-Server

Erstelle Tattoo-Designs im Terminal, in deinen Skripten oder mit einem KI-Agenten. Ein npm-Paket enthält ein Kommandozeilen-Tool und einen MCP-Server für Claude und Cursor. Beide nutzen die REST-API deines Ink Studio AI Kontos, die du auch direkt aufrufen kannst.

Im Terminal anmelden

npx inkstudioai login

Kostenloses Konto erstellen API-Schlüssel holen

Neue Konten erhalten ein kostenloses Design. Für die Registrierung brauchst du keine Karte.

Dokumentation

Anleitungen und Referenz für die API, die CLI und den MCP-Server. Die Anleitungen sind auf Englisch. Jede Seite gibt es auch als Markdown für KI-Agenten.

API reference
All endpoints of the Ink Studio AI REST API v1, with request fields and example responses.
Authentication
Get an API key with the CLI, the account page, or the device login, and send it as a Bearer token.
Generate tattoo designs
Create a tattoo design from a text prompt with POST /generations, as JSON or as a stream of progress events.
Errors and limits
Error codes, HTTP status codes, rate limits, and the daily generation limit of the API.
CLI
Create tattoo designs from your terminal with the inkstudioai npm package.
MCP server
Let Claude, Cursor, and other AI agents create tattoo designs with the Ink Studio AI MCP server.

Was du tun kannst

CLI, MCP-Server und API nutzen dasselbe Konto, dieselben Designs und dieselben Credits wie die Website.

Designs generieren

Beschreibe ein Tattoo und wähle einen von 13 Stilen, Farbe oder schwarze Tinte und einen weißen Hintergrund oder Haut. Jedes Design wird in deinem Konto gespeichert.

Galerie durchsuchen

Finde Ideen in der öffentlichen Galerie mit Tattoo-Designs per Stichwort, ohne API-Schlüssel.

Credits prüfen

Sieh deinen Plan, kostenlose Designs, Premium-Credits und wie viele API-Designs dir heute noch bleiben.

Im Terminal kaufen

Starte einen Plan oder ein Credit-Paket über die Kommandozeile. Die CLI öffnet eine sichere Stripe-Bezahlseite.

13 Stile, nach API-ID

minimal
fine-line
realism
surreal
text
neo-traditional
black-and-gray
watercolor
traditional
geometric
tribal
japanese
3d

Eine kurze Sitzung im Terminal

Melde dich einmal mit deinem Browser an. Danach nutzt jeder Befehl den Schlüssel, den die CLI auf deinem Computer gespeichert hat.

~/tattoo-ideas

$ npx inkstudioai login

  Sign in to Ink Studio AI

  Code   WDJB-MJHT
  Link   https://inkstudioai.com/cli/authorize?code=WDJB-MJHT

  Check that the page shows the same code, then approve.

✔ Signed in as [email protected]
  Key saved to ~/.config/inkstudioai/config.json

  Account          [email protected] (Ana)
  Plan             No active plan
  Free designs     1
  Next design      Free quality (uses your free design)

$ inkstudioai generate "a fox curled inside a crescent moon" --style fine-line
✔ Design ready in 21s
  File      a-fox-curled-inside-a-crescent-moon.webp
  Image     https://cdn.inkstudioai.com/free-tattoo-designs/6718f0c2.webp
  Style     fine-line, black ink, white background
  Quality   free (0 free designs left)
  Saved to  https://inkstudioai.com/account?view=tattoos

  Try it on your skin  https://inkstudioai.com/tools/try-tattoo?design=...
  Make a stencil       https://inkstudioai.com/tools/tattoo-to-stencil

$ inkstudioai buy 7-day-access
Opening Stripe checkout in your browser:
  https://checkout.stripe.com/c/pay/cs_live_a1B2c3...
After payment, run inkstudioai whoami to see your plan.

Schnellstart

Du brauchst Node.js 18.17 oder neuer. Sonst musst du nichts installieren.

Anmelden
Führe den Login-Befehl aus. Dein Browser öffnet sich, du bestätigst die Anfrage, und die CLI speichert einen API-Schlüssel.
npx inkstudioai login
Design erstellen
Beschreibe das Tattoo und wähle einen Stil. Die CLI zeigt den Bildlink, sobald das Design fertig ist.
npx inkstudioai generate "a fox curled inside a crescent moon" --style fine-line
KI-Agenten verbinden
Füge den MCP-Server zu Claude Code, Claude Desktop oder Cursor hinzu und frage deinen Agenten nach Tattoo-Ideen.
npx -y inkstudioai mcp

CLI-Befehlsreferenz

Führe einen Befehl mit npx aus oder installiere das Paket global mit npm. Mit --help siehst du alle Optionen eines Befehls, mit --json die JSON-Rohdaten.

BefehlFunktion

inkstudioai login: Mit dem Browser anmelden und einen API-Schlüssel auf diesem Computer speichern.
inkstudioai generate "<prompt>" --style fine-line: Ein Tattoo-Design aus einem Prompt erstellen und das Bild speichern. Optionen: --style, --color, --skin, --out.
inkstudioai styles: Die Stil-IDs auflisten, die du mit --style nutzen kannst.
inkstudioai designs: Die in deinem Konto gespeicherten Designs auflisten, die neuesten zuerst.
inkstudioai gallery <search>: Die öffentliche Galerie mit Tattoo-Designs durchsuchen.
inkstudioai whoami: Konto, Plan, kostenlose Designs, Credits und die heutige API-Nutzung anzeigen.
inkstudioai pricing: Die Pläne und Credit-Pakete mit Preisen anzeigen.
inkstudioai buy 7-day-access: Eine Stripe-Bezahlseite für einen Plan oder ein Credit-Paket öffnen.
inkstudioai open account: Eine Seite der Website öffnen: account, pricing oder developers.
inkstudioai mcp: Den MCP-Server für KI-Agenten starten. Er nutzt Standardeingabe und -ausgabe.
inkstudioai logout: Den gespeicherten API-Schlüssel von diesem Computer entfernen.

Das Paket installiert zwei Befehle mit derselben Funktion: inkstudioai und inkstudio.

REST-API

Rufe die API aus jeder Sprache auf. Die Antworten sind JSON, und Fehler haben an jedem Endpunkt dieselbe Form.

Basis-URL: https://inkstudioai.com/api/v1
Authentifizierung: Sende deinen API-Schlüssel im Authorization-Header: Authorization: Bearer isk_...

Endpunkte

POST /generations
Ein Design erstellen. Sende Accept: text/event-stream, um Fortschrittsereignisse zu erhalten.
GET /styles
Die Stile auflisten. Kein Schlüssel nötig.
GET /me
Konto, Plan, Credits und die heutige API-Nutzung abrufen.
GET /designs
Die gespeicherten Designs des Kontos auflisten.
GET /gallery
Die öffentliche Galerie durchsuchen. Kein Schlüssel nötig.
GET /pricing
Die Pläne und Credit-Pakete auflisten. Kein Schlüssel nötig.
POST /checkout
Einen Stripe-Bezahllink für einen Plan oder ein Credit-Paket abrufen.

Limits: 60 Anfragen pro Minute für jeden Schlüssel und 50 Designs pro Konto an jedem UTC-Tag. Eine fehlgeschlagene Generierung wird nicht berechnet.

CORS: Nein. Eine Webseite kann die API nicht aus dem Browser aufrufen. Nutze die API von einem Server, mit der CLI oder mit dem MCP-Server.

Anfrage

curl

curl https://inkstudioai.com/api/v1/generations \
  -H "Authorization: Bearer $INKSTUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a fox curled inside a crescent moon",
    "style": "fine-line",
    "color": false,
    "background": "white"
  }'

Antwort

200 OK

{
  "id": "6718f0c2a1b2c3d4e5f60718",
  "imageUrl": "https://cdn.inkstudioai.com/free-tattoo-designs/6718f0c2a1b2c3d4e5f60718.webp",
  "prompt": "a fox curled inside a crescent moon",
  "style": "fine-line",
  "color": false,
  "background": "white",
  "tier": "free",
  "freeGenerationsRemaining": 0,
  "createdAt": "2026-10-24T09:00:00.000Z"
}

MCP-Server für KI-Agenten

Mit dem Model Context Protocol nutzt ein KI-Agent Ink Studio AI als Werkzeug. Der Server läuft mit npx auf deinem Computer und nutzt den Schlüssel aus dem Login-Befehl. Kein Terminal? Bitte deinen Agenten, dich anzumelden: Sein Login-Tool gibt dir einen Link und einen Code.

Was dein Agent tun kann

Tattoo-Designs aus einer Beschreibung erstellen und das Bild zeigen.
Einen Stil wählen, der zur Idee passt.
Die öffentliche Galerie nach Vorlagen durchsuchen.
Deinen Plan, deine Credits und dein Tageslimit prüfen.
Dir einen Bezahllink geben, wenn du mehr Zugang brauchst.

shell

claude mcp add inkstudioai -- npx -y inkstudioai mcp

Melde dich zuerst mit dem Login-Befehl an. Oder setze deinen Schlüssel im env-Block der Konfiguration als INKSTUDIO_API_KEY

Preise

Die API nutzt deinen Website-Plan. Ein Plan gibt dir unbegrenzt viele Designs auf der Website und bis zu 50 API-Designs pro Tag.

Kostenloses Konto

0,00 $

Ein kostenloses Design bei der Registrierung. Galeriesuche und Stilliste sind immer kostenlos.

Zugangspläne

7 Tage Zugang
10 Premium-Credits inklusive
12,99 $
14 Tage Zugang
20 Premium-Credits inklusive
16,99 $
30 Tage Zugang
30 Premium-Credits inklusive
23,99 $

Unbegrenzt viele Designs auf der Website, bis zu 50 API-Designs pro Tag.

Credit-Pakete

20 Credits9,99 $
50 Credits19,99 $
120 Credits39,99 $

Premium-Credits für die Bild-Tools auf der Website. Ein Credit-Paket braucht einen aktiven Plan.

Alle Pläne vergleichen

Im Terminal kaufen: inkstudioai buy 7-day-access

Häufig gestellte Fragen

Klare Antworten auf häufige Fragen zu diesem Tool und deinen Ergebnissen.

Starte mit einem kostenlosen Design

Erstelle ein Konto, melde dich im Terminal an und generiere dein erstes Tattoo-Design in weniger als einer Minute.