开发者

1. 1
   创建 API 密钥

   登录后进入工作台的「API 密钥」页，点创建：选好权限和有效期。密钥只在创建成功那一刻完整显示一次，请立刻复制保存； 之后列表里只显示前缀，复制按钮仍可取回完整值。

2. 2
   填进客户端

   连接类型选 Streamable HTTP，端点填 https://d1vy05ne4p0mlg.cloudfront.net/api/mcp， 请求头写 Authorization，值先写 Bearer， 空一格，再接上你的密钥。填完先看工具列表能不能刷出来 —— 能刷出来就说明认证通过。

3. 3
   按顺序调用

   先 services 看服务目录，再 quote 取报价， 然后在网页上确认这次消费的额度，最后 submit 提交； 用 job 查进度和费用收据。报价不等于授权：真正花钱的那一步必须你本人确认。

4. 4
   客户端传不了文件？走工作台上传

   有些客户端只能发文本、没法把本地图片传上来。这种情况不用换工具： 先去工作台的「我的素材」把图传上去，再回到客户端调 assets 工具 列出素材、拿到编号，把这个编号填进 submit 的 asset_ids 里。 两个入口用的是同一个素材库，上传完立刻能选到。

认证与权限

• ·认证方式：API 密钥（Bearer）。密钥可随时撤销，撤销后调用立即失效； 也能设置有效期，到期自动失效。
• ·权限按需勾选：只读目录、读素材、写报价、提交任务、读任务，各管一段； 不给的权限调不动对应的工具。
• ·消费额度由你本人在网页确认后才生效，密钥本身不能自己决定花钱。
• ·REST、网页、MCP 三个入口共用同一套业务逻辑与计费口径： 同样的输入，结构、费用、归属一致。

当前开放状态

• ·MCP 入口已在生产启用（https://d1vy05ne4p0mlg.cloudfront.net/api/mcp）， 发现用元数据见 /.well-known/oauth-protected-resource/api/mcp。
• ·后台自助创建密钥已可用；两个独立客户端在正式入口上的复验还在进行， 完成前不对外宣称"已支持全部客户端"。
• ·三项服务的真实供应商链路仍在接入中，当前结果用于验证流程与计费，不代表最终出图/文案质量。

错误码与对接支持