接入指南

在 AI 工具里直接用 Shopix

你可以在 Claude Code、Codex、Cursor 和其他 MCP 客户端里直接调用 Shopix,生成商品主图和详情图。不需要先打开网页工作台,对 AI 说人话就行。

打开 Shopix,生成接入密钥

三步接入

  1. 01

    生成接入密钥

    登录 Shopix,点工作台右上角的终端图标,生成一把接入密钥。完整密钥只会显示一次,请立刻复制。

  2. 02

    跑一行命令

    把对应工具的接入片段贴进去。Claude Code 是一条终端命令,Codex 写进配置文件,Cursor 写进 MCP 配置。

  3. 03

    对 AI 说人话

    例如:「用这张商品图出 4 张亚马逊主图」。平台、张数、档位没说全也没关系,会按默认值走。

各工具怎么接

Claude Code

在终端执行下面这一行,然后直接让 Claude 帮你出 Shopix 主图或详情图。

claude mcp add --transport http shopix https://shopix-ai.company/api/mcp --header "Authorization: Bearer <YOUR_KEY>"

Codex

把这段写进 ~/.codex/config.toml。Codex 桌面版和命令行都可以用。

# Codex 桌面 / CLI 通用
[mcp_servers.shopix]
url = "https://shopix-ai.company/api/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_KEY>" }

Cursor

把这段合并进 Cursor 的 MCP 配置,保存后即可在对话里调用 Shopix。

{
  "mcpServers": {
    "shopix": {
      "url": "https://shopix-ai.company/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

其他 MCP 客户端

只要客户端支持 HTTP MCP,就可以用同一套地址和密钥:站点 /api/mcp,请求头 Authorization: Bearer 你的密钥。

默认值

项目默认
平台通用,除非你在对话里点名某个平台
张数主图默认 4 张
档位实用版,和网页端同一档
从对话识别AI 会从你的话里识别平台、张数和档位

积分和计费

出图按网页端同一套积分规则扣费,真正开始生成时才扣。任务失败或超时,会按现有规则退回未用掉的积分。生成密钥本身不扣积分。

常见问题

完整密钥只显示一次,丢了怎么办?

重新生成一把即可。旧密钥会立刻失效,记得把 AI 工具里的配置换成新的。

企业子账号能用吗?

不能。请用主账号登录后再生成密钥。

会额外扣积分吗?

密钥本身不收费。真正出图时,积分和网页端一样。积分不够时会提示去充值。

没说平台、张数或档位会怎样?

按默认值走:平台按通用、主图默认 4 张、档位按实用版。你如果在话里提到了,AI 会按你说的来。

只支持这三个工具吗?

Claude Code、Codex、Cursor 是我们写好步骤的三个。其他支持 MCP 的客户端也可以用同一套地址和密钥。