OpenAI Chat Completions

POST https://api.nexuskey.cn/v1/chat/completions

与 OpenAI Chat Completions API 兼容。Claude 系模型经此端点时自动桥接为 Anthropic 原生上游调用（见 跨协议调用）。

请求参数

参数	类型	必填	说明
model	string	是	模型原名，如 claude-sonnet-4-5、gpt-5
messages	array	是	system / user / assistant / tool 消息数组
stream	boolean	否	开启 SSE 流式
max_tokens / max_completion_tokens	integer	否	输出上限
temperature / top_p	number	否	采样参数
tools / tool_choice	array / string	否	函数工具定义与选择策略
stop	string/array	否	停止序列
response_format	object	否	JSON 输出约束（按上游支持度）

示例

Python

from openai import OpenAI

client = OpenAI(base_url="https://api.nexuskey.cn/v1", api_key="<你的 NEXUSKEY_API_KEY>")
completion = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[
        {"role": "system", "content": "你是一个简洁的助手"},
        {"role": "user", "content": "什么是提示缓存？"},
    ],
    max_tokens=512,
)
print(completion.usage)

cURL

curl https://api.nexuskey.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NEXUSKEY_API_KEY" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "什么是提示缓存？"}],
    "max_tokens": 512
  }'

响应

OpenAI 标准结构：id、choices[].message、usage。

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "claude-sonnet-4-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "…" },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 128,
    "total_tokens": 160,
    "prompt_tokens_details": { "cached_tokens": 0 }
  }
}

usage 与计费

usage 为展示口径；计费按上游原生 usage 归一（缓存读/写单列），明细见控制台「使用记录」与 计费与套餐。

流式

"stream": true 返回 SSE；网关会自动向上游注入 usage 统计选项，最后一个数据块携带 usage，随后 data: [DONE]。详见 流式（SSE）。

错误

协议端点返回 OpenAI 风格错误体：

{ "error": { "message": "…", "type": "invalid_request_error", "code": "model_not_found" } }

状态码矩阵见 错误码。