Skip to main content
这页说明所有模型调用共用的基础规则。完整的字段定义和响应 Schema 请看 Apifox 接口参考；本帮助中心负责说明该选什么协议、如何安全地开始调用。
先做一次能力确认NexusAPI 的可用模型会随 API Key 的分组、模型限制和实时状态变化。不要把模型广场里的全站列表当成某一把 Key 一定可调用的清单。

​
三项必要信息

通用 OpenAI 风格客户端使用：
手写 HTTP 请求时，把 API Key 放入 Authorization：
不要把完整 Key 写入前端、截图、聊天记录或 Git 仓库。不同客户端是否要填写 /v1 并不完全相同：Claude Code 使用不带 /v1 的站点地址，Codex CLI 按其 Provider 配置填写。请优先遵循对应的客户端工具教程。

​
用当前 Key 列出模型

创建 Key 或切换分组后，先运行一次：
从响应的 data[].id 复制模型 ID。模型列表只表示这把 Key 当前可见的模型，不代表全部平台模型；若响应中包含 supported_endpoint_types，可用它辅助判断标注的协议类型。

​
选择正确的协议

模型名称相同，不等于它可以接受任意一种请求格式。先在接口与模型能力矩阵确认协议，再选下面的详细说明：

​
最小验证和重试原则

  1. 先列模型，再发送一条短文本或最小图片请求。
  2. 确认模型 ID、Key 分组和路径正确后，才加入可选参数、流式输出或批量任务。
  3. 出错时保留错误原文、发生时间和 Request ID；不要在未确认结果前高频重放同一请求。
401 通常应检查 Key；404 首先检查 /v1 是否重复或缺失；400 首先检查模型、协议和字段。更多处理方式见问题自查。