API 中转介绍

SDK 调用示例

Python / Node / Go / Bash 等多语言 SDK 接入 Nexoraivision API 的示例代码。
适合自己写代码集成的开发者。如果你是用 Codex CLI / Claude Code CLI / Cursor 等现成工具,请用 API 密钥 → 使用密钥 获取现成配置,无需自己写代码。

准备工作

  1. 注册账号并 创建 API 密钥 → 拿到 sk-xxx... 开头的 Key
  2. 选好你要用的模型(见 可用渠道
  3. 选好接入端点(默认推荐 https://nexor.nexoraivision.com

调用 OpenAI 协议模型(GPT 系列)

base_urlhttps://nexor.nexoraivision.com/v1,其他和官方 OpenAI SDK 一致。

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
)
print(resp.choices[0].message.content)

调用 Anthropic 协议模型(Claude 系列)

from anthropic import Anthropic

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

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hi"}]
)
print(resp.content[0].text)

调用 Gemini 协议模型

Gemini 支持两种调用方式,推荐用 OpenAI 兼容协议(无需引入 Google SDK)。

方式 A:OpenAI 兼容协议(推荐)

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[{"role": "user", "content": "你好"}]
)

方式 B:Google GenAI SDK

from google import genai

client = genai.Client(
    api_key="YOUR_API_KEY",
    http_options={"base_url": "https://nexor.nexoraivision.com"}
)

resp = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="你好"
)

调用 Responses API(GPT-5.x Codex 系列推荐)

/v1/responses 是 OpenAI 新的统一接口,Codex 系列模型推荐

curl https://nexor.nexoraivision.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "instructions": "你是一个简洁的中文助手",
    "input": "用三句话解释幂等性",
    "temperature": 0.7,
    "max_output_tokens": 1200,
    "reasoning": {"effort": "medium"}
  }'
注意 Responses API 用嵌套对象reasoning: {"effort": "medium"}Chat Completions 用顶层 reasoning_effort: "medium"。两者互不通用,详见 Codex API 接口

调用图像生成 API

curl https://nexor.nexoraivision.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫戴橙色围巾,温暖插画风格",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "n": 1
  }'

返回 base64,自己 decode 存盘。详见 Codex 图像模型

流式响应

"stream": true 即可:

stream = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "写首关于秋天的诗"}],
    stream=True
)
for chunk in stream:
    print(chunk.choices[0].delta.content or '', end='', flush=True)

3 条接入端点

控制台「API 密钥」页面会显示 3 条线路:

线路地址适合
默认https://nexor.nexoraivision.com国内绝大多数场景
国际线路https://nexor.nexoraivision.com海外服务器 / 跨境业务
海外线路https://api.nexoraivision.com备用、容灾

测试网络延迟选最快的用

错误码速查

HTTP 状态含义排查
200成功
400请求参数错检查 JSON 格式、模型名
401Key 无效控制台确认 Key 状态
403无权限Key 分组不包含该模型 / IP 白名单拒绝
404接口不存在URL 拼写检查
429限流加指数退避
5xx服务端错重试,持续失败联系客服

在其他流行工具里接入

工具配置入口base_url
LangChainChatOpenAI(base_url=...).../v1
LlamaIndexOpenAI(api_base=...).../v1
Continue (VSCode)~/.continue/config.json.../v1
CursorSettings → Models.../v1
Cline设置 → API Provider.../v1
OpenCodeopencode.json.../v1
Codex CLI~/.codex/config.tomlhttps://nexor.nexoraivision.com(不带 /v1
Claude Code CLI环境变量 ANTHROPIC_BASE_URLhttps://nexor.nexoraivision.com(不带 /v1

下一步

监控调用

按 Key / 模型 / 时间查看调用明细

常见问题

集成报错、限流处理等