跳到主要内容

AI 纹身生成器API、CLI 和 MCP 服务器

在终端、脚本或 AI 智能体中创建纹身设计。一个 npm 包即可提供命令行工具和适用于 Claude 与 Cursor 的 MCP 服务器。两者都使用你的 Ink Studio AI 账户的 REST API，你也可以直接调用该 API。

在终端中登录

npx inkstudioai login
创建免费账户获取 API 密钥

新账户可获得一次免费设计。注册无需银行卡。

文档

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 或更高版本。无需安装其他软件。

  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 密钥。

此包会安装两个功能相同的命令：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 付款链接。

限制：每个密钥每分钟 60 次请求，每个账户每个 UTC 日 50 次设计。生成失败不计费。

CORS：不支持。网页无法在浏览器中直接调用 API。请在服务器、CLI 或 MCP 服务器中使用 API。

请求

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 在你的电脑上运行，并使用登录命令保存的密钥。没有终端？让你的智能体帮你登录：它的登录工具会给你一个链接和一个代码。

你的智能体可以做什么

  • 根据描述创建纹身设计并显示图片。
  • 选择适合创意的风格。
  • 在公开图库中搜索参考图。
  • 查看你的套餐、积分和每日限额。
  • 在你需要更多权限时提供付款链接。
shell
claude mcp add inkstudioai -- npx -y inkstudioai mcp

请先用登录命令登录。或者在配置的 env 块中将密钥设置为INKSTUDIO_API_KEY

价格

API 使用你的网站套餐。套餐可在网站上无限次生成设计，并且每天最多可通过 API 生成 50 个设计。

免费账户

US$0.00

注册即送一次免费设计。图库搜索和风格列表始终免费。

访问套餐

  • 7 天访问

    包含 10 个高级积分

    US$12.99

  • 14 天访问

    包含 20 个高级积分

    US$16.99

  • 30 天访问

    包含 30 个高级积分

    US$23.99

网站上无限次设计，每天最多 50 个 API 设计。

积分包

  • 20 积分US$9.99
  • 50 积分US$19.99
  • 120 积分US$39.99

用于网站图像工具的高级积分。购买积分包需要有效套餐。

比较所有套餐

在终端中购买：inkstudioai buy 7-day-access

常见问题

关于此工具的常见问题和如何使用结果的清晰答案。

从一次免费设计开始

创建账户，在终端中登录，一分钟内生成你的第一个纹身设计。
创建免费账户获取 API 密钥

相关指南与工具

  1. 免费的 AI 纹身生成器，用于自定义设计输入文字，用 AI 创建纹身设计。新账户可免费生成一次。选择风格并下载概念图。需要登录，首次生成无需银行卡。
  2. 探索纹身风格发现并比较传统、新传统、水彩、写实及其他纹身风格。
  3. 探索AI纹身设计浏览最新的AI生成纹身概念，打开任意设计以查看其本地化设计细节。
  4. 定价比较一次性实惠的AI纹身生成访问计划和高级纹身设计工具。