Ink Studio AI CLIとは何ですか？

inkstudioaiという名前のnpmパッケージです。ターミナルからタトゥーデザインを作成し、AIエージェント用のMCPサーバーとして動作し、Ink Studio AIのウェブサイトと同じアカウントを使います。

タトゥージェネレーターAPIは無料ですか？

新規アカウントには無料デザインが1回付きます。その後は、アクセスプランでウェブサイトでは無制限、APIでは1日最大50件のデザインを作成できます。スタイル一覧とギャラリー検索は無料です。

APIキーはどう取得しますか？

npx inkstudioai login を実行し、ブラウザで要求を承認します。CLIがキーを保存します。アカウントページの「APIキー」でキーを作成することもできます。完全なキーは一度だけ表示されます。

どのAIエージェントがMCPサーバーを使えますか？

ローカルコマンドを起動できるMCPクライアントなら使えます。Claude Code、Claude Desktop、Cursor、Windsurfなどです。サーバーは npx -y inkstudioai mcp で起動します。

デザインはどこに保存されますか？

各デザインはアカウントのデザイン履歴に非公開で保存されます。ウェブサイトやdesignsコマンドで確認できます。APIで作成したデザインは公開ギャラリーに追加されません。

生成に失敗した場合はどうなりますか？

画像プロバイダーが失敗またはタイムアウトした場合、料金はかからず、無料デザインも戻ります。コンテンツチェックでブロックされたプロンプトがデザインを消費することはありません。

ターミナルから支払えますか？

はい。buyコマンドがブラウザでStripeの決済ページを開き、購入内容がアカウントに追加されます。クレジットパックには有効なプランが必要です。

レート制限はありますか？

各キーは1分あたり60リクエストまで送信できます。各アカウントはAPIでUTCの1日あたり50件のデザインを作成できます。上限に達すると、APIは429と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.

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

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

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

npx inkstudioai login

無料アカウントを作成 APIキーを取得

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

ドキュメント

API、CLI、MCP サーバーのガイドとリファレンスです。ガイドは英語です。各ページには AI エージェント向けの Markdown 版があります。

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.

できること

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

クイックスタート

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

サインイン
ログインコマンドを実行します。ブラウザが開き、要求を承認すると、CLIがAPIキーを保存します。
npx inkstudioai login
デザインを作成
タトゥーを説明してスタイルを選びます。デザインが完成すると、CLIが画像のリンクを表示します。
npx inkstudioai generate "a fox curled inside a crescent moon" --style fine-line
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デザイン。失敗した生成は課金されません。

CORS：非対応です。Web ページからブラウザで API を直接呼び出すことはできません。API はサーバー、CLI、または MCP サーバーから使用してください。

リクエスト

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分以内に最初のタトゥーデザインを生成しましょう。