OpenAI Chat Completions 接入与 SDK

NAAPI 提供的 OpenAI Chat Completions 兼容接口，适合 OpenAI SDK、聊天客户端和 AI Agent 快速迁移。

LLM 必读

API Base URL：https://naapi.cc/v1

完整接口：POST https://naapi.cc/v1/chat/completions

鉴权：Authorization: Bearer <API_KEY>

非流式文本：choices[0].message.content

流式文本增量：choices[0].delta.content

API Key 建议从 NAAPI_API_KEY 环境变量读取

naapi.apifox.cn 是文档域名，不是 API 请求域名。

适用场景

现有项目使用 client.chat.completions.create(...)

应用依赖 messages 对话数组

需要 SSE 流式输出、JSON 输出或函数工具调用

需要兼容现有 OpenAI 生态客户端

新项目如果依赖 previous_response_id 或 Responses 工具协议，优先使用 /v1/responses。

最小 curl 请求

将 MODEL 替换为账户当前可用的模型 ID。

核心字段

字段	必填	说明
`model`	是	模型 ID
`messages`	是	`system` / `user` / `assistant` / `tool` 消息数组
`stream`	否	`true` 返回 SSE 流，默认 `false`
`temperature`	否	采样温度
`max_tokens`	否	传统最大输出 Token 数
`max_completion_tokens`	否	新式最大补全 Token 数
`tools`	否	OpenAI 函数工具定义
`tool_choice`	否	`auto`、`none`、`required` 或指定函数
`response_format`	否	JSON 模式或 JSON Schema
`stream_options.include_usage`	否	流式结束前返回 usage
`reasoning_effort`	否	支持的模型可使用 `low` / `medium` / `high`

Python 官方 SDK

Python 流式输出

JavaScript 官方 SDK

LLM / Agent 执行规则

只有用户需要边生成边显示时才设置 stream: true。

不要把 Responses API 的 input / instructions 发到此接口。

工具结果必须回传真实的 tool_call_id。

结构化输出优先使用模型支持的 response_format，业务侧仍要校验。

API Key 不得写入源码、前端包、文档、日志或对话记录。

失败时读取 error.message；400 / 401 / 429 不要用相同参数盲目重试。

网络超时可带退避重试一次；流式中断后不要无条件重放工具请求。

常见错误

状态	常见原因	处理
`400`	字段错误或模型不支持参数	读取 `error.message` 并修正请求
`401`	API Key 缺失或无效	检查 Bearer 鉴权
`429`	频率、并发或额度限制	降低并发，检查账户状态
`5xx`	上游或网关短暂异常	使用有上限的退避重试

OpenAI Chat Completions

OpenAI Chat Completions 接入与 SDK#

LLM 必读#

适用场景#

最小 curl 请求#

核心字段#

Python 官方 SDK#

Python 流式输出#

JavaScript 官方 SDK#

LLM / Agent 执行规则#

常见错误#