POST/v1/chat/completions

Chat Completions

平台会先校验模型权限和余额，再通过模型路由选择可用渠道。非流式响应返回标准 `chat.completion`；流式模式返回 SSE chunk。

基础信息

鉴权	Authorization: Bearer sk-...
请求类型	application/json
响应类型	application/json 或 text/event-stream

请求参数

Body

字段

类型

必填

位置

说明

model

string

是

body

平台统一模型 ID。

示例："gpt-4o"

messages

array<object>

是

body

OpenAI 风格消息数组。

示例：[{"role":"user","content":"你好"}]

role

string

是

body

消息角色，例如 user / assistant / system。

示例："user"

content

string

是

body

消息文本内容。

示例："请用一句话介绍千云开发者中心。"

temperature

number

否

body

采样温度。

示例：0.7

max_tokens

integer

否

body

最大输出 token 数。

示例：512

top_p

number

否

body

Top-p 采样。

示例：1

n

integer

否

body

候选回复数量。

示例：1

stream

boolean

否

body

是否使用 SSE 流式输出。

示例：false

user

string

否

body

调用方用户标识。

示例："developer-demo"

请求示例

json

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "请用一句话介绍千云开发者文档中心。"
    }
  ],
  "temperature": 0.7,
  "stream": false
}

响应示例

json

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1744512000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "千云开发者文档中心为模型聚合平台提供统一接入、调试与示例支持。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 24,
    "total_tokens": 50
  }
}

错误码

HTTP	code	说明
400	`invalid_request_error`	请求体结构不合法、缺少必填参数，或 JSON 无法解析。
401	`invalid_auth_header`	缺少或传错鉴权头，网关无法识别当前调用身份。
403	`model_not_allowed`	当前 API Key 没有访问该模型的权限。
402	`insufficient_balance`	余额不足，平台在调用前预检时已拒绝请求。
503	`model_not_available`	当前模型没有可用路由或上游渠道不可用。

在线调试

Playground · 浏览器直连网关

Chat Completions

兼容 OpenAI Chat Completions 协议，支持非流式与 `stream=true` 的流式返回。

Base URL Token / API Key

JSON 请求体

提示：将 `stream` 设为 `true` 时，响应会切换为 SSE。

json

尚未发起请求。

bash

curl --location --request POST 'https://api.harnmodel.com/v1/chat/completions' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{}'

多语言示例

bash

curl --location --request POST 'https://api.harnmodel.com/v1/chat/completions' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "请用一句话介绍千云开发者文档中心。"
      }
    ],
    "temperature": 0.7,
    "stream": false
  }'