FAQ

按照快速开始完成账户登录、创建 API Key、选择模型和发送最小请求。首次测试建议先使用 OpenAI Chat 兼容调用，确认基础链路成功后再增加流式输出、工具调用或多模态输入。

前往 API Keys 创建、禁用或删除令牌。不同环境建议使用不同的 Key；不再使用或疑似泄露的 Key 应及时禁用或删除。

推荐 Base URL 是 https://api.agtcloud.cn/v1。使用 OpenAI SDK 时，将它配置为 base_url 或 baseURL，OpenAI 兼容接口通常使用 Authorization: Bearer your-api-key 认证。其他协议应以对应 API Reference 要求的认证 Header 为准。详细说明见 API Key、Base URL 与认证。

不建议。长期 API Key 应保存在可信服务端、服务端环境变量或密钥管理服务中。浏览器和移动端应用应请求你自己的后端，再由后端调用 AGTCloud，避免用户提取和滥用 Key。

常见原因是 Base URL 已经包含 /v1，代码又在端点前重复添加了 /v1。建议使用 https://api.agtcloud.cn/v1 作为 SDK Base URL，再让 SDK 自动拼接 /chat/completions 等端点。排障时检查最终发出的完整 URL。

前往 模型广场 查看当前展示的模型和模型 ID。模型可见范围会随平台配置和账户权限变化；调用时请复制当前页面显示的 ID，并以实际请求结果为准。

没有必须保留的原厂协议语义时，可以先从 OpenAI Chat Completions 开始，因为它的 SDK 和接入方式比较普遍。已有 Anthropic、Gemini 或 Responses 应用时，应优先保留现有 SDK 和消息结构，再确认目标模型的适配情况。

401 先检查对应协议要求的认证 Header 和 API Key；403 检查账户、Key 和模型权限；404 检查 Base URL、端点、模型 ID 或任务 ID。不要对这些错误无限重试，先修复明确原因。更多步骤见错误与排障。

检查响应头中的 x-request-id、request-id 或 x-oneapi-request-id，保存实际存在的值。部分错误正文中也可能包含 Request ID；如果没有找到，仍应记录请求时间、Method、Path、模型和 HTTP 状态。代码示例见 Request ID。

立即前往 API Keys 禁用或删除旧 Key，然后创建新 Key 并更新使用它的服务。检查代码仓库、日志、截图和聊天记录中是否仍有副本；如果曾提交到 Git，不要只删除当前文件，还要按团队安全流程处理历史记录。

准备请求时间和时区、Method、Path、模型 ID、HTTP 状态、脱敏错误信息、SDK 与运行时版本，以及最小复现步骤。响应中存在 Request ID 时一并保存。不要提交完整 API Key、认证 Header、Cookie、客户 Prompt 或私有文件。