Ink Studio AI

inkstudioai

ターミナルやAIエージェント向けのAIタトゥー生成ツールです。

新規アカウントでは、カード登録不要でデザインを1点無料で作成できます。

inkstudioai は Ink Studio AI の公式コマンドラインツールです。タトゥーの内容を言葉で説明すると、完成したデザインを画像ファイルとして取得できます。MCP サーバーとしても動作するため、Claude、Cursor、Windsurf などのAIエージェントを使ってタトゥーデザインを作成できます。

• ファインライン、日本風、トラディショナル、リアリズムなどのスタイルで、テキストからタトゥーデザインを作成できます。
• アカウント登録なしで、アイデア探しに公開タトゥーデザインギャラリーを検索できます。
• プランとクレジットを確認し、ターミナルからプランを購入できます。
• 依存関係はありません。Node.js 18.17 以降が必要です。

インストール

npx で一度だけ実行します。

npx inkstudioai login

または、グローバルにインストールします。

npm i -g inkstudioai

このパッケージをインストールすると、inkstudioai と、より短い inkstudio の2つのコマンド名が使えるようになります。どちらも同じツールです。

クイックスタート

# 1. Sign in. No account yet? Create one in the browser. New accounts get one free design.
npx inkstudioai login

# 2. Create a design. The image is saved in the current directory.
npx inkstudioai generate "a fox sleeping inside a crescent moon" --style fine-line

# 3. Look for ideas in the public gallery.
npx inkstudioai gallery dragon

新規アカウントで無料デザインを使って generate を実行した場合の出力：

✔ Design ready in 21s
  File      a-fox-sleeping-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&utm_source=cli&utm_medium=referral

  Try it on your skin  https://inkstudioai.com/tools/try-tattoo?design=https%3A%2F%2Fcdn.inkstudioai.com%2F...
  Make a stencil       https://inkstudioai.com/tools/tattoo-to-stencil?utm_source=cli&utm_medium=referral

試着リンクを開くと、新しいデザインが読み込まれた状態でウェブサイトのタトゥーシミュレーターが表示されます。ウェブサイトのページへのリンクには utm_source=cli が付与されるため、Ink Studio AI はCLIからの訪問をカウントできます。画像、API、チェックアウトへのリンクには、このようなパラメーターは付きません。

コマンド

すべてのコマンドで --help を使用できます。また、inkstudioai help <command> でも同じ内容を確認できます。グローバルオプション：

オプション	説明
--json	スクリプトやエージェント向けに、生のJSONを出力します
--api-key <key>	INKSTUDIO_API_KEY または保存済みのキーの代わりに、このキーを使用します
--no-color	色を無効にします。NO_COLOR も使用できます
-h, --help	ヘルプを表示します
-v, --version	バージョンを表示します

login

ブラウザーでサインインします。ターミナルにコードが表示され、ページが開きます。ページに同じコードが表示されていることを確認してから、承認してください。CLIはAPIキーをコンピューターに保存します。

Ink Studio AIを初めて利用する場合は、同じページでアカウントを作成してください。新規アカウントではタトゥーデザインを1点無料で作成できます。

inkstudioai login
inkstudioai login --no-browser          # print the link, do not open a browser
inkstudioai login --key isk_...         # save a key from your account page
echo "$KEY" | inkstudioai login --with-key

ターミナルでは、--with-key を指定するとキーの貼り付けを求められるので、貼り付けてEnterキーを押してください。

generate（別名：gen）

テキストプロンプトからタトゥーのデザインを作成します。

inkstudioai generate "a fox in a crescent moon"
inkstudioai gen "koi fish with waves" --style japanese --color
inkstudioai gen "rose and dagger" --skin --open
inkstudioai gen "minimal mountain range" --out designs/
inkstudioai gen "lotus flower" --out lotus.webp
inkstudioai gen "compass rose" --negative "text, letters" --no-save
inkstudioai gen "lotus flower" --out lotus.webp --force   # replace lotus.webp

オプション	説明
-s, --style <id>	inkstudioai styles のスタイル ID。デフォルト：minimal
-c, --color	カラーインクを使用します。デフォルト：黒インク
--skin	白い背景ではなく、肌の上にデザインを表示します
--negative <text>	デザインに含めないもの
-o, --out <path>	画像のファイルまたはディレクトリ。デフォルト：現在のディレクトリ
--force	--out ファイルが存在する場合、上書きします
--no-save	画像をダウンロードせず、URL のみを表示します
--open	画像の準備ができたら開きます

--out を指定しない場合、またはディレクトリを指定した場合、ファイル名はプロンプトから生成されます。たとえば、a-fox-in-a-crescent-moon.webp のようになります。既存のファイルが上書きされることはありません。CLI は末尾に -2、-3 などを追加します。

--out <file> を指定した場合、--force を追加しない限り、CLI は既存のファイルを上書きしません。拡張子はサーバーが送信する画像形式と常に一致します。画像が WebP の場合、--out lotus.png を指定すると lotus.webp として保存され、その旨が CLI に表示されます。File 行と --json の file フィールドには、実際のファイル名が表示されます。

利用可能な無料デザインがなく、プランにも加入していない場合、generate はエラーとプランを表示します。対話型ターミナルでは、最も安価なプランについて Open checkout for 7-day-access ($12.99)? [Y/n] と尋ね、yes と答えると Stripe のチェックアウトを開きます。--json を指定した場合、CI で実行している場合（CI が設定されている場合）、または stdin がターミナルでない場合は、尋ねません。

サーバーがプロンプトを受け付けた後に接続が切れても、デザインの生成と保存は完了する場合があり、生成回数が消費されることもあります。その場合、CLI は再試行を促しません。まず inkstudioai designs を実行し、デザインがアカウントに保存されているか確認してください。

styles

--style で使用できるスタイル ID の一覧を表示します。

inkstudioai styles

designs

アカウントに保存されたデザインを新しい順に一覧表示します。

inkstudioai designs
inkstudioai designs --limit 50 --page 2

gallery

公開ギャラリーを検索します。ログインは不要です。

inkstudioai gallery
inkstudioai gallery "minimalist wave" --limit 5

whoami（別名：status）

プラン、残り時間、無料デザイン数、プレミアムクレジット数、および今日の API 利用状況を表示します。残り日数が 2 日未満になると、whoami はプランの延長方法を案内します。

inkstudioai whoami

  Account          [email protected] (Ana)
  Plan             Active, 8 days left (ends Nov 1, 10:00 UTC)
  Free designs     0
  Premium credits  28 (8 plan, 20 purchased) for the image tools on the website
  Designs made     14
  API today        3 of 50 generations
  Next design      Paid quality
  API key          isk_AbCdEfGh… (config file)

pricing

プランとクレジットパックを表示します。

inkstudioai pricing

buy

プランまたはクレジットパックの Stripe チェックアウトを開きます。購入内容は、サインイン中のアカウントに追加されます。

inkstudioai buy 7-day-access
inkstudioai buy 7-day-access --no-browser   # only print the checkout link

open

ウェブサイトのページを開きます。

inkstudioai open account
inkstudioai open pricing
inkstudioai open developers

logout

このコンピューターから保存済みのキーを削除します。キーは、アカウントページで無効化するまで、サーバー上で引き続き使用できます。

inkstudioai logout

AI エージェントでの使用（MCP）

inkstudioai mcp は、stdio 経由で Model Context Protocol サーバーを実行します。エージェントは次のツールを利用できます。

ツール	機能
login	チャットからサインインします。ブラウザーで承認するためのリンクとコードを返します
generate_tattoo	プロンプト、スタイル、色、背景からデザインを作成します。画像を返すため、クライアントはチャット内に表示できます
list_styles	スタイル ID の一覧を表示します
get_account	プラン、無料デザイン、クレジット、使用状況を表示します
search_gallery	公開ギャラリーを検索します
get_pricing	プランとクレジットパックの一覧を表示します
create_checkout	ユーザーが開く Stripe のチェックアウトリンクを作成します。これだけで課金されることはありません

サインインする方法は 3 つあります。

• ターミナルは不要です。エージェントにサインインを依頼してください。エージェントは login ツールを呼び出し、リンクとコードを提示します。ブラウザーでコードを承認するか、そこでアカウントを作成してから、エージェントに伝えてください。エージェントが再度 login を呼び出し、API キーをコンピューターに保存します。
• ターミナルで npx inkstudioai login を実行します。MCP サーバーは同じ保存済みキーを使用します。
• アカウントページでキーを作成し、クライアント設定の INKSTUDIO_API_KEY に設定します。このキーは保存済みキーより優先されます。

サーバーは各ツール呼び出し時に保存済みキーを読み込むため、クライアントの実行中にログインしても、再起動は不要です。

generate_tattoo は画像 URL をテキストとして返します。また、画像自体（サイズが 1.5 MB 未満の場合）と、プロトコル 2025-06-18 では画像への resource_link も返します。ダウンロードに失敗した場合、結果にはテキストのみが含まれます。クライアントから progressToken が渡されると、notifications/progress メッセージを送信します。ウェブサイトのページへのリンクには utm_source=mcp が付加されます。サーバーは MCP プロトコルバージョン 2025-06-18 と 2024-11-05 をサポートしています。

Claude Code

claude mcp add inkstudioai --env INKSTUDIO_API_KEY=isk_... -- npx -y inkstudioai mcp

npx inkstudioai login を実行した場合、または login ツールでサインインする場合は、キーを省略できます。

claude mcp add inkstudioai -- npx -y inkstudioai mcp

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "inkstudioai": {
      "command": "npx",
      "args": ["-y", "inkstudioai", "mcp"],
      "env": { "INKSTUDIO_API_KEY": "isk_..." }
    }
  }
}

Cursor（~/.cursor/mcp.json またはプロジェクト内の .cursor/mcp.json）

{
  "mcpServers": {
    "inkstudioai": {
      "command": "npx",
      "args": ["-y", "inkstudioai", "mcp"],
      "env": { "INKSTUDIO_API_KEY": "isk_..." }
    }
  }
}

Windsurf などの MCP クライアントでも、同じコマンド、引数、環境変数を使用します。どのクライアントでも env を省略して、代わりに login ツールでサインインできます。

スクリプトと JSON 出力

任意のコマンドに --json を追加すると、未加工の API レスポンスが標準出力に出力されます。エラーも JSON 形式で、error、code、hints を含み、終了コードは 0 以外になります。コマンドまたはオプションが正しくない場合、"code": "usage" となります。

デザインの準備はできているものの画像ファイルを保存できなかった場合、generate --json は "file": null と saveError メッセージを含む完全な結果を出力し、3 で終了します。デザインはアカウントに保存されているため、再度生成しないでください。

inkstudioai generate "a paper crane" --json | jq -r .imageUrl

終了コード：0 は成功、1 はエラー、2 はコマンドまたはオプションの誤り、3 はデザインを作成したものの画像ファイルを保存できなかったことを示します。

設定

設定	場所
API キー	--api-key、次に INKSTUDIO_API_KEY、それから保存済みのキー
保存済みのキー	$XDG_CONFIG_HOME/inkstudioai/config.json、既定では ~/.config/inkstudioai/config.json、Windows では %APPDATA%\inkstudioai\config.json。読み取れるのは自分のユーザーのみです
API URL	INKSTUDIO_API_URL、既定では https://inkstudioai.com/api/v1
ブラウザーを開かない	INKSTUDIO_NO_BROWSER=1
色を使用しない	NO_COLOR=1 または --no-color

料金

新しいアカウントには無料のデザインが1つ付与され、カードは不要です。プランでは、テキストからタトゥーをデザインする機能が無制限で利用でき（API 経由では1日最大50件）、ウェブサイトの画像ツールで使えるプレミアムクレジットも付与されます。クレジットパックを購入すると、有効なプランにプレミアムクレジットが追加されます。現在の料金は inkstudioai pricing または料金ページで確認できます。

API

CLI は Ink Studio AI の公開 API を使用します。どの言語からでも呼び出せます。

• 開発者向けドキュメント：https://inkstudioai.com/developers
• OpenAPI 仕様：https://inkstudioai.com/api/v1/openapi.json

プライバシー

作成したデザインは、ウェブサイトのデザイン履歴にアカウントの非公開情報として保存されます。CLI はプロンプトとオプションを Ink Studio AI API に送信し、コンピューターには API キーのみを保存します。

サポート

質問や問題については、[email protected] にお問い合わせいただくか、https://github.com/ciroartz/inkstudioai-cli/issues でイシューを作成してください。セキュリティ上の問題は、イシューではなくメールで報告してください（SECURITY.md を参照）。

ライセンス

MIT