Qu’est-ce que la CLI Ink Studio AI ?

C’est un paquet npm nommé inkstudioai. Il crée des designs de tatouage depuis le terminal, fonctionne comme serveur MCP pour les agents IA et utilise le même compte que le site Ink Studio AI.

Comment obtenir une clé API ?

Lancez npx inkstudioai login et approuvez la demande dans votre navigateur. La CLI enregistre la clé pour vous. Vous pouvez aussi créer une clé sur la page de votre compte, dans Clés API. La clé complète n’est affichée qu’une seule fois.

Quels agents IA peuvent utiliser le serveur MCP ?

Tout client MCP capable de lancer une commande locale, dont Claude Code, Claude Desktop, Cursor et Windsurf. Le serveur démarre avec npx -y inkstudioai mcp.

Où les designs sont-ils enregistrés ?

Chaque design est enregistré en privé dans l’historique de votre compte. Vous le voyez sur le site et avec la commande designs. Les designs créés par l’API ne sont pas ajoutés à la galerie publique.

Que se passe-t-il si une génération échoue ?

Si le fournisseur d’images échoue ou dépasse le délai, rien ne vous est facturé et le design gratuit vous est rendu. Un prompt bloqué par le contrôle de contenu ne consomme jamais de design.

Puis-je payer depuis le terminal ?

Oui. La commande buy ouvre une page de paiement Stripe dans votre navigateur, et l’achat est ajouté à votre compte. Un pack de crédits nécessite un forfait actif.

Y a-t-il des limites de débit ?

Chaque clé peut envoyer 60 requêtes par minute. Chaque compte peut créer 50 designs par jour UTC avec l’API. Quand vous atteignez une limite, l’API répond 429 avec un en-tête Retry-After.

Générateur de tatouages IA : API, CLI et serveur MCP

Q: L’API du générateur de tatouages est-elle gratuite ?

Un nouveau compte reçoit un design gratuit. Ensuite, un forfait d’accès donne des designs illimités sur le site et jusqu’à 50 designs API par jour. La liste des styles et la recherche dans la galerie sont gratuites.

Créez des designs de tatouage depuis votre terminal, vos scripts ou un agent IA. Un seul paquet npm vous donne un outil en ligne de commande et un serveur MCP pour Claude et Cursor. Les deux utilisent l’API REST de votre compte Ink Studio AI, que vous pouvez aussi appeler directement.

Connectez-vous depuis votre terminal

npx inkstudioai login

Créer un compte gratuit Obtenir une clé API

Les nouveaux comptes reçoivent un design gratuit. Aucune carte n’est nécessaire pour l’inscription.

Ce que vous pouvez faire

La CLI, le serveur MCP et l’API utilisent le même compte, les mêmes designs et les mêmes crédits que le site.

Générer des designs

Décrivez un tatouage et choisissez l’un des 13 styles, en couleur ou à l’encre noire, sur fond blanc ou sur la peau. Chaque design est enregistré dans votre compte.

Chercher dans la galerie

Trouvez des idées par mot-clé dans la galerie publique de designs de tatouage, sans clé API.

Consulter vos crédits

Voyez votre forfait, vos designs gratuits, vos crédits premium et le nombre de designs API qui vous restent aujourd’hui.

Acheter depuis le terminal

Lancez un forfait ou un pack de crédits depuis la ligne de commande. La CLI ouvre une page de paiement Stripe sécurisée.

13 styles, par identifiant API

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

Une courte session dans le terminal

Connectez-vous une fois avec votre navigateur. Ensuite, chaque commande utilise la clé que la CLI a enregistrée sur votre ordinateur.

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

Démarrage rapide

Il vous faut Node.js 18.17 ou une version plus récente. Rien d’autre à installer.

Se connecter
Lancez la commande de connexion. Votre navigateur s’ouvre, vous approuvez la demande, et la CLI enregistre une clé API.
npx inkstudioai login
Créer un design
Décrivez le tatouage et choisissez un style. La CLI affiche le lien de l’image quand le design est prêt.
npx inkstudioai generate "a fox curled inside a crescent moon" --style fine-line
Connecter votre agent IA
Ajoutez le serveur MCP à Claude Code, Claude Desktop ou Cursor, puis demandez des idées de tatouage à votre agent.
npx -y inkstudioai mcp

Référence des commandes CLI

Lancez une commande avec npx, ou installez le paquet globalement avec npm. Ajoutez --help à une commande pour voir toutes ses options, et --json pour obtenir le JSON brut.

CommandeFonction

inkstudioai login: Se connecter avec le navigateur et enregistrer une clé API sur cet ordinateur.
inkstudioai generate "<prompt>" --style fine-line: Créer un design de tatouage à partir d’un prompt et enregistrer l’image. Options : --style, --color, --skin, --out.
inkstudioai styles: Lister les identifiants de style utilisables avec --style.
inkstudioai designs: Lister les designs enregistrés dans votre compte, du plus récent au plus ancien.
inkstudioai gallery <search>: Chercher dans la galerie publique de designs de tatouage.
inkstudioai whoami: Afficher votre compte, votre forfait, vos designs gratuits, vos crédits et votre usage API du jour.
inkstudioai pricing: Afficher les forfaits et les packs de crédits avec leurs prix.
inkstudioai buy 7-day-access: Ouvrir une page de paiement Stripe pour un forfait ou un pack de crédits.
inkstudioai open account: Ouvrir une page du site : account, pricing ou developers.
inkstudioai mcp: Démarrer le serveur MCP pour les agents IA. Il utilise l’entrée et la sortie standard.
inkstudioai logout: Supprimer la clé API enregistrée sur cet ordinateur.

Le paquet installe deux commandes identiques : inkstudioai et inkstudio.

API REST

Appelez l’API depuis n’importe quel langage. Les réponses sont en JSON, et les erreurs ont la même forme sur tous les endpoints.

URL de base: https://inkstudioai.com/api/v1
Authentification: Envoyez votre clé API dans l’en-tête Authorization : Authorization: Bearer isk_...

Endpoints

POST/generationsCréer un design. Envoyez Accept: text/event-stream pour recevoir les étapes de progression.
GET/stylesLister les styles. Aucune clé nécessaire.
GET/meObtenir le compte, le forfait, les crédits et l’usage API du jour.
GET/designsLister les designs enregistrés du compte.
GET/galleryChercher dans la galerie publique. Aucune clé nécessaire.
GET/pricingLister les forfaits et les packs de crédits. Aucune clé nécessaire.
POST/checkoutObtenir un lien de paiement Stripe pour un forfait ou un pack de crédits.

Limites : 60 requêtes par minute pour chaque clé, et 50 designs par compte chaque jour UTC. Une génération échouée n’est pas facturée.

Spécification OpenAPI Paquet sur npm

Requête

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

Réponse

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

Serveur MCP pour les agents IA

Le Model Context Protocol permet à un agent IA d’utiliser Ink Studio AI comme outil. Le serveur tourne sur votre ordinateur avec npx et utilise la clé de la commande de connexion. Pas de terminal ? Demandez à votre agent de vous connecter : son outil de connexion vous donne un lien et un code.

Ce que votre agent peut faire

Créer des designs de tatouage à partir d’une description et afficher l’image.
Choisir un style adapté à l’idée.
Chercher des références dans la galerie publique.
Vérifier votre forfait, vos crédits et votre limite quotidienne.
Vous donner un lien de paiement quand vous avez besoin de plus d’accès.

shell

claude mcp add inkstudioai -- npx -y inkstudioai mcp

Connectez-vous d’abord avec la commande de connexion. Ou définissez votre clé dans le bloc env de la configuration avec INKSTUDIO_API_KEY

Tarifs

L’API utilise votre forfait du site. Un forfait donne des designs illimités sur le site et jusqu’à 50 designs API par jour.

Compte gratuit

0,00 $US

Un design gratuit à l’inscription. La recherche dans la galerie et la liste des styles sont toujours gratuites.

Forfaits d’accès

Accès 7 jours10 crédits premium inclus12,99 $US
Accès 14 jours20 crédits premium inclus16,99 $US
Accès 30 jours30 crédits premium inclus23,99 $US

Designs illimités sur le site, jusqu’à 50 designs API par jour.

Packs de crédits

20 crédits9,99 $US
50 crédits19,99 $US
120 crédits39,99 $US

Crédits premium pour les outils d’image du site. Un pack de crédits nécessite un forfait actif.

Comparer tous les forfaitsAcheter depuis le terminal : inkstudioai buy 7-day-access

Questions fréquentes

Des réponses claires aux questions courantes sur cet outil et l’utilisation des résultats.

Commencez avec un design gratuit

Créez un compte, connectez-vous depuis votre terminal et générez votre premier design de tatouage en moins d’une minute.