连接团队已经在使用的工具。

先准备清晰的访问路径。

可靠的集成需要明确负责人、已批准的模型，以及可以随时撤销而不必修改应用代码的密钥。

• 确认负责人. 指定工作台或项目负责人，负责批准模型、查看用量，并处理被阻止的请求。
• 批准模型. 查看模型目录，确认模型能力、上下文和供应商路径符合工作流需要。
• 设置配额. 在连接共享编辑器、Agent 或服务前，为密钥或团队设置明确的用量边界。

为日常 AI 工作提供统一管理路径。

从编辑器、终端或兼容 API 客户端使用 TokenDate，让不同工具共享同一套访问边界。

• VS Code. 编辑器内 AI 工作流
• Codex. Agent 与终端工作流
• Claude Code. Anthropic 兼容工作流
• Trae. AI 原生编辑器工作流
• Zcode. 编程助手工作流
• 兼容客户端. OpenAI 兼容配置

让凭证和请求行为保持可控。

开发者应能轻松测试，管理员也应能清楚复核集成状态。

• 使用服务端密钥. 将 TokenDate API 密钥放在环境变量或密钥管理器中，不要放入浏览器代码、代码仓库或请求日志。
• 匹配请求格式. 根据模型系列选择兼容端点，并在请求体中保持模型标识和必需字段正确。
• 先测试小请求. 从低流量的代表性请求开始，确认响应、用量记录、配额行为和错误处理后再发布。

从配置连接到受控输出。

1. 选择已批准的模型. 根据工作流选择组织已经开放的模型和能力。
2. 设置兼容端点. 使用 TokenDate 端点和托管 API 密钥配置客户端。
3. 查看用量上下文. 通过请求记录、配额和用量数据了解工作流，再扩大访问范围。

应该从哪里开始？

从一个有负责人、一个已批准模型和一个测试密钥开始。在非生产环境验证响应与用量记录，再逐步扩大范围。

如何选择 Base URL 和端点？

使用工作台提供的 TokenDate Base URL，并根据模型系列选择兼容端点。当前路径、请求头和字段请查看 API Reference。

API 密钥应该放在哪里？

放在服务端或客户端工具的密钥存储中，尽量通过环境变量注入。不要暴露在前端构建产物、源码、截图或日志中。

OpenAI、Anthropic 和 Gemini 格式可以互换吗？

并非所有模型都可以互换。TokenDate 会在适用场景支持 Chat Completions、Responses、Anthropic Messages 和 Gemini GenerateContent，请先确认模型和端点文档。

如何确认哪些模型可用？

同时查看模型目录和工作台权限。模型出现在目录中，并不代表它已经被管理员授权给你的团队或密钥。

遇到 401、403、404 或 429 怎么办？

401 检查密钥和请求头，403 检查权限或模型访问，404 检查路径与模型兼容性，429 检查配额或速率限制。持续失败时保留请求 ID 并查看 API Reference 或联系支持。

生产环境如何处理限制？

上线前设置配额，对临时错误使用带退避的有限重试，并监控用量和错误率。不要盲目重试认证或权限错误。

什么时候应该查看 API Reference？

需要精确端点路径、请求头、请求结构、流式行为、媒体字段或供应商限制时查看它。本页说明接入流程，Reference 定义具体契约。