必须进入Coze官方控制台获取Agent Space API最新文档：登录后依次点击「开发者工具」→「API文档」，内容与当前API密钥权限强绑定；若需OpenAI兼容模式，须在「空间设置」→「API管理」中手动启用；可用curl验证接口可用性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要快速查到Agent Space API的准确文档地址，不能只依赖搜索引擎或第三方博客，必须进入官方控制台获取实时、权威、带权限校验的接口说明。很多用户复制网上过期链接后发现404，是因为文档路径随版本迭代已变更。
进入Coze控制台查看最新API文档
打开浏览器，访问 https://www.php.cn/link/607f0983eb80ec6f1a5727c2e59c4913 → 使用你部署Agent Space的账号登录 → 左侧导航栏点击「开发者工具」→ 在子菜单中选择「API文档」。
该页面加载后会自动展示当前空间绑定的API密钥所支持的全部端点，包括/v1/chat/completions、/v1/agents/run等，每个接口都附带请求示例、参数说明和响应结构。【注意】文档内容与你当前空间的API权限等级强绑定，若看不到某个接口，说明该密钥未开通对应能力。
确认文档是否启用OpenAI兼容模式
在「API文档」页顶部，查找“OpenAI兼容端点”标签或搜索路径 /v1/chat/completions。若存在且状态为“已启用”，则可直接用标准OpenAI SDK调用；若显示“未启用”或根本搜不到该路径，则【必须启用代理中转】，不可直连。
返回控制台首页 → 点击右上角头像 → 进入「空间设置」→ 「API管理」→ 找到正在使用的密钥 → 点击右侧「编辑」→ 勾选「启用OpenAI兼容模式」→ 保存。
该开关关闭时，所有/v1路径请求都会返回404或schema mismatch错误，不是网络问题，是服务端主动拒绝。
通过curl验证文档中列出的接口是否真实可用
方法一：测试基础健康检查
在终端执行：curl -I https://api.coze.com/v1/health。如果返回 HTTP 200 OK，说明网关层正常；若返回 401 或 403，说明密钥未携带或无效。
方法二：绕过SDK直调文档示例接口
复制文档中/v1/chat/completions的curl命令，把YOUR_API_KEY替换成你控制台生成的真实密钥，然后执行。重点观察响应头中的X-RateLimit-Remaining字段——有该字段说明文档与后端服务完全对齐；若返回空响应或invalid_request_error，说明文档尚未同步最新字段约束。
