Ink Studio AI

inkstudioai

适用于终端和 AI Agent 的 AI 纹身生成器。

新账户可免费设计 1 款纹身，无需银行卡。

inkstudioai 是 Ink Studio AI 的官方命令行工具。用文字描述纹身，即可获得完成的设计图像文件。它也可以作为 MCP 服务运行，因此 Claude、Cursor、Windsurf 和其他 AI Agent 都能为你创作纹身设计。

• 根据文字创作纹身设计，风格包括细线、日式、传统和写实。
• 搜索公开纹身设计图库，获取灵感，无需账户。
• 查看套餐和额度，并通过终端购买套餐。
• 零依赖。Node.js 18.17 或更高版本。

安装

使用 npx 运行一次：

npx inkstudioai login

或全局安装：

npm i -g inkstudioai

此软件包会安装两个命令名称：inkstudioai 和更短的 inkstudio。它们是同一个工具。

快速开始

# 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	为脚本和 Agent 输出原始 JSON
--api-key <key>	使用此密钥，而非 INKSTUDIO_API_KEY 或已保存的密钥
--no-color	关闭颜色。NO_COLOR 也有效
-h, --help	显示帮助
-v, --version	显示版本

登录

使用浏览器登录。终端会显示一个代码并打开页面。确认页面显示相同的代码，然后批准。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 Agent 配合使用（MCP）

inkstudioai mcp 会通过 stdio 运行一个 Model Context Protocol 服务。它会为 Agent 提供以下工具：

工具	功能
login	在聊天中登录：返回一个链接和验证码，以便在浏览器中确认
generate_tattoo	根据提示词、风格、颜色和背景创建设计。返回图像，以便客户端在聊天中显示
list_styles	列出风格 ID
get_account	显示套餐、免费设计、积分和使用情况
search_gallery	搜索公开图库
get_pricing	列出套餐和积分包
create_checkout	创建 Stripe 结账链接，供用户打开。此操作本身不会收费

有三种登录方式：

• 无需终端：让 Agent 帮你登录。它会调用 login 工具并提供链接和验证码。在浏览器中确认验证码（或在那里创建账号），然后告知 Agent。它会再次调用 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，即可在 stdout 上获取原始 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

定价

每个新账户都可免费创作一个设计，无需提供银行卡。订阅方案可无限创作文本转纹身设计（通过 API 每天最多 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