怎么通过API完成AgentSpace模型接入

通过 Agent.Space Developer API 接入模型，能让你的程序直接调用平台提供的智能能力。这种方式的直接好处是灵活可控，你可以精确指定模型、监控消耗并集成到自有工作流中。注意，这适用于让外部程序调用 Agent.Space 的模型；若目的是将其他供应商模型接进共享工作区，应使用工作区的“自有模型”连接功能，两者不可混用。

在侧边栏【更多】中选择【Model API Key】创建新的 API 密钥

1. 打开 API 页面并准备独立 Key

在 Agent.Space 界面侧边栏选择【更多】中的【Model API Key】，进入 Developer API 页面。首先确认账号具备外部 API 使用资格，且目标模型有足够的套餐额度或积分。接入资格与资金充足是两个独立的检查项，缺一不可。

创建一个便于识别用途的 Key，例如命名为 api-check。设置时注意查看模型限制、过期日期和花费上限。Key 的名称仅用于辅助识别，真正参与认证的是完整的密钥值。严禁将真实密钥写入示例脚本、公开项目仓库或浏览器前端代码中。

2. 在 PowerShell 中输入凭据

打开 Windows 上的 PowerShell 7.1 或更新版本。以下步骤需在同一个窗口中依次运行，以保持变量上下文。请勿在旧版 Windows PowerShell 5.1 中使用带有 MaskInput 的命令，该参数从 PowerShell 7.1 开始提供。

$agentSpaceKey = Read-Host "输入本次检查使用的 API Key" -MaskInput
if ([string]::IsNullOrWhiteSpace($agentSpaceKey)) {
    throw "未输入 API Key，停止请求。"
}
$agentSpaceHeaders = @{ Authorization = "Bearer $agentSpaceKey" }

输入时屏幕会显示星号以遮挡密钥，但密钥仍以字符串形式保存在当前进程内存中。遮挡输入不等于长期加密存储，因此不要输出这两个变量，也不要将包含凭据的调试信息发送给他人。

2. 在 PowerShell 中输入凭据

3. 查询当前 Key 可用的模型

继续执行模型发现请求，获取当前 Key 有权访问的模型列表：

$agentSpaceCatalog = Invoke-RestMethod -Method Get -Uri "https://api.agent.space/v1/models" -Headers $agentSpaceHeaders -ErrorAction Stop
$agentSpaceCatalog | ConvertTo-Json -Depth 20

执行 Invoke-RestMethod 后返回的模型列表 JSON 数据

仔细查看返回结果中准确的模型 id，并确认目标条目的 endpoints 包含下一步将使用的 /v1/responses。不要直接从旧教程复制看似相似的型号 ID。发现请求成功仅表示取得了当前可用目录，并不代表生成任务一定能成功。

将选中的完整模型 ID 复制并输入到变量中：

$agentSpaceModel = Read-Host "粘贴目录返回的准确模型 ID"

如果在此步骤收到 401 或 403 错误，请先检查实际 Key 是否完整、是否已被撤销以及所属账号权限。在拿到模型目录之前，先解决认证问题，不要继续发送生成请求。

4. 用同一模型发送小型文本请求

沿用刚才的凭据和模型 ID，发送一句简单的测试指令：

$agentSpaceBody = @{
    model = $agentSpaceModel
    input = "Reply with: connection ok."
} | ConvertTo-Json
$agentSpaceRequest = @{
    Method = "Post"
    Uri = "https://api.agent.space/v1/responses"
    Headers = $agentSpaceHeaders
    ContentType = "application/json; charset=utf-8"
    Body = $agentSpaceBody
    ErrorAction = "Stop"
}
$agentSpaceReply = Invoke-RestMethod @agentSpaceRequest
$agentSpaceReply | ConvertTo-Json -Depth 20

发送测试指令后收到的模型响应内容

这段命令会发出真实的模型调用，可能消耗额度或积分。查看响应中的实际状态与输出内容，确认它返回了可用的回答（如 "connection ok."）。不要将刚才发送的 input 内容误认为是模型回复，也不要仅因没有弹出错误提示就判断流程全部通过。

5. 回到请求记录核对同一次调用

返回 Developer API 页面的【Request history】区域。先按之前创建的 api-check Key 进行筛选，再根据需要按模型或协议缩小范围。

对照刚才的操作时间、模型 ID、协议类型与请求标识，确认请求已到达服务器并按预期结束，同时检查资金来源是否正确。如果记录处于待处理或需要核对状态，请保留现场，不要将其视为最终扣费完成。成功且显示在套餐内仍会消耗额度，这不代表后续可以无限调用。若没有找到对应记录，需回查实际的 Endpoint 地址、网络连接及认证配置。

6. 保留脚本与脱敏的接入记录

将不含密钥的命令保存为本地 PowerShell 脚本，另外记录模型 ID、检查时间、请求 ID、实际结果和资金来源。测试结束后关闭该 PowerShell 窗口以结束会话；若是长期服务，请使用获准的密钥管理方式加载凭据。

只有当模型发现、实际输出和后台请求记录能够互相对应时，才算是完成了这次小范围的接入验证。后续若需接入工具调用、附件处理或长任务，还需分别验证相应能力，不能用一次简单的文本回复代替整套应用验收。

6. 保留脚本与脱敏的接入记录