Nexoraivision Nexoraivision
Codex 中转介绍

🧩 API 接口调用

Nexoraivision Codex 中转的 Responses API / Chat Completions API 调用参数与示例。
本页是 HTTP API 直接调用参考，适合自己写代码集成或调试。如果你只是用 Codex CLI / OpenCode / Cursor 等现成客户端，看 手动配置 或 编辑器集成 即可。

接口总览

接口URL用途
Responses API（推荐）POST /v1/responses新版统一文本接口，支持所有 GPT-5.x
Chat Completions（兼容）POST /v1/chat/completionsOpenAI 老协议，兼容存量 SDK
ModelsGET /v1/models列出当前可用模型
Images GenerationsPOST /v1/images/generations文生图，详见 图像模型
Images EditsPOST /v1/images/edits参考图编辑，详见 图像模型

统一 Base URL：

https://nexor.nexoraivision.com

认证方式：Authorization: Bearer YOUR_API_KEY

连通性快速测试

curl https://nexor.nexoraivision.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

返回 JSON 模型列表 = 连通正常。返回 401 / 403 优先检查 Key 状态、分组、过期时间。

一、Responses API（推荐）

新版接口，所有 GPT-5.x 文本模型都用这个。

接口地址

POST https://nexor.nexoraivision.com/v1/responses

常用参数

参数必填说明
model✅模型名，如 gpt-5.4、gpt-5.3-codex
input✅输入内容，字符串或消息数组（支持 [{role, content}]）
instructions—系统提示词（建议放这里，而不是混在 input 里）
temperature—采样温度，建议 0-2
top_p—核采样，0-1
max_output_tokens—最大输出 token 数
reasoning.effort—嵌套对象：{"effort": "low" / "medium" / "high" / "xhigh"}
stream—true 开启流式响应（SSE）
tools—工具定义数组（Function Calling）
重要：Responses API 的推理强度字段是嵌套对象 reasoning: {"effort": "medium"}，不是 Chat Completions 的顶层 reasoning_effort。写错会直接 upstream_error。

调用示例

curl https://nexor.nexoraivision.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "instructions": "你是一个简洁的中文助手",
    "input": "用三句话解释幂等性",
    "temperature": 0.7,
    "top_p": 1,
    "max_output_tokens": 1200,
    "reasoning": {"effort": "medium"}
  }'
也可以把 input 写成消息数组（OpenAI 官方支持）：
"input": [
  {"role": "system", "content": "你是一个简洁的中文助手"},
  {"role": "user", "content": "用三句话解释幂等性"}
]
但推荐用 instructions 字段 + input 纯字符串的写法 — 中转端兼容性更好，OpenAI 官方也推荐这样。

流式响应

加 "stream": true，响应改为 SSE：

curl https://nexor.nexoraivision.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "input": "写一首关于秋天的短诗",
    "stream": true
  }'

输出格式（每行一个 SSE 事件）：

event: response.output_text.delta
data: {"delta":"秋"}

event: response.output_text.delta
data: {"delta":"风"}

...

event: response.completed
data: {"response":{...}}

二、Chat Completions API（兼容）

老协议，所有原本走 api.openai.com/v1/chat/completions 的 SDK 直接换 base URL 即可。

接口地址

POST https://nexor.nexoraivision.com/v1/chat/completions

字段对应

Responses 字段Chat Completions 字段
instructions + input (字符串)messages 数组（含 system 消息）
input (消息数组)messages
max_output_tokensmax_tokens
reasoning: {effort: "..."}（嵌套对象）reasoning_effort: "..."（顶层字段）
注意 reasoning_effort vs reasoning.effort：
  • Chat Completions 用顶层 reasoning_effort: "medium"
  • Responses 用嵌套 reasoning: {"effort": "medium"}
两者互不通用，混用会报 upstream_error。

调用示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://nexor.nexoraivision.com/v1"
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "system", "content": "你是一个简洁的中文助手"},
        {"role": "user", "content": "用三句话解释幂等性"}
    ],
    temperature=0.7,
    max_tokens=1200,
    reasoning_effort="medium"
)
print(resp.choices[0].message.content)

Function Calling（工具调用）

Responses 和 Chat Completions 都支持 tools 字段。结构与 OpenAI 官方一致：

{
  "model": "gpt-5.4",
  "input": [
    {"role": "user", "content": "今天上海天气怎么样"}
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "获取指定城市的实时天气",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {"type": "string", "description": "城市名"}
          },
          "required": ["city"]
        }
      }
    }
  ]
}

模型识别到需要调用工具时，返回 tool_calls：

{
  "output": [
    {
      "type": "function_call",
      "name": "get_weather",
      "arguments": "{\"city\":\"上海\"}"
    }
  ]
}

结构化输出（JSON Schema）

强制返回符合 schema 的 JSON：

{
  "model": "gpt-5.4",
  "input": [{"role": "user", "content": "提取出张三 25 岁的姓名和年龄"}],
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "person",
      "schema": {
        "type": "object",
        "properties": {
          "name": {"type": "string"},
          "age": {"type": "integer"}
        },
        "required": ["name", "age"]
      }
    }
  }
}

错误码速查

状态码含义排查
200成功—
400请求参数错检查 JSON 格式、模型名拼写、参数取值范围
401Key 无效控制台确认 Key 状态、是否被吊销
403无权限Key 所属分组没授权该模型 / IP 白名单拒绝
404接口不存在检查 URL 是否拼对（/v1/responses vs /v1/chat/completions）
413请求体过大减少 input 长度或换 1M 上下文模型
422字段值不合法如 temperature 超出 0-2 范围
429触发限流加指数退避，或控制台升配
500 / 502 / 503服务端错重试，持续报错联系客服

详细排错见 故障排查。

下一步

图像模型调用

gpt-image-2 文生图 + 参考图编辑完整参数

Codex 自动审查

CI / PR 自动调用 Codex 做代码审查

🔗 MCP 扩展服务

通过 Model Context Protocol 给 Codex 接入文件系统、Git、数据库等外部能力。

Claude Code 中转介绍

Nexoraivision Claude Code 中转为 Claude Code CLI、Claude App、OpenCode 等工具提供国内直连，无需科学上网。