平台与工作流工具
用介面组装 AI、不自己写程式的工具——应用建构平台、工作流自动化——接 Gateway 的方式跟 SDK 一样。把工具里的 OpenAI 相容供应商指向 Gateway,这个项目(project)允许的模型就全部在里面可用,共用一把密钥、一张账单。
任何文件网址加上 .md 就能读到纯文字版:https://atptoken.ai/docs/platforms.md。想把整页喂给 AI 助理时很好用。
开始之前#
三个值,到哪里都一样:
- Base URL——填
https://api.atptoken.ai/v1。要含/v1,但不要接/chat/completions。 - API 密钥——那把
atp-…开头的项目密钥。 - Model——
GET /v1/models回传的其中一个 id。
工具之间的差别,在于它能不能自己去读你的模型清单:
如果你要接的是 coding agent——Claude Code、Codex、Cline 那一类——请看 Coding agents。
接上 Dify#
从 marketplace 安装 OpenAI-API-compatible 这个 model 供应商,然后在它的卡片上按 Add Model。要填的栏位:
多数卡关来自两个默认值。Model context size 默认只有 4096,超过就被静默截断,所以每个模型都要照实填。还有 Function Call Type 默认是 no_call,代表 Dify 根本不会送出 tools 阵列——建在这个模型上的 agent 会安静地不呼叫任何工具,直到你改掉它。
Dify 不会去读 GET /v1/models,每个模型都要独立 Add Model 一次。先打那支端点,照它回传的清单一个个加。
Dify Cloud 与自架版的设定方式相同。
接上 n8n#
n8n 用它内建的 OpenAI credential。建一组,在 Add option 里把 Base URL 设成 https://api.atptoken.ai/v1,API 密钥 贴上 atp-… 密钥。
之后模型下拉选单就会通过这个 base URL 去读 GET /v1/models,你项目的模型会自己出现,不用手动列。
使用时,在 AI Agent 或 Basic LLM Chain 节点底下挂一个 OpenAI Chat Model 子节点,选这组 credential。
OpenAI 节点自己的 Message a model 动作,配自订 Base URL 时有一个尚未修复的问题:credential 测试会过,但实际执行回 404。走 AI Agent 加 OpenAI Chat Model 子节点才是可行的路。
还有两点。Base URL 栏位在 credential 上,不在节点上——它在后来的版本被从节点隐藏了,所以会给人「找不到这个栏位」的感觉。另外 n8n 官方文件没有列出这个栏位,它只存在于 credential 介面的 Add option 里。
n8n Cloud 与自架版的行为相同。
疑难排解#
403——模型没有在这把密钥所属的项目启用。到控制台的「资源」替该项目开启。404——/v1位置放错,或工具在已经以/chat/completions结尾的网址后面又接了一次。- 模型选单是空的——Dify 本来就不会替你列模型,要一个个加。n8n 如果是空的,通常代表密钥或 base URL 有误,因为那个下拉是由
GET /v1/models填的。 - 工具都没有被呼叫——Dify 那边的
Function Call Type还停在no_call。