Agent.Space Developer API 接入教程

Agent.Space Developer API 可以把受支持的本地 Agent 或自建服务接到 Agent.Space 账户可用的模型上。先创建独立 Key，选好兼容的模型与客户端配置，再到 Request history（请求记录）核对一个小请求，最后才扩大用量。只是连接已有的 Codex、Claude Code 或 OpenCode 客户端，不需要先写一套 SDK 集成。如果目标是把多个 Provider Key 收敛到一个 Endpoint，应在切换生产流量前先参考一个 API Key 访问多个 AI 模型的迁移指南。

不要从旧文章里复制 Model ID，也不要把真实 Key 放进浏览器代码。实时 /v1/models 响应才是模型 ID 与可调用端点的事实来源；Developer API 页面则是当前产品入口。

信息核验日期：2026 年 10 月 10 日。 本次更新核对了 Agent.Space 公开 API 页面，以及当前客户端模板、模型发现和请求记录的实现。没有进行带身份认证的生产调用，也没有实测客户结果。模型、协议与资金规则可能变化，使用配置前请检查实时接入面板。

Developer API 能做什么

它是面向服务端集成的模型访问层，目前的接入形式包括：

• OpenAI Responses 与 OpenAI Chat Completions：使用 OpenAI 兼容的服务端 SDK 配置。
• Anthropic Messages：使用 Anthropic 兼容的服务端 SDK 配置。

发现结果里的每个文本模型都能通过这三种形式调用：模型的原生协议直接处理，其他形式由 Agent.Space 转换。这些仍只是连接形式，不代表所有 Provider 功能都完全相同；还要确认模型支持客户端需要的能力。

要区分套餐额度和积分。Agent.Space 当前 API 介绍说明，套餐覆盖的模型使用套餐额度，其他可用模型通过积分按量使用。所选模型的具体扣费与续用规则应以产品当下显示为准：模型名称正确、连接成功，都不能证明请求一定不会超出套餐额度。Agent.Space 积分也不是 OpenAI 或 Anthropic 的 API 余额。

先选择本地 Agent 接入，还是服务端 SDK

接入本地客户端时，应在实时指南中选择它对应的标签。Codex、Claude Code 与 OpenCode 的配置不能互换。应用生成的配置前，备份原配置并保留无关设置；包含完整 Key 的配置文件绝不能提交到仓库。

API 连接提供模型访问，不会自行上传你的代码库，也不会自动创建共享项目。下文继续介绍服务端集成，以及两条路径都需要的请求核对方法。

接入前准备四项内容

1. 符合外部 API 接入资格，并有对应套餐额度或积分的 Agent.Space 账户。以实时面板为准，不要假设注册赠送的积分就足够。
2. 为当前集成或环境单独创建的 API Key。
3. 生产 Endpoint：https://api.agent.space。
4. 实时模型发现接口返回的 Model ID。

如果独立轮换能够降低中断风险，本地开发、生产与自动化应分别使用 Key。Key 的名称只用于识别；真正授权消费的是 Secret Value。

第一步：创建并保护 API Key

打开 Developer API 面板，创建一个能说明用途的 Key，例如 Production backend，再把完整值保存到目标 Secret Store。

遵守基本凭据规则：

• Key 只放在服务端环境变量或获批的 Secret Manager 中；
• 不要把它提交到仓库，也不要粘贴到截图、Issue、浏览器 Bundle 或 Prompt；
• 不同环境需要单独撤销时，就分别创建 Key；
• 一旦怀疑泄露，立即轮换或撤销。

本地 Shell 可以使用这样的占位值：

export AGENT_SPACE_API_KEY="<paste-full-api-key>"

这里使用的是占位值，不是在建议把真实 Key 粘贴到会保存的 Shell 历史中。真实凭据应通过 Secret Manager 或受保护的本地方式加载，也不要出现在诊断输出里。

第二步：发现当前可用模型

先查询当前 Key 能访问哪些模型：

curl "https://api.agent.space/v1/models" \  -H "Authorization: Bearer $AGENT_SPACE_API_KEY"

使用响应中准确的 id。它的 endpoints 列表说明可以从哪些路径调用：文本模型都会列出 /v1/chat/completions、/v1/responses 和 /v1/messages。protocols 字段标的是模型的原生协议，从其他端点发来的请求会被转换。

export AGENT_SPACE_MODEL="<model-id>"

主动更换模型时，或者原本有效的 ID 消失时，重新执行发现。Blog 中写死的模型清单会过期，实时返回不会。

第三步：按客户端原生协议接入

应该使用客户端期待的 Base URL，而不是把两种 SDK 配置当成可以互换。

OpenAI Responses 示例

先在服务端项目中安装 openai，并设置上述两个环境变量。这个示例只发送一条最小文本提示，不会发送代码库文件。

import OpenAI from "openai"
const client = new OpenAI({  apiKey: process.env.AGENT_SPACE_API_KEY,  baseURL: "https://api.agent.space/v1",  maxRetries: 0,})
const response = await client.responses.create({  model: process.env.AGENT_SPACE_MODEL,  input: "Reply with: connection ok.",})
console.log(response.output_text)

Anthropic Messages 示例

安装 @anthropic-ai/sdk。上一个示例的模型在这里同样可用：任何文本模型都能通过 Messages 调用，模型原生协议不同时由 Agent.Space 转换请求。

import Anthropic from "@anthropic-ai/sdk"
const client = new Anthropic({  apiKey: process.env.AGENT_SPACE_API_KEY,  baseURL: "https://api.agent.space",  maxRetries: 0,})
const message = await client.messages.create({  model: process.env.AGENT_SPACE_MODEL,  max_tokens: 1024,  messages: [{ role: "user", content: "Reply with: connection ok." }],})
console.log(message.content)

这些示例只记录配置形式，不是性能测试、客户结果，也不证明不同模型的功能完全等价。

第四步：正式流量前先验证一个小请求

第一次请求完成后，在 Request history 中确认：

• 实际使用的是预期 Key；
• Model ID 与协议和配置一致；
• 请求已经到达 Agent.Space，并按预期结束；
• 记录中的资金来源符合你的选择。

可以用下面这份验收表，避免把连接成功误当成整个集成已经完成：

先按 Key 筛选请求记录，再按模型或协议缩小范围。寻求帮助时保留请求 ID、时间和错误码，但不要提供密钥。“待处理”或“需要核对”的记录，不是已确认的最终扣费；成功且显示套餐内的请求仍然消耗额度，也不代表 API 可以无限免费使用。

评估成本时，应计算一个已验收任务中的所有 Call，而不是只看这次小请求。Coding Agent API 成本计算指南解释了怎样分别处理未缓存输入、Cache、输出、工具与重试，同时避免捏造通用任务价格。

本文没有拿读者的 Key 发送生产请求。示例按 Agent.Space 当前展示的接入形式编写；你自己的小型请求与 Request history，才是所选 Key、模型、协议和资金路径对该账号真实可用的证据。

升级自己的应用时，可以使用 Opus 5.5 API 迁移测试方案，检查响应内容块、工具循环和安全重试。

按固定顺序轮换、撤销和排错

轮换会让旧 Secret 失效，因此应把依赖服务更新纳入同一次切换。集成下线或 Key 可能泄露时可以撤销。重命名只改善管理，不会改变 Secret。

请求失败时，一次检查一层：

1. 当前服务端进程是否拿到了完整且有效的 Key？
2. /v1/models 是否仍返回配置中的 Model ID？
3. 该模型的 endpoints 列表是否包含客户端调用的路径？
4. 当前 SDK 形式对应的 Base URL 是否正确？
5. 所选模型需要的资金路径是否可用？
6. Request history 是否显示请求到达 Agent.Space？

这个顺序能把认证、模型可用性、端点兼容性、路由和资金问题拆开。一次修改全部变量，只会让故障更难定位。

排错时要把 HTTP 响应与 Request history 放在一起看，不能只凭一个现象猜原因：

HTTP Status 只是线索，不是完整诊断。如果响应带有错误正文或 Request ID，应一并保留；但绝不能把 API Key 本身写进日志、截图或支持消息。

接通后仍出现请求失败或卡顿时，应区分 API 限流与有限重试，以及模型、客户端和工具各自的延迟。凭证变更另行处理：API Key 安全清单说明了轮换与泄露处置。

从一个可验证的小集成开始

安全的第一个集成应该很窄：一个用途明确的 Key、一个从实时发现结果选出的模型、一种客户端原生协议，以及一个小型验证请求。只有 Request history 与预期配置一致后，再逐步扩大使用。

先查看 Agent.Space 当前套餐与模型价格，再注册 Agent.Space 账户。账户具备所需资金路径后，回到 Developer API 页面创建集成 Key。