メインコンテンツにスキップ

AIタトゥージェネレーターのAPI・CLI・MCPサーバー

ターミナル、スクリプト、AIエージェントからタトゥーデザインを作成できます。1つのnpmパッケージで、コマンドラインツールと、ClaudeとCursor向けのMCPサーバーが使えます。どちらもInk Studio AIアカウントのREST APIを使います。REST APIは直接呼び出すこともできます。

ターミナルからサインイン

npx inkstudioai login

新規アカウントには無料デザインが1回付きます。登録にカードは不要です。

できること

CLI、MCPサーバー、APIは、ウェブサイトと同じアカウント、デザイン、クレジットを使います。

デザインを生成

タトゥーを説明し、13種類のスタイル、カラーまたは黒インク、白背景または肌の上から選びます。各デザインはアカウントに保存されます。

ギャラリーを検索

公開タトゥーデザインのギャラリーから、キーワードでアイデアを探せます。APIキーは不要です。

クレジットを確認

プラン、無料デザイン、プレミアムクレジット、今日の残りAPIデザイン数を確認できます。

ターミナルから購入

コマンドラインからプランやクレジットパックを購入できます。CLIが安全なStripeの決済ページを開きます。

13種類のスタイル(API ID)

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

ターミナルでの短いセッション例

ブラウザで一度サインインするだけです。その後は、CLIがパソコンに保存したキーをすべてのコマンドで使います。
~/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.

クイックスタート

Node.js 18.17以降が必要です。ほかに何もインストールする必要はありません。
  1. サインイン

    ログインコマンドを実行します。ブラウザが開き、要求を承認すると、CLIがAPIキーを保存します。

    npx inkstudioai login

  2. デザインを作成

    タトゥーを説明してスタイルを選びます。デザインが完成すると、CLIが画像のリンクを表示します。

    npx inkstudioai generate "a fox curled inside a crescent moon" --style fine-line

  3. AIエージェントを接続

    MCPサーバーをClaude Code、Claude Desktop、Cursorに追加し、エージェントにタトゥーのアイデアを頼みましょう。

    npx -y inkstudioai mcp

CLIコマンドリファレンス

npxでコマンドを実行するか、npmでパッケージをグローバルにインストールします。--helpですべてのオプションを、--jsonで生のJSON出力を表示します。
inkstudioai login
ブラウザでサインインし、このパソコンにAPIキーを保存します。
inkstudioai generate "<prompt>" --style fine-line
プロンプトからタトゥーデザインを作成し、画像を保存します。オプション:--style、--color、--skin、--out。
inkstudioai styles
--styleで使えるスタイルIDを一覧表示します。
inkstudioai designs
アカウントに保存したデザインを新しい順に一覧表示します。
inkstudioai gallery <search>
公開タトゥーデザインのギャラリーを検索します。
inkstudioai whoami
アカウント、プラン、無料デザイン、クレジット、今日のAPI使用量を表示します。
inkstudioai pricing
プランとクレジットパックを価格付きで表示します。
inkstudioai buy 7-day-access
プランまたはクレジットパックのStripe決済ページを開きます。
inkstudioai open account
ウェブサイトのページを開きます:account、pricing、developers。
inkstudioai mcp
AIエージェント用のMCPサーバーを起動します。標準入出力を使います。
inkstudioai logout
保存したAPIキーをこのパソコンから削除します。

このパッケージは同じ機能の2つのコマンドをインストールします:inkstudioai と inkstudio。

REST API

どの言語からでもAPIを呼び出せます。レスポンスはJSONで、エラーはすべてのエンドポイントで同じ形式です。
ベースURL
https://inkstudioai.com/api/v1
認証
AuthorizationヘッダーでAPIキーを送信します:Authorization: Bearer isk_...

エンドポイント

  • POST/generationsデザインを作成します。Accept: text/event-stream を送ると進行状況のイベントを受け取れます。
  • GET/stylesスタイルを一覧表示します。キーは不要です。
  • GET/meアカウント、プラン、クレジット、今日のAPI使用量を取得します。
  • GET/designsアカウントに保存したデザインを一覧表示します。
  • GET/gallery公開ギャラリーを検索します。キーは不要です。
  • GET/pricingプランとクレジットパックを一覧表示します。キーは不要です。
  • POST/checkoutプランまたはクレジットパックのStripe決済リンクを取得します。

制限:キーごとに1分あたり60リクエスト、アカウントごとにUTCの1日あたり50デザイン。失敗した生成は課金されません。

リクエスト

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

レスポンス

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

AIエージェント向けMCPサーバー

Model Context Protocolを使うと、AIエージェントがInk Studio AIをツールとして使えます。サーバーはnpxでパソコン上で動き、ログインコマンドで保存したキーを使います。ターミナルがない場合は、エージェントにサインインを頼んでください。ログインツールがリンクとコードを表示します。

エージェントができること

  • 説明からタトゥーデザインを作成し、画像を表示します。
  • アイデアに合うスタイルを選びます。
  • 公開ギャラリーで参考デザインを探します。
  • プラン、クレジット、1日の上限を確認します。
  • さらに利用が必要なときに決済リンクを提示します。
shell
claude mcp add inkstudioai -- npx -y inkstudioai mcp

先にログインコマンドでサインインしてください。または、設定のenvブロックでキーを次の名前で設定します:INKSTUDIO_API_KEY

料金

APIはウェブサイトのプランを使います。プランがあれば、ウェブサイトでは無制限、APIでは1日最大50件のデザインを作成できます。

無料アカウント

$0.00

登録時に無料デザインが1回付きます。ギャラリー検索とスタイル一覧はいつでも無料です。

アクセスプラン

  • 7日間アクセスプレミアムクレジット10付き$12.99
  • 14日間アクセスプレミアムクレジット20付き$16.99
  • 30日間アクセスプレミアムクレジット30付き$23.99

ウェブサイトでは無制限、APIでは1日最大50件のデザイン。

クレジットパック

  • 20クレジット$9.99
  • 50クレジット$19.99
  • 120クレジット$39.99

ウェブサイトの画像ツール用プレミアムクレジット。クレジットパックには有効なプランが必要です。

すべてのプランを比較ターミナルから購入:inkstudioai buy 7-day-access

よくある質問

このツールと結果の使い方に関する一般的な質問への明確な回答。

無料デザインから始めましょう

アカウントを作成し、ターミナルからサインインして、1分以内に最初のタトゥーデザインを生成しましょう。