MNModel Nexus 使用文档
Model Nexus Docs

API 调用教程

给会写代码或要接入业务系统的人使用。普通用户优先配置 Codex 或 Claude Code。

API 调用适合谁

直接接入程序

API 调用适合会写代码、要接入业务系统，或想先用请求工具测试接口的人。Model Nexus 对外提供 OpenAI-compatible 地址：https://api.modelnexus.net/v1。

普通用户建议

如果只是想让 AI 帮你写代码，优先看 Codex、Claude Code、OpenCode 或 Oh My Pi 教程。

推荐 companion：Bruno

为什么推荐

Bruno 是本地优先的 API 客户端，可以用图形界面保存请求、headers 和 JSON body。它不要求先写程序，适合用来测试 key、模型和接口是否可用。

Bruno 官网下载 Bruno

不用 Bruno 也可以

下面也给出 curl 和 Python 示例。复制前先在左侧填入你的 key 和模型名。

Windows / macOS / Linux 测试

  1. 从 Bruno 下载页安装 Windows 版。
  2. 新建 HTTP request，方法选 POST。
  3. URL 填 https://api.modelnexus.net/v1/responses。
  4. Header 加 Authorization: Bearer 你的 key 和 Content-Type: application/json。
  5. Body 使用下面 Responses 示例。
  1. 从 Bruno 下载页安装 macOS 版。
  2. 新建 HTTP request，方法选 POST。
  3. URL 填 https://api.modelnexus.net/v1/responses。
  4. Header 和 Body 与 Windows 相同。
  1. 从 Bruno 下载页安装 Linux 版，或使用终端里的 curl。
  2. 新建 HTTP request，方法选 POST。
  3. URL 填 https://api.modelnexus.net/v1/responses。
  4. Header 和 Body 与 Windows 相同。

查看模型列表

curl /v1/models
curl https://api.modelnexus.net/v1/models \
  -H "Authorization: Bearer {{MODELNEXUS_API_KEY}}"

OpenAI Responses

curl /v1/responses
curl https://api.modelnexus.net/v1/responses \
  -H "Authorization: Bearer {{MODELNEXUS_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{"model":"{{MODEL}}","input":"用一句话介绍 Model Nexus"}'

Python

Python
from openai import OpenAI
client = OpenAI(api_key="{{MODELNEXUS_API_KEY}}", base_url="https://api.modelnexus.net/v1")
response = client.responses.create(model="{{MODEL}}", input="用一句话介绍 Model Nexus")
print(response.output_text)

常见问题

  • 401：Authorization header 要写成 Bearer 你的 key。
  • 404：直接 API 使用 https://api.modelnexus.net/v1。
  • 模型不存在：先调用 /v1/models 看 key 可用模型。