Token4AI CloudOpenAI 兼容 API 接入：Base URL、模型与 Key
通过 Token Cloud 工作流连接模型 API 并管理 Token 用量，可以从兼容 OpenAI 的客户端开始。将 API Base URL 设置为 https://api.token4ai.cloud/v1，使用 Token4AI API Key，并选择该密钥有权访问的模型 ID。先完成一次小请求，再到控制台核对结果。
作者：Token4AI Cloud 产品团队
接入前的准备
- 登录 Token4AI 控制台，检查账户余额与当前模型访问权限。
- 为应用创建 API Key，将密钥保存在服务端环境变量或密钥管理服务中。
- 将客户端 Base URL 设置为 https://api.token4ai.cloud/v1。部分工具会单独拼接接口前缀，请按工具要求配置，避免重复添加 /v1。
查询你的密钥可以访问的模型
在本地环境或部署密钥中设置 TOKEN4AI_API_KEY，然后执行下面的模型列表请求。这个示例用于发现可用模型，不会生成模型回答。
从返回的列表中选择支持目标请求类型的模型，并复制准确的 ID。模型可用性会变化，请使用实际返回值。
curl https://api.token4ai.cloud/v1/models \
-H "Authorization: Bearer $TOKEN4AI_API_KEY"发送并核对第一次请求
在客户端填入 Base URL、密钥和 model ID，通过受支持的接口发送一个简短提示词。模型生成会按照当前计费规则消耗账户额度。
进入控制台使用历史，检查请求是否成功，以及模型、延迟和 Token 消耗是否符合预期。使用流式响应时，还应验证客户端能正确处理增量内容和连接中断。
常见接入报错如何处理？
- 401：检查是否使用有效的 Token4AI 密钥，以及 Authorization 请求头是否正确。
- 403：检查密钥权限和账户是否允许访问目标功能。
- 模型不存在：重新查询模型列表，核对完整的 model ID。
- 429：降低并发并采用有限次数的退避重试。限流可能发生在请求链路的不同位置，请保留 request ID 以便排查。
如何保护 API Key？
不要将密钥写入公开网页、浏览器代码包或分享截图。开发公开 Web 应用时，应通过自己的服务端转发模型请求。密钥泄露后应及时撤销。
接口兼容指的是受支持的操作，不代表每一个厂商 SDK 的全部功能都可直接使用。特殊参数和工具能力请结合文档与实际调用结果确认。