Responses

POST

responses

创建 Responses 响应

curl --request POST \
  --url https://api.hilinkup.com/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "aliyun/kimi-k3",
  "input": "用一句话介绍 HiLinkup"
}
'

import requests

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

payload = {
    "model": "aliyun/kimi-k3",
    "input": "用一句话介绍 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', input: '用一句话介绍 HiLinkup'})
};

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

Responses 适合新项目或需要统一文本、工具、推理与多模态输入的应用。若你的代码、SDK 或第三方应用已经按 OpenAI Responses API 编写，通常只需要替换 API Key、Base URL 和模型 ID。

参考官方格式：OpenAI Responses API。HiLinkup 保持请求结构兼容，但具体参数是否生效取决于模型能力和账户权限。

本页示例使用 HiLinkup 平台模型 aliyun/kimi-k3。实际可用模型以 GET /v1/models 和控制台展示为准。

Endpoint

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

Headers

Content-Type: application/json
Authorization: Bearer $HILINKUP_API_KEY

最小请求

curl https://api.hilinkup.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HILINKUP_API_KEY" \
  -d '{
    "model": "aliyun/kimi-k3",
    "input": "Tell me a three sentence bedtime story about a unicorn."
  }'

多轮输入

当你需要携带角色、上下文或多段输入时，使用数组形式的 input。

curl https://api.hilinkup.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HILINKUP_API_KEY" \
  -d '{
    "model": "aliyun/kimi-k3",
    "input": [
      {
        "role": "developer",
        "content": "You are a precise API assistant."
      },
      {
        "role": "user",
        "content": "Summarize the difference between Chat Completions and Responses."
      }
    ]
  }'

SDK 配置

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_HILINKUP_API_KEY",
    base_url="https://api.hilinkup.com/v1",
)

response = client.responses.create(
    model="aliyun/kimi-k3",
    input="Write a one paragraph release note for an API gateway.",
)

print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.HILINKUP_API_KEY,
  baseURL: "https://api.hilinkup.com/v1",
});

const response = await client.responses.create({
  model: "aliyun/kimi-k3",
  input: "Write a one paragraph release note for an API gateway.",
});

console.log(response.output_text);

迁移检查

原 OpenAI 配置	HiLinkup 配置
`https://api.openai.com/v1`	`https://api.hilinkup.com/v1`
OpenAI API Key	HiLinkup API Key
OpenAI 模型 ID	`/v1/models` 返回的可用模型 ID

不要把 Base URL 填成 https://api.hilinkup.com/v1/responses。SDK 的 Base URL 只填写到 /v1，具体路径由 SDK 拼接。

常见问题

Responses 和 Chat Completions 应该选哪个？

新项目优先使用 Responses。已有聊天客户端、OpenAI 兼容插件或旧 SDK 配置通常继续使用 Chat Completions，迁移成本更低。

返回 404 或路径不存在

检查最终请求地址是否为 /v1/responses。如果客户端自动拼路径，Base URL 应填写 https://api.hilinkup.com/v1。

某些推理或工具参数没有效果

先确认目标模型是否支持这些能力。不同模型对推理、工具、图片和结构化输出的支持范围不同。

授权

Authorization

string

header

必填

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

请求体

application/json

model

string

必填

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

input

string

必填

发送给模型的输入内容。

stream

boolean

默认值:false

是否流式返回。

响应

200

Responses 结果

最后修改于 2026年8月12日

创建 Responses 响应

curl --request POST \
  --url https://api.hilinkup.com/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "aliyun/kimi-k3",
  "input": "用一句话介绍 HiLinkup"
}
'

import requests

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

payload = {
    "model": "aliyun/kimi-k3",
    "input": "用一句话介绍 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', input: '用一句话介绍 HiLinkup'})
};

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

API 基础

常用 API

Endpoint

Headers

最小请求

多轮输入

SDK 配置

迁移检查

常见问题

授权

请求体

响应

​Endpoint

​Headers

​最小请求

​多轮输入

​SDK 配置

​迁移检查

​常见问题

授权

请求体

响应

Endpoint

Headers

最小请求

多轮输入

SDK 配置

迁移检查

常见问题