确认负责人
指定一名工作区或项目负责人，负责批准模型、检视用量，并在请求被拦截时作出响应。
集成
连接团队已在使用的工具。
将兼容客户端和 API 工作流一次性指向 New API。保留熟悉的工具，同时由组织掌控模型访问、用量与支出。
接入之前
先准备好访问路径。
可靠的集成始于明确的负责人、已批准的模型，以及一个无需改动应用代码即可撤销的密钥。
批准模型
查阅模型目录，确认其能力、上下文与供应商路由契合预期的工作流。
设置配额
在接入共享的编辑器、智能体或服务之前，为密钥或团队设定明确的用量边界。
兼容客户端
一条托管路径，服务日常 AI 工作。
从契合工作流的编辑器、终端或兼容 API 客户端中使用 New API。
VS Code
基于编辑器的 AI 工作流
Codex
智能体与终端工作流
Claude Code
兼容 Anthropic 的工作流
Trae
AI 优先的编辑器工作流
Zcode
编码助手工作流
兼容客户端
OpenAI 兼容配置
谨慎配置
让凭证与请求行为保持可预测。
该集成应便于开发者测试，也便于管理员审核。
使用服务端密钥
将 New API API 密钥存放在环境变量或密钥管理器中。切勿将其放入浏览器代码、代码仓库或请求日志。
匹配请求格式
选择与模型族匹配的端点，并在请求体中保留模型标识符与必需字段。
测试一个小请求
从一个具有代表性的低流量请求开始。在上线前确认响应、用量记录、配额行为与错误处理。
智能体编排
让智能体通过一条受控路径调用工具。
智能体可以规划任务、检索上下文并调用已批准的模型，而 New API 让凭证、模型访问与请求轨迹始终处于同一套运营管控之下。
任务请求
智能体
检索上下文
模型调用
已审核的结果
清晰的集成路径
从配置到受控的输出。
- 01
选择已批准的模型
选择组织已开放给你的模型与能力。
- 02
设置兼容端点
用 New API 端点和托管 API 密钥配置客户端。
- 03
结合上下文检视用量
在扩展访问之前，利用请求记录、配额与用量数据。
集成常见问题
上线前的实用解答。
用这些解答来规划首次接入。对于端点字段与供应商特定行为，API 参考文档始终是权威依据。
我们应该从哪里开始？
先从一个有归属的工作流、一个已批准的模型和一个测试密钥开始。在非生产环境中接入，验证响应与用量记录，然后再谨慎扩展。
如何选择 base URL 和端点？
使用为你工作区提供的 New API base URL，并为对应的模型族选择兼容端点。API 参考文档列出了当前的路径、必需的请求头与请求字段。
API 密钥应该存放在哪里？
将其保存在服务端或客户端工具的密钥库中，尽量通过环境变量传入。不要在前端打包产物、源代码仓库、截图或日志中暴露它。
OpenAI、Anthropic 与 Gemini 的格式可以互换吗？
并非对每个模型都可互换。New API 在适用处支持兼容格式，包括 Chat Completions、Responses、Anthropic Messages 与 Gemini GenerateContent。切换格式前请查阅模型与端点文档。
如何知道有哪些可用模型？
把模型目录与你的工作区权限结合使用。某个模型可能出现在目录中，但仍需管理员为你的团队或密钥授权。
遇到 401、403、404 或 429 错误时该怎么办？
401 检查密钥与请求头，403 检查权限或模型访问，404 检查路径与模型兼容性，429 检查配额或速率限制。保留请求 ID；若故障持续，请查阅 API 参考文档或通过支持渠道反馈。
生产中应如何处理限制？
上线前设置配额，对瞬时响应采用带退避的有界重试，并监控用量与错误率。不要盲目重试认证或权限失败。
何时应该查阅 API 参考文档？
当你需要确切的端点路径、请求头、请求 schema、流式行为、媒体字段或供应商特定约束时，就查阅它。本页说明集成工作流；参考文档定义契约。