NeonAPI Docs
API 参考

聊天补全

调用 NeonAPI 所需的接口、请求参数与响应结构。

POST /v1/chat/completions

身份验证

将 NeonAPI 密钥放入 Authorization: Bearer YOUR_API_KEY 请求头，在可信应用环境中保管密钥。

可用性与兼容性

调用前核对模型的协议、权限、报价和支持参数。不支持的参数可能被拒绝。示例中的密钥与模型均为占位符。

请求参数

application/json

字段类型必填约束含义
modelstring是—模型广场发布的准确 ID。
messagesMessage[]是—按顺序提供角色与内容组成的对话消息。
temperaturenumber否≥ 0; ≤ 2; default: 1模型支持时使用的采样温度。
top_pnumber否≥ 0; ≤ 1; default: 1核采样概率。
ninteger否≥ 1; default: 1生成结果数量，受模型限制。
streamboolean否default: false请求增量流式事件。
stream_optionsobject否—流式选项，如模型支持的用量返回。
stopstring / string[]否——
max_tokensinteger否—输出 token 上限，取决于模型。
max_completion_tokensinteger否—兼容模型的补全 token 预算。
presence_penaltynumber否≥ -2; ≤ 2; default: 0—
frequency_penaltynumber否≥ -2; ≤ 2; default: 0—
logit_biasobject否——
userstring否——
toolsTool[]否—由应用提供的工具定义。
tool_choicestring / object否—控制工具的选择方式。
response_formatResponseFormat否—模型支持的输出格式。
seedinteger否——
reasoning_effortstring否low, medium, high—
modalitiesstring[]否——
audioobject否——

完整字段定义、嵌套对象和引用结构可在下载的规范中查看。

请求示例

export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1/chat/completions \
  -H "Authorization: Bearer $NEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}'

响应说明

实际字段因模型与协议而异。下方结构描述文档中的成功响应；流式请求使用对应协议的事件。

状态码含义
200请求成功
400请求参数错误
429请求频率受限

响应结构

字段类型必填约束含义
idstring否—该结果或任务的标识符。
objectstring否——
createdinteger否——
modelstring否—模型广场发布的准确 ID。
choicesobject[]否—生成的补全候选结果。
usageUsage否—当前协议返回的用量数据。
system_fingerprintstring否——

下载用户侧 OpenAPI 规范

另见常见错误与流式响应和异步任务。

列出 Gemini 模型

调用 NeonAPI 所需的接口、请求参数与响应结构。

Responses 响应

调用 NeonAPI 所需的接口、请求参数与响应结构。

本页目录

身份验证
可用性与兼容性
请求参数
请求示例
响应说明
响应结构