接入文档 · LayerKey

开始前

准备一个有权使用 gpt-image-2 的 OpenAI API 账户，或兼容 OpenAI Images API 的中转站。LayerKey 不提供公共 Key 兜底，也不会替你支付模型用量。

1. 保存 API 连接

注册后进入「设置 → OpenAI BYOK」。官方服务使用 https://api.openai.com/v1；中转站填写它提供的完整 Base URL 和密钥。服务端会加密保存 Key，以后界面只显示末四位。

2. 创建 MCP Token

进入「连接器」，为每个 AI 工作台创建一个独立 Token。明文只出现一次，请立即复制。它不是 OpenAI Key，只能访问当前用户的 LayerKey 工具与任务。

3. 选择你的工作台

所有平台都连接同一个地址 https://lk.zulanhongdan.net/api/mcp，差异只在导入格式。保存后应发现 generate_image、create_image_upload、edit_image、get_image_job 与 get_account_status 五个工具。

豆包工作Streamable HTTP表单字段

WorkBuddyHTTP streamingJSON / UI

千问 WorkStreamable HTTPJSON / UI

TRAE WorkRemote HTTP MCPJSON / UI

豆包工作

在「技能 · 连接器 · 伙伴」中添加自定义连接器，选择 Streamable HTTP：

Server URL: https://lk.zulanhongdan.net/api/mcp
Authorization: Bearer [你的 LayerKey MCP Token]
Transport: Streamable HTTP

WorkBuddy

进入 Settings → MCP → Add MCP Server，粘贴下面的 HTTP 配置。WorkBuddy 使用 type: http 表示远程流式 HTTP。查看官方 MCP 文档 →

{
  "mcpServers": {
    "layerkey": {
      "type": "http",
      "url": "https://lk.zulanhongdan.net/api/mcp",
      "headers": {
        "Authorization": "Bearer [你的 LayerKey MCP Token]"
      }
    }
  }
}

千问 Work

进入「扩展 → 连接器 → + 添加 → 粘贴 JSON 配置」。千问 Work 的 JSON 类型值为 streamable-http。查看官方连接器文档 →

{
  "mcpServers": {
    "layerkey": {
      "type": "streamable-http",
      "url": "https://lk.zulanhongdan.net/api/mcp",
      "headers": {
        "Authorization": "Bearer [你的 LayerKey MCP Token]"
      }
    }
  }
}

TRAE Work

进入 MCP Servers 管理，选择手动配置。TRAE Work 会根据 url 自动识别 HTTP MCP。查看官方 MCP 文档 →

{
  "mcpServers": {
    "layerkey": {
      "url": "https://lk.zulanhongdan.net/api/mcp",
      "headers": {
        "Authorization": "Bearer [你的 LayerKey MCP Token]"
      }
    }
  }
}

4. 生成之外，也能编辑

网站工作台切换到「编辑图片」，上传 PNG、JPEG 或 WebP 原图并描述修改要求；需要局部编辑时，可额外上传与原图同尺寸、带 Alpha 通道的 PNG 蒙版。原图只为当前任务暂存，任务结束后清理，编辑结果进入作品库。

在 AI 工作台中，支持附件读取和 HTTP PUT 时，先调用 create_image_upload 取得一次性地址，将 PNG、JPEG 或 WebP 原始文件字节直接 PUT 到该地址，再将 upload_id 作为 edit_image.source_upload_id。原图最大 20MB，地址 15 分钟有效，上传内容不会经过 Base64 膨胀。不支持 PUT 的客户端仍可使用 source_image_base64；编辑 LayerKey 已有作品使用 source_asset_id，公网原图使用 source_image_url。四种来源必须且只能提供一种；可选 mask_image_base64 用于局部编辑。参数行为参照 OpenAI 图片编辑文档 →

1. create_image_upload(filename, mime_type)
2. PUT upload_url（请求体为原始文件字节）
3. edit_image
source_upload_id: "返回的 upload_id"
prompt: "保留主体，把背景改成暮色海边"
quality: high
background: auto

5. 安装通用 Skill

MCP 提供执行能力，Skill 负责调用纪律。把通用 SKILL.md 导入支持 Agent Skills 的客户端，可让所有生成与编辑请求优先使用 LayerKey，并在失败时停止而不是静默回退到内置图片工具。

新建图片 → generate_image
修改图片 → edit_image
取得 job_id → get_image_job
LayerKey 失败 → 返回错误并停止
透明失败 → 禁止白底、抠图或其他模型兜底

透明 PNG 怎么工作

当用户要求透明图片时，LayerKey 会在提示词中明确加入“要求Alpha透明背景生成”，并请求 PNG 输出。调用模型时省略 background 参数，生成和编辑均适用。明确的透明要求会保留为任务的校验条件。

生成后服务端读取 PNG 元数据和像素 Alpha 值。文件必须同时具备 Alpha 通道和实际透明像素，否则不会被当作透明素材交付。首次校验失败会强化提示词重试一次，仍不合格则明确报错。

一个连接，进入你的 AI 工作台。

开始前