在 Agent.Space 自带 API Key，指的是把你已经付费使用的模型供应商接入共享 Workspace。由工作区所有者保存连接，Agent.Space 检测所选模型；具备运行 Agent 权限的成员，就能选用兼容模型，不必拿到所有者的密钥。
需要分清的是：API 连接成功，不等于模型能完成 Agent 的工具调用循环。 有的接口能回答文字问题，却会拒绝工具执行后的下一轮请求。先用一个模型完成一个小任务，再扩大团队使用范围。
本文按 2026 年 10 月 12 日核对的信息，说明 Workspace 自有模型的连接方式。功能随产品版本发布，开始前先查看工作区设置中是否有“自有模型”入口。本文不假定每类电脑都支持同一路径，也不代表已用你的供应商账号完成实测。
自带 API 与 Developer API 的接入方向相反
BYOK 是 Bring Your Own Key 的缩写，也就是自带密钥。在这里，你把供应商 API 接入 Agent.Space Workspace，模型用量由供应商计费。
Agent.Space Developer API则是反方向：创建 Agent.Space 的 Key，让外部客户端或后端应用使用 Agent.Space 提供的模型。它的 Endpoint 示例，不是把自己供应商接进 Workspace 的配置说明。
两种路径都不会把 ChatGPT 或 Claude 的订阅登录自动变成 API Key。连接公司账号前，先确认账号负责人允许这种用途，并知道哪个 Workspace 会使用它的预算。
准备所有者账号、接口地址和小范围测试
连接由 Workspace 所有者管理。共享模型不会给只读成员额外开放运行 Agent 的权限，工作区原有角色规则仍然适用。
开始前准备以下内容：
- 供应商文档中的 API 地址，以及有权访问目标模型的 Key。
- 一两个准备测试的准确 Model ID，不必一开始接入整个模型目录。
- 供应商支持的话，预先设置用量预算或提醒。
- 一个不含敏感资料的示例项目，用于首次工具调用。
预设地址与账号实际 Endpoint 匹配时，优先选对应的供应商预设。自定义接口目前要求云端可以访问的公网 HTTPS 地址。只在 localhost 或公司内网能访问的服务，不会因为在你电脑上能打开，就自动变得能被云端访问。
连接会检查 Responses 和 Messages，也就是编程 Agent 使用的两种 API 格式。只提供 Chat Completions 的服务，不会自动兼容。同样，供应商标注“OpenAI 兼容”，也不能证明它支持目标 Agent 发出的全部请求。
Key 只填进连接表单，不要放进 Prompt、项目文件、截图或求助消息。条件允许时，为这个集成单独创建 Key，并提前安排轮换方式。
接入、检测模型，再实际选用
- 由所有者打开 Workspace 设置 → 自有模型，添加供应商。
- 选择匹配的预设，或填写自定义地址，然后输入 Key。
- 从发现结果中选择少量模型。如果供应商没有返回可用的模型列表，可使用界面的手动 Model ID 输入，按供应商提供的准确 ID 填写。
- 运行兼容性检测，逐个查看模型结果和适用的 Agent。供应商保存成功，不代表选中的每个模型都通过了检测。
- 如果云端电脑已经运行，先保存工作并与其他成员协调，再按提示重启。不要在团队任务进行中直接重启。
- 重新打开对话里的模型菜单。自有模型按供应商分组显示在靠前位置，选择适配当前 Agent 的模型。
检测会带上已有对话，要求流式调用工具，再携带工具结果继续下一轮请求，同时确认输出流正常结束。它比只问一句“你好”更接近 Agent 的实际工作，但不代表全部工具、附件类型、供应商扩展和长对话都通过验收。
检测本身会向供应商发送请求。应把它当成可能产生费用的调用，而不是离线检查。
检测通过，但 Codex 里看不到模型怎么办
Codex 不只需要一个能识别的模型名称。它的请求使用 Responses 和推理相关字段，因此某个模型能配合其他 Agent 使用，不代表也能配合 Codex。
接入检测除了工具循环，还会检查推理兼容性。对于平台模型目录中没有的型号，通过推理检测可以补充 Codex 所需的能力信息；仅仅出现在供应商模型列表中并不够。
先查看该模型的 Agent 兼容性结果，以及菜单中供应商下面的提示。如果连接是在兼容性改进前保存的，可以编辑连接并重新检测，再按提示重启、重新打开菜单。
不要通过改名，把不兼容模型伪装成支持的型号。应选择兼容的模型与 Agent 组合，或向供应商确认具体被拒绝的请求格式。保留时间、Model ID、协议和脱敏报错，不提供 Key。
分清模型费用、其他活动与密钥权限
通过 Workspace 自有模型连接发出的调用，会进入所有者的供应商账号；这些模型调用不消耗 Agent.Space 套餐额度或积分，但供应商仍可能向所有者收费。“Agent.Space 不收这次模型调用费”，不代表推理免费、供应商容量无限，也不代表 Workspace 的所有活动都走同一条计费路径。
例如，给 Agent 任务选了自有模型，并不能据此判断其他自动任务如何计费。应分别核对其他产品费用和供应商的用量记录，不要直接推导出总账单为零。
保存的 Key 会加密，成员不能通过正常的 Workspace 界面取得密钥全文。不过，Agent.Space 仍需要保存并使用凭据，才能完成连接。这不等于密钥或项目数据完全不经过平台基础设施。
有权限运行 Agent 的成员，即使看不到 Key，也可能产生供应商用量。条件允许时，为该用途单独创建 Key、检查成员权限，并在供应商侧设置限制。如果 Key 在其他地方泄露，应先去供应商处撤销或轮换，再更新 Workspace 连接。
团队全面使用前，先验收一个小任务
第一次验收可以收窄到以下范围：
- 在示例项目里选择目标 Agent 和自有模型。
- 请它读取一个不含敏感信息的文件并总结，不修改文件。
- 确认确实执行了工具，并在工具返回后继续生成有效回答。
- 供应商提供相应用量记录时，核对时间和模型。
- 让具备运行权限的同事确认同一兼容模型可以选择，但不要把 Key 本身发给对方。
这只能验证一个具体连接和工作流，不能证明长任务、所有模型或另一类电脑都同样可用。如果工具调用成功、后续回答失败，应保存供应商响应，先理解兼容性问题，再继续尝试，不要反复自动重试。
准备把已有供应商账号用于共享项目时，可以打开 Agent.Space，先检查目标 Workspace 的“自有模型”入口，从一把获准使用的 Key 和一个兼容模型开始。扩大使用范围时，继续留意供应商账单和项目访问权限。