Che cos’è la CLI di Ink Studio AI?

È un pacchetto npm chiamato inkstudioai. Crea design di tatuaggi dal terminale, funziona come server MCP per gli agenti AI e usa lo stesso account del sito Ink Studio AI.

Come ottengo una chiave API?

Esegui npx inkstudioai login e approva la richiesta nel browser. La CLI salva la chiave per te. Puoi anche creare una chiave nella pagina del tuo account, in Chiavi API. La chiave completa viene mostrata una sola volta.

Quali agenti AI possono usare il server MCP?

Qualsiasi client MCP che può avviare un comando locale, tra cui Claude Code, Claude Desktop, Cursor e Windsurf. Il server si avvia con npx -y inkstudioai mcp.

Dove vengono salvati i design?

Ogni design viene salvato in privato nella cronologia del tuo account. Lo vedi sul sito e con il comando designs. I design creati con l’API non entrano nella galleria pubblica.

Cosa succede se una generazione fallisce?

Se il fornitore di immagini fallisce o va in timeout, non paghi nulla e il design gratuito ti viene restituito. Un prompt bloccato dal controllo dei contenuti non consuma mai un design.

Posso pagare dal terminale?

Sì. Il comando buy apre una pagina di pagamento Stripe nel browser e l’acquisto viene aggiunto al tuo account. Un pacchetto di crediti richiede un piano attivo.

Ci sono limiti di frequenza?

Ogni chiave può inviare 60 richieste al minuto. Ogni account può creare 50 design per giorno UTC con l’API. Quando raggiungi un limite, l’API risponde 429 con un’intestazione Retry-After.

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.

Generatore di tatuaggi AI: API, CLI e server MCP

Q: L’API del generatore di tatuaggi è gratuita?

Un nuovo account riceve un design gratuito. Dopo, un piano di accesso dà design illimitati sul sito e fino a 50 design API al giorno. L’elenco degli stili e la ricerca nella galleria sono gratuiti.

Crea design di tatuaggi dal terminale, dai tuoi script o con un agente AI. Un solo pacchetto npm ti dà uno strumento a riga di comando e un server MCP per Claude e Cursor. Entrambi usano la REST API del tuo account Ink Studio AI, che puoi anche chiamare direttamente.

Accedi dal terminale

npx inkstudioai login

Crea un account gratuito Ottieni una chiave API

I nuovi account ricevono un design gratuito. Per registrarti non serve una carta.

Documentazione

Guide e riferimento per l’API, la CLI e il server MCP. Le guide sono in inglese. Ogni pagina ha anche una versione markdown per gli agenti IA.

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.

Cosa puoi fare

La CLI, il server MCP e l’API usano lo stesso account, gli stessi design e gli stessi crediti del sito.

Genera design

Descrivi un tatuaggio e scegli uno dei 13 stili, a colori o in inchiostro nero, su sfondo bianco o sulla pelle. Ogni design viene salvato nel tuo account.

Cerca nella galleria

Trova idee per parola chiave nella galleria pubblica di design di tatuaggi, senza chiave API.

Controlla i crediti

Vedi il tuo piano, i design gratuiti, i crediti premium e quanti design API ti restano oggi.

Acquista dal terminale

Attiva un piano o un pacchetto di crediti dalla riga di comando. La CLI apre una pagina di pagamento Stripe sicura.

13 stili, per ID API

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

Una breve sessione nel terminale

Accedi una volta con il browser. Dopo, ogni comando usa la chiave che la CLI ha salvato sul tuo computer.

~/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.

Avvio rapido

Ti serve Node.js 18.17 o successivo. Non devi installare altro.

Accedi
Esegui il comando di accesso. Si apre il browser, approvi la richiesta e la CLI salva una chiave API.
npx inkstudioai login
Crea un design
Descrivi il tatuaggio e scegli uno stile. La CLI mostra il link dell’immagine quando il design è pronto.
npx inkstudioai generate "a fox curled inside a crescent moon" --style fine-line
Collega il tuo agente AI
Aggiungi il server MCP a Claude Code, Claude Desktop o Cursor e chiedi idee per tatuaggi al tuo agente.
npx -y inkstudioai mcp

Riferimento dei comandi CLI

Esegui un comando con npx oppure installa il pacchetto globalmente con npm. Aggiungi --help a un comando per vedere tutte le opzioni e --json per l’output JSON grezzo.

ComandoCosa fa

inkstudioai login: Accedi con il browser e salva una chiave API su questo computer.
inkstudioai generate "<prompt>" --style fine-line: Crea un design di tatuaggio da un prompt e salva l’immagine. Opzioni: --style, --color, --skin, --out.
inkstudioai styles: Elenca gli ID degli stili che puoi usare con --style.
inkstudioai designs: Elenca i design salvati nel tuo account, dal più recente.
inkstudioai gallery <search>: Cerca nella galleria pubblica di design di tatuaggi.
inkstudioai whoami: Mostra account, piano, design gratuiti, crediti e uso API di oggi.
inkstudioai pricing: Mostra i piani e i pacchetti di crediti con i prezzi.
inkstudioai buy 7-day-access: Apre una pagina di pagamento Stripe per un piano o un pacchetto di crediti.
inkstudioai open account: Apre una pagina del sito: account, pricing o developers.
inkstudioai mcp: Avvia il server MCP per gli agenti AI. Usa input e output standard.
inkstudioai logout: Rimuove la chiave API salvata da questo computer.

Il pacchetto installa due comandi con la stessa funzione: inkstudioai e inkstudio.

REST API

Chiama l’API da qualsiasi linguaggio. Le risposte sono in JSON e gli errori hanno la stessa forma su ogni endpoint.

URL di base: https://inkstudioai.com/api/v1
Autenticazione: Invia la tua chiave API nell’intestazione Authorization: Authorization: Bearer isk_...

Endpoint

POST /generations
Crea un design. Invia Accept: text/event-stream per ricevere gli eventi di avanzamento.
GET /styles
Elenca gli stili. Nessuna chiave richiesta.
GET /me
Restituisce account, piano, crediti e uso API di oggi.
GET /designs
Elenca i design salvati dell’account.
GET /gallery
Cerca nella galleria pubblica. Nessuna chiave richiesta.
GET /pricing
Elenca i piani e i pacchetti di crediti. Nessuna chiave richiesta.
POST /checkout
Restituisce un link di pagamento Stripe per un piano o un pacchetto di crediti.

Limiti: 60 richieste al minuto per ogni chiave e 50 design per account ogni giorno UTC. Una generazione fallita non viene addebitata.

CORS: no. Una pagina web non può chiamare l’API dal browser. Usa l’API da un server, dalla CLI o dal server MCP.

Richiesta

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"
  }'

Risposta

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"
}

Server MCP per agenti AI

Il Model Context Protocol permette a un agente AI di usare Ink Studio AI come strumento. Il server gira sul tuo computer con npx e usa la chiave del comando di accesso. Niente terminale? Chiedi al tuo agente di farti accedere: il suo strumento di accesso ti dà un link e un codice.

Cosa può fare il tuo agente

Creare design di tatuaggi da una descrizione e mostrare l’immagine.
Scegliere uno stile adatto all’idea.
Cercare riferimenti nella galleria pubblica.
Controllare il tuo piano, i crediti e il limite giornaliero.
Darti un link di pagamento quando ti serve più accesso.

shell

claude mcp add inkstudioai -- npx -y inkstudioai mcp

Prima accedi con il comando di accesso. Oppure imposta la tua chiave nel blocco env della configurazione come INKSTUDIO_API_KEY

Prezzi

L’API usa il tuo piano del sito. Un piano dà design illimitati sul sito e fino a 50 design API al giorno.

Account gratuito

0,00 USD

Un design gratuito alla registrazione. La ricerca nella galleria e l’elenco degli stili sono sempre gratuiti.

Piani di accesso

Accesso di 7 giorni
10 crediti premium inclusi
12,99 USD
Accesso di 14 giorni
20 crediti premium inclusi
16,99 USD
Accesso di 30 giorni
30 crediti premium inclusi
23,99 USD

Design illimitati sul sito, fino a 50 design API al giorno.

Pacchetti di crediti

20 crediti9,99 USD
50 crediti19,99 USD
120 crediti39,99 USD

Crediti premium per gli strumenti di immagine del sito. Un pacchetto di crediti richiede un piano attivo.

Confronta tutti i piani

Acquista dal terminale: inkstudioai buy 7-day-access

Domande frequenti

Risposte chiare alle domande più comuni sullo strumento e sull’uso dei risultati.

Inizia con un design gratuito

Crea un account, accedi dal terminale e genera il tuo primo design di tatuaggio in meno di un minuto.