API 中转介绍
SDK 调用示例
Python / Node / Go / Bash 等多语言 SDK 接入 Nexoraivision API 的示例代码。
适合自己写代码集成的开发者。如果你是用 Codex CLI / Claude Code CLI / Cursor 等现成工具,请用 API 密钥 → 使用密钥 获取现成配置,无需自己写代码。
准备工作
调用 OpenAI 协议模型(GPT 系列)
base_url 用 https://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)
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://nexor.nexoraivision.com/v1'
})
const resp = await client.chat.completions.create({
model: 'gpt-5.4',
messages: [
{ role: 'system', content: '你是一个简洁的中文助手' },
{ role: 'user', content: '用三句话解释幂等性' }
],
temperature: 0.7,
max_tokens: 1200
})
console.log(resp.choices[0].message.content)
package main
import (
"context"
"fmt"
"github.com/sashabaranov/go-openai"
)
func main() {
config := openai.DefaultConfig("YOUR_API_KEY")
config.BaseURL = "https://nexor.nexoraivision.com/v1"
client := openai.NewClientWithConfig(config)
resp, err := client.CreateChatCompletion(context.Background(),
openai.ChatCompletionRequest{
Model: "gpt-5.4",
Messages: []openai.ChatCompletionMessage{
{Role: "system", Content: "你是一个简洁的中文助手"},
{Role: "user", Content: "用三句话解释幂等性"},
},
Temperature: 0.7,
MaxTokens: 1200,
})
if err != nil { panic(err) }
fmt.Println(resp.Choices[0].Message.Content)
}
curl https://nexor.nexoraivision.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [
{"role": "system", "content": "你是一个简洁的中文助手"},
{"role": "user", "content": "用三句话解释幂等性"}
],
"temperature": 0.7,
"max_tokens": 1200
}'
调用 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)
import Anthropic from '@anthropic-ai/sdk'
const client = new Anthropic({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://nexor.nexoraivision.com/v1'
})
const resp = await client.messages.create({
model: 'claude-sonnet-4-6',
max_tokens: 1024,
messages: [{ role: 'user', content: 'Hi' }]
})
console.log((resp.content[0] as any).text)
curl https://nexor.nexoraivision.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hi"}]
}'
调用 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 格式、模型名 |
401 | Key 无效 | 控制台确认 Key 状态 |
403 | 无权限 | Key 分组不包含该模型 / IP 白名单拒绝 |
404 | 接口不存在 | URL 拼写检查 |
429 | 限流 | 加指数退避 |
5xx | 服务端错 | 重试,持续失败联系客服 |
在其他流行工具里接入
| 工具 | 配置入口 | base_url |
|---|---|---|
| LangChain | ChatOpenAI(base_url=...) | .../v1 |
| LlamaIndex | OpenAI(api_base=...) | .../v1 |
| Continue (VSCode) | ~/.continue/config.json | .../v1 |
| Cursor | Settings → Models | .../v1 |
| Cline | 设置 → API Provider | .../v1 |
| OpenCode | opencode.json | .../v1 |
| Codex CLI | ~/.codex/config.toml | https://nexor.nexoraivision.com(不带 /v1) |
| Claude Code CLI | 环境变量 ANTHROPIC_BASE_URL | https://nexor.nexoraivision.com(不带 /v1) |
