POST/v1/messages

Messages

该接口面向 Anthropic SDK/调用习惯，平台会将 Messages 请求适配到统一模型路由、计费、权限和 Responses 执行链路。非流式返回 Anthropic message 结构；流式模式返回 `message_start`、`content_block_delta`、`message_stop` 等 SSE 事件。

基础信息

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

请求参数

Header

字段

类型

必填

位置

说明

x-api-key

string

否

header

Anthropic 风格 API Key 请求头。也可以继续使用 `Authorization: Bearer sk-...`。

示例："sk-xxx"

anthropic-version

string

否

header

Anthropic SDK 常用版本头，平台允许透传。

示例："2023-06-01"

Body

字段

类型

必填

位置

说明

model

string

是

body

平台统一模型 ID。

示例："claude-4.5-sonnet"

max_tokens

integer

是

body

最大输出 token 数，对应平台内部 `max_output_tokens`。

示例：512

messages

array<object>

是

body

Anthropic 风格消息数组。`content` 可以是字符串，也可以是 text/image 内容块数组。

示例：[{"role":"user","content":"请用一句话介绍千云开发者文档中心。"}]

role

string

是

body

消息角色，例如 user / assistant。

示例："user"

content

array<object>

是

body

消息内容。文本可直接传字符串；多模态可传内容块数组。

示例：[{"type":"text","text":"你好"}]

system

string

否

body

系统级指令，可传字符串或 text 内容块数组。

示例："使用简洁中文回答。"

stream

boolean

否

body

是否使用 SSE 流式输出。

示例：false

temperature

number

否

body

采样温度。

示例：0.7

top_p

number

否

body

Top-p 采样。

示例：1

top_k

integer

否

body

Top-k 采样参数。

示例：40

stop_sequences

array<string>

否

body

停止序列数组。

示例：["</end>"]

请求示例

json

{
  "model": "claude-4.5-sonnet",
  "max_tokens": 512,
  "system": "使用简洁中文回答。",
  "messages": [
    {
      "role": "user",
      "content": "请用一句话介绍千云开发者文档中心。"
    }
  ],
  "stream": false
}

响应示例

json

{
  "id": "msg_resp_123",
  "type": "message",
  "role": "assistant",
  "model": "claude-4.5-sonnet",
  "content": [
    {
      "type": "text",
      "text": "千云开发者文档中心提供统一模型接入、调试与管理说明。"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 26,
    "output_tokens": 24
  }
}

错误码

HTTP	code	说明
400	`invalid_request_error`	请求体结构不合法、缺少 `model` / `max_tokens` / `messages` 等必填参数。
401	`authentication_error`	缺少或传错 API Key。
403	`permission_error`	当前 API Key 没有访问该模型的权限。
429	`rate_limit_error`	触发网关或上游限流。
502	`api_error`	平台计费、路由或上游渠道调用失败。

在线调试

Playground · 浏览器直连网关

Messages

兼容 Anthropic Messages 协议，支持 `x-api-key` 接入与 `stream=true` 的 SSE 返回。

Base URL Token / API Key

JSON 请求体

提示：Anthropic SDK 可使用 `x-api-key`；平台也兼容 `Authorization: Bearer sk-...`。

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

json

尚未发起请求。

bash

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

多语言示例

bash

curl --location --request POST 'https://api.harnmodel.com/v1/messages' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "claude-4.5-sonnet",
    "max_tokens": 512,
    "system": "使用简洁中文回答。",
    "messages": [
      {
        "role": "user",
        "content": "请用一句话介绍千云开发者文档中心。"
      }
    ],
    "stream": false
  }'