Skip to main content
这页说明所有模型调用共用的基础规则，帮助你判断该选什么协议、如何安全地开始调用。
先做一次能力确认NexusAPI 的可用模型会随 API Key 的分组、模型限制和实时状态变化。模型广场展示全站模型；当前 API Key 实际可调用的模型以 /v1/models 的返回为准。

​
三项必要信息

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

​
用当前 Key 列出模型

创建 Key 或切换分组后，先运行一次：
从响应的 data[].id 复制模型 ID。模型列表只表示这把 Key 当前可见的模型，不代表全部平台模型；data[].supported_endpoint_types 列出该模型当前可用的请求协议。只调用包含目标类型的路径：openai 对应 Chat Completions、anthropic 对应 Messages、openai-response 对应 Responses、image-generation 对应图片生成。若出现多个类型，可按所用客户端选择其中匹配的一种。

​
选择正确的协议

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

​
最小验证和重试原则

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