创建对话补全

POST

chat

completions

创建对话补全

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

import requests

url = "https://api.hilinkup.com/v1/chat/completions"

payload = {
    "model": "aliyun/kimi-k3",
    "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',
    messages: [{role: 'user', content: '用一句话介绍 HiLinkup。'}]
  })
};

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

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1782972000,
  "model": "aliyun/kimi-k3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "流式响应会在模型生成过程中逐段返回内容。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 20,
    "total_tokens": 44
  }
}

根据消息列表创建模型响应。模型能力决定是否支持图片输入、工具调用和高级参数。

下面的代码块是完整请求，可以直接复制运行。先把 HILINKUP_API_KEY 设置为你的真实密钥，并把 model 替换成 /v1/models 返回的模型 ID。

string

必填

模型 ID。使用 GET /v1/models 获取当前可用值。

array

必填

对话消息列表。每条消息至少包含 role 和 content。

boolean

默认值:"false"

是否通过 Server-Sent Events 流式返回内容。

number

控制输出随机性。不同模型接受的范围可能不同。

integer

限制本次生成的最大 Token 数。部分模型可能使用其他等价字段。

array

提供模型可以调用的工具定义。仅对支持工具调用的模型生效。

完整请求示例

非流式
流式
工具调用

curl https://api.hilinkup.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HILINKUP_API_KEY" \
  -d '{
    "model": "aliyun/kimi-k3",
    "messages": [
      {
        "role": "system",
        "content": "你是一个简洁的中文助手。"
      },
      {
        "role": "user",
        "content": "解释什么是流式响应。"
      }
    ],
    "temperature": 0.7,
    "top_p": 1,
    "max_tokens": 512,
    "stream": false
  }'

curl https://api.hilinkup.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HILINKUP_API_KEY" \
  -d '{
    "model": "aliyun/kimi-k3",
    "messages": [
      {
        "role": "user",
        "content": "用三句话介绍 HiLinkup。"
      }
    ],
    "temperature": 0.3,
    "max_tokens": 512,
    "stream": true
  }'

curl https://api.hilinkup.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HILINKUP_API_KEY" \
  -d '{
    "model": "aliyun/kimi-k3",
    "messages": [
      {
        "role": "user",
        "content": "北京现在适合带伞吗？"
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "查询城市天气",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {
                "type": "string",
                "description": "城市名称，例如 Beijing"
              }
            },
            "required": ["city"]
          }
        }
      }
    ],
    "tool_choice": "auto",
    "temperature": 0.2,
    "max_tokens": 512
  }'

tools、图片输入、结构化输出和部分高级参数只在支持对应能力的模型上生效。如果普通文本请求成功但工具调用失败，优先检查模型能力和客户端能力开关。

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1782972000,
  "model": "aliyun/kimi-k3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "流式响应会在模型生成过程中逐段返回内容。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 20,
    "total_tokens": 44
  }
}

示例响应用于说明字段结构，ID、时间、Token 用量和模型返回内容以实际请求为准。

授权

Authorization

string

header

必填

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

请求体

application/json

model

string

必填

模型 ID。使用 GET /v1/models 获取当前可用值。

messages

object[]

必填

对话消息列表，每条消息至少包含 role 和 content。

Show child attributes

stream

boolean

默认值:false

是否通过 Server-Sent Events 流式返回内容。

temperature

number

控制输出随机性。不同模型接受的范围可能不同。

max_tokens

integer

限制本次生成的最大 Token 数。

响应

200 - application/json

对话补全结果

string

object

string

created

integer

model

string

choices

object[]

Show child attributes

usage

object

Show child attributes

最后修改于 2026年8月12日

创建对话补全

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

import requests

url = "https://api.hilinkup.com/v1/chat/completions"

payload = {
    "model": "aliyun/kimi-k3",
    "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',
    messages: [{role: 'user', content: '用一句话介绍 HiLinkup。'}]
  })
};

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

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1782972000,
  "model": "aliyun/kimi-k3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "流式响应会在模型生成过程中逐段返回内容。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 20,
    "total_tokens": 44
  }
}

API 基础

常用 API

完整请求示例

授权

请求体

响应

​完整请求示例

授权

请求体

响应

完整请求示例