Claude Messages

POST

messages

创建 Claude Messages 响应

curl --request POST \
  --url https://api.hilinkup.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "aliyun/kimi-k3",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "用一句话介绍 HiLinkup。"
    }
  ]
}
'

import requests

url = "https://api.hilinkup.com/v1/messages"

payload = {
    "model": "aliyun/kimi-k3",
    "max_tokens": 512,
    "messages": [
        {
            "role": "user",
            "content": "用一句话介绍 HiLinkup。"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'aliyun/kimi-k3',
    max_tokens: 512,
    messages: [{role: 'user', content: '用一句话介绍 HiLinkup。'}]
  })
};

fetch('https://api.hilinkup.com/v1/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Claude Messages 适合已经按 Anthropic 官方接口开发的应用。接入时保留官方请求体结构，只替换请求域名、API Key 和模型 ID。

参考官方格式：Claude Messages API。HiLinkup 兼容常用调用结构；模型、工具、图片和缓存等能力以账户可用模型为准。

“Claude Messages” 指接口协议，不代表必须选择海外 Claude 模型。示例使用 HiLinkup 平台上的中国模型 aliyun/kimi-k3；实际模型 ID 以 /v1/models 返回为准。

Endpoint

POST https://api.hilinkup.com/v1/messages

Headers

content-type: application/json
x-api-key: $HILINKUP_API_KEY
anthropic-version: 2023-06-01

如果某个第三方客户端只提供 API Key 和 Base URL 字段，Base URL 填 https://api.hilinkup.com；最终请求路径应是 /v1/messages。

最小请求

curl https://api.hilinkup.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $HILINKUP_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "aliyun/kimi-k3",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'

System prompt

Claude 风格接口使用顶层 system 字段，而不是 OpenAI Chat Completions 中的 system 消息。

curl https://api.hilinkup.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $HILINKUP_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "aliyun/kimi-k3",
    "max_tokens": 1024,
    "system": "You are a concise integration assistant.",
    "messages": [
      {
        "role": "user",
        "content": "Give me a checklist for validating an API key."
      }
    ]
  }'

流式输出

curl https://api.hilinkup.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $HILINKUP_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "aliyun/kimi-k3",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "Write three bullet points about API routing."
      }
    ]
  }'

配置映射

Anthropic 官方配置	HiLinkup 配置
API Key	HiLinkup API Key
Base URL	`https://api.hilinkup.com`，或客户端要求包含版本路径时填写 `https://api.hilinkup.com/v1`
Messages endpoint	`https://api.hilinkup.com/v1/messages`
Model	使用 HiLinkup 控制台或模型列表中支持 Claude Messages 协议的模型 ID，例如 `aliyun/kimi-k3`

Claude Messages、OpenAI Chat Completions 和 Gemini generateContent 是不同协议。不要把 Claude 请求体发送到 /v1/chat/completions。

常见问题

401 或 403

确认使用的是 HiLinkup API Key，并通过 x-api-key 发送。不要同时混用官方 Anthropic Key 和 HiLinkup Base URL。

400：messages 格式错误

Claude Messages 的 messages 只包含 user 和 assistant 对话轮次；系统提示应放在顶层 system 字段。

客户端要求填写 Anthropic Base URL

优先填写 https://api.hilinkup.com，并确认最终请求地址是 https://api.hilinkup.com/v1/messages。如果客户端不会自动拼 /v1/messages，则按客户端说明填写完整 Endpoint。

授权

Authorization

string

header

必填

在控制台创建的 API Key，格式为 Authorization: Bearer HILINKUP_API_KEY。

请求体

application/json

model

string

必填

模型 ID。

max_tokens

integer

必填

本次生成的最大 Token 数。

messages

object[]

必填

对话消息列表。

Show child attributes

stream

boolean

默认值:false

是否流式返回。

响应

200

Claude Messages 结果

最后修改于 2026年8月12日

创建 Claude Messages 响应

curl --request POST \
  --url https://api.hilinkup.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "aliyun/kimi-k3",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": "用一句话介绍 HiLinkup。"
    }
  ]
}
'

import requests

url = "https://api.hilinkup.com/v1/messages"

payload = {
    "model": "aliyun/kimi-k3",
    "max_tokens": 512,
    "messages": [
        {
            "role": "user",
            "content": "用一句话介绍 HiLinkup。"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'aliyun/kimi-k3',
    max_tokens: 512,
    messages: [{role: 'user', content: '用一句话介绍 HiLinkup。'}]
  })
};

fetch('https://api.hilinkup.com/v1/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

API 基础

常用 API

Endpoint

Headers

最小请求

System prompt

流式输出

配置映射

常见问题

授权

请求体

响应

​Endpoint

​Headers

​最小请求

​System prompt

​流式输出

​配置映射

​常见问题

授权

请求体

响应

Endpoint

Headers

最小请求

System prompt

流式输出

配置映射

常见问题