Skip to main content

准备内容

开始前,你只需要准备三样东西:
  • API Key
  • 固定 Base URL:https://niuapi.vip/v1
  • 一个兼容 OpenAI 调用方式的客户端或 SDK
智牛API 当前文档聚焦文本对话能力,本文示例统一使用 https://niuapi.vip/v1 作为 Base URL。

一次最小可用请求

请求本质上很简单:带上 Authorization: Bearer <API Key>,向 /chat/completions 发送模型名和 messages

Python 示例

如果你已经在用官方 OpenAI Python SDK,迁移会很顺手。核心就是把 base_url 指向智牛API。

JavaScript 示例

官方 OpenAI Node SDK 也可以直接按兼容方式使用,注意这里的字段名是 baseURL

你需要知道的三个关键点

model 用来指定你要调用的模型。它必须是当前可用且填写正确的模型名。模型名写错时,请求通常会直接失败。
messages 是对话上下文数组。你可以放 systemuserassistant 等角色内容。单轮对话放一条 user 消息就够,多轮对话则按顺序追加历史消息。
所有请求都需要通过 Authorization: Bearer YOUR_API_KEY 传递密钥。没有 Key、Key 无效,或格式写错,接口都不会正常返回结果。

常见问题

请确认 Base URL 固定为 https://niuapi.vip/v1。常见错误包括漏掉 /v1、把完整接口路径写进 SDK 的 Base URL,或者仍然指向别的服务地址。
检查 Authorization 请求头是否为 Bearer YOUR_API_KEY 格式。注意不要漏掉 Bearer 前缀,也不要把占位符直接拿去跑生产请求。
如果返回模型不存在、不可用或参数错误,先检查 model 是否填写为当前支持的有效名称。不要想当然沿用旧项目里的模型名。
如果你已经有基于 OpenAI SDK 的代码,通常只需要改三处:API Key、Base URL,以及模型名。

下一步

API 总览

先了解认证方式、请求约定、状态码和错误结构。

文本对话接口

继续查看 /chat/completions 的完整参数说明和返回示例。