Chat Completions API

端点

POST https://api.barqapi.com/v1/chat/completions

请求参数

参数	类型	必填	描述
model	string	✅ 是	模型 ID（如 gpt-4o, deepseek-v4-pro）
messages	array	✅ 是	消息数组，含 role 和 content
temperature	number	否	采样温度（0–2），默认 1
max_tokens	integer	否	响应最大 token 数
stream	boolean	否	启用 SSE 流式输出，默认 false

消息角色

角色	描述
system	设定模型行为（仅首条消息）
user	用户消息
assistant	模型回复（多轮对话）

请求示例

{
  "model": "gpt-4o",
  "messages": [
    {"role": "system", "content": "你是一个有用的中阿翻译助手。"},
    {"role": "user", "content": "翻译：'Welcome to Saudi Arabia'"}
  ],
  "temperature": 0.7
}

响应示例

{
  "id": "chatcmpl-abc123",
  "model": "gpt-4o",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "مرحباً بكم في المملكة العربية السعودية"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 12,
    "total_tokens": 37
  }
}