四步确认
1. 模型 ID
从模型与价格总表或控制台复制准确模型 ID,避免根据产品名称、昵称或第三方文章自行拼接。2. 端点和协议
确认模型使用 Chat Completions、Responses、Images、Embeddings、音频、视频异步任务或其他端点。不能只因为模型出现在/v1/models 就推断所有协议都可用。
3. API Key 分组和权限
同一模型可能只对特定 API Key 分组、计费类型或账户开放。使用实际生产密钥前,先以独立测试密钥验证;需要企业权限、折扣或特殊分组时联系站长或支持团队。4. 发送最小请求并检查结果
用目标 API Key 发送一个只含必要参数的请求,然后逐项检查:- 响应里有预期内容,例如文本、图片数据或任务 ID,而不只是 HTTP 200;
- 调用日志记录了该模型、令牌分组和扣费,且扣费与控制台价格一致;
- 业务需要的流式输出、工具调用、多模态输入等功能,分别用一个小请求确认能正常工作。
常见错误分类
联系支持时提供什么
- 账户邮箱或用户名;
- 模型 ID、端点和 API Key 分组;
- 请求时间和时区;
- 脱敏后的错误与请求标识;
- 最小请求和预期结果;
- 控制台价格页或模型页截图。