聊天

创建聊天

为给定的对话请求模型回应。支持串流与非串流两种模式,单一 OpenAI 兼容请求/响应格式跨所有模型与供应商通用。

POST/api/v1/chat/completions

验证

Authorization必填

string · header

在 Authorization 标头以 Bearer token 传入 API 密钥。

Body

model必填

string

要使用的模型,供应商前缀格式,例如 "openai/gpt-4.1"。常见家族的简称(例如 "gpt-4o")会自动解析为完整的 canonical id("openai/gpt-4o");已是 canonical 形式的值原样通过。无法解析的简称不会被硬改写,模型解析阶段会返回清楚的「找不到模型」错误。

minLength: 1

Example: "openai/gpt-4.1"

messages必填

Message[]

对话消息数组,至少一条。每条含 role(system/user/assistant/tool)与 content。

minLength: 1

models

string[]

备用模型列表——依序尝试,主要模型的候选组全部失败时才会用到。

stream

boolean

true 时以 SSE 串流回应;省略或 false 为一次性 JSON 回应。

temperature

number

采样温度,越高越随机、越低越确定。

0–2

max_tokens

integer

响应可生成的最大 token 数。

max_completion_tokens

integer

max_tokens 的别名,语义相同。

top_p

number

核采样(nucleus sampling)阈值。

0–1

top_k

integer

限制采样时只从概率最高的 K 个 token 中选。

frequency_penalty

number

依 token 已出现的频率惩罚重复。

-2.0–2.0

presence_penalty

number

依 token 是否曾出现过(不论次数)惩罚重复。

-2.0–2.0

repetition_penalty

number

重复 token 的惩罚系数,独立于 frequency/presence penalty 的另一种机制。

min_p

number

相对于最高概率 token 的最小概率门槛。

0–1

top_a

number

另一种动态调整采样范围的机制,依最高概率的平方缩放门槛。

seed

integer

确定性采样种子;非所有供应商都保证可重现。

n

integer

要生成的回应数量。

stop

string | string[]

遇到即停止生成的字符串,最多 4 个。

tools

Tool[]

模型可调用的工具/函数定义列表。

tool_choice

string | object

控制模型是否/如何被强制调用工具。

parallel_tool_calls

boolean

有提供 tools 时,是否允许并行工具调用。默认 true。仅限 OpenAI 系列模型——目标模型不是 OpenAI 自家的时,此字段会被静默拿掉,不会报错。

response_format

object

限制输出格式,例如 {type:"json_object"} 或带 JSON Schema 的 {type:"json_schema"}。

logit_bias

object

把 token ID 对映到 [-100, 100] 的偏差值,在采样前加上。仅限 OpenAI 系列模型——目标模型不是 OpenAI 自家的时,此字段会被静默拿掉,不会报错。

logprobs

boolean

返回每个输出 token 的对数概率。仅限 OpenAI 系列模型——目标模型不是 OpenAI 自家的时,此字段会被静默拿掉,不会报错。

top_logprobs

integer

每个位置返回概率最高的候选 token 数(需搭配 logprobs: true)。仅限 OpenAI 系列模型——目标模型不是 OpenAI 自家的时,此字段会被静默拿掉,不会报错。

0–20

user

string

终端使用者识别码,用于监控与滥用侦测。对计费无影响。仅限 OpenAI 系列模型——目标模型不是 OpenAI 自家的时,此字段会被静默拿掉,不会报错。

reasoning

object

推理模型的思考控制对象(例如 {effort, max_tokens})。

reasoning_effort

string

reasoning.effort 的简写平面字段。

lowmediumhigh

image_config

object

图片生成/图生图选项(当 modalities 含 image 时使用)。

modalities

string[]

要求的输出模态。含 image 时走图片生成派工路径。

textimage

plugins

object[]

插件数组(例如 {id:"web"} 启用网页搜索)。仅部分模型路由支持,不支持时无效;:online 模型变体会自动注入 {id:"web"},同样仅限支持的路由。

POST /api/v1/chat/completions

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Explain quantum computing in one paragraph."}]
  }'

响应示例

成功。BazaarLink 只正规化两个字段——model,以及移除 provider 字段——其余上游响应原样转发,包括 native_finish_reason、system_fingerprint、reasoning 等只有在该供应商有填值时才会出现的字段。usage.cost 是例外,永远是 BazaarLink 自己结算的金额,不是上游转发过来的数值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1740000000,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing leverages quantum mechanics..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 74,
    "total_tokens": 102,
    "cost": 0.000648
  }
}