Chat Completions

Chat Completions 是 Brivionix 模型市场当前公开提供的核心调用接口。

端点

POST https://brivionix.com/v1/chat/completions

请求头

Authorization: Bearer sk-你的令牌
Content-Type: application/json

最小请求

{
  "model": "gpt-5.4-mini",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
}

curl 示例

curl https://brivionix.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "请用一句话介绍 Brivionix。"}
    ]
  }'

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://brivionix.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "请用一句话介绍 Brivionix。"}
    ],
)

print(response.choices[0].message.content)

Node.js 示例

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-你的令牌',
  baseURL: 'https://brivionix.com/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-5.4-mini',
  messages: [
    { role: 'user', content: '请用一句话介绍 Brivionix。' },
  ],
});

console.log(response.choices[0].message.content);

流式输出

请求中加入 "stream": true 即可使用 OpenAI 兼容的 SSE 流式响应：

{
  "model": "gpt-5.4-mini",
  "messages": [
    {"role": "user", "content": "写一首短诗"}
  ],
  "stream": true
}

Python：

stream = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

常用参数

Playground 当前提供的参数，对应 OpenAI Chat Completions 常见字段：

参数	说明
model	模型名（见 可用模型列表）
messages	对话消息数组，按 OpenAI 角色 system / user / assistant / tool 组织
temperature	控制随机性，Playground 默认 0.7
top_p	核采样，Playground 默认 1
frequency_penalty	降低重复用词
presence_penalty	鼓励讨论新主题
max_tokens	最大输出 Token
seed	复现实验用的种子
stream	是否开启 SSE 流式输出
tools / tool_choice	工具调用（适用于带 Tools 标签的模型）

多模态（图片）

Playground 提供 Image URL 开关。当前 5 个模型均带 Vision 标签，可使用 OpenAI 多模态消息格式传入图片：

{
  "model": "gpt-5.4-mini",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "请描述这张图片。"},
        {
          "type": "image_url",
          "image_url": {"url": "https://example.com/image.jpg"}
        }
      ]
    }
  ]
}

建议先在 Playground 用 Image URL 验证模型可用，再接入生产。

响应字段

返回结构与 OpenAI Chat Completions 一致，关键字段：

字段	说明
id	本次响应 ID
model	实际响应使用的模型名
choices[].message.content	模型输出文本
choices[].message.tool_calls	工具调用（如有）
usage.prompt_tokens / completion_tokens / total_tokens	Token 计费用量

错误排查

参见 API 概览 — 错误排查。