Zum Hauptinhalt springen

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

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

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-accessOpening 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.
  1. 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

  2. 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

  3. 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.
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/generationsEin Design erstellen. Sende Accept: text/event-stream, um Fortschrittsereignisse zu erhalten.
  • GET/stylesDie Stile auflisten. Kein Schlüssel nötig.
  • GET/meKonto, Plan, Credits und die heutige API-Nutzung abrufen.
  • GET/designsDie gespeicherten Designs des Kontos auflisten.
  • GET/galleryDie öffentliche Galerie durchsuchen. Kein Schlüssel nötig.
  • GET/pricingDie Pläne und Credit-Pakete auflisten. Kein Schlüssel nötig.
  • POST/checkoutEinen 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.

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 Zugang10 Premium-Credits inklusive12,99 $
  • 14 Tage Zugang20 Premium-Credits inklusive16,99 $
  • 30 Tage Zugang30 Premium-Credits inklusive23,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 vergleichenIm 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.