Skip to content

对话补全

POST /v1/chat/completions —— 最常用的文本对话接口,兼容 OpenAI Chat Completions 格式。

请求示例

bash
curl https://api.novaapis.com/v1/chat/completions \
  -H "Authorization: Bearer $NOVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "你是一个乐于助人的助手。" },
      { "role": "user", "content": "用一句话介绍 NovaAPI" }
    ]
  }'

常用参数

参数类型说明
modelstring模型名称,见模型列表
messagesarray对话消息数组
streamboolean是否流式返回,默认 false
temperaturenumber采样温度,0~2
max_tokensnumber最大生成 token 数

流式返回

设置 "stream": true,服务端以 SSE 分块推送内容:

python
from openai import OpenAI

client = OpenAI(api_key="...", base_url="https://api.novaapis.com/v1")

stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "讲个笑话"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")