Gemini generateContent

POST

v1beta

models

{model}

:generateContent

Gemini 兼容生成内容

curl --request POST \
  --url https://api.hilinkup.com/v1beta/models/{model}:generateContent \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: <api-key>' \
  --data '
{
  "contents": [
    {
      "parts": [
        {
          "text": "用一句话介绍 HiLinkup。"
        }
      ]
    }
  ]
}
'

import requests

url = "https://api.hilinkup.com/v1beta/models/{model}:generateContent"

payload = { "contents": [{ "parts": [{ "text": "用一句话介绍 HiLinkup。" }] }] }
headers = {
    "x-goog-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-goog-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({contents: [{parts: [{text: '用一句话介绍 HiLinkup。'}]}]})
};

fetch('https://api.hilinkup.com/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Gemini 风格接口适合已经按 Google Gemini API 开发的应用。接入时保留 contents、parts、generationConfig 等请求结构，只替换域名、API Key 和模型 ID。

参考官方格式：Gemini API text generation。HiLinkup 兼容常用文本生成结构；模型能力以账户可用模型为准。

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

Endpoint

POST https://api.hilinkup.com/v1beta/models/{model}:generateContent

其中 {model} 替换为 HiLinkup 可用且支持 generateContent 协议的模型 ID，例如：

aliyun/kimi-k3

Headers

Content-Type: application/json
x-goog-api-key: $HILINKUP_API_KEY

最小请求

curl "https://api.hilinkup.com/v1beta/models/aliyun/kimi-k3:generateContent" \
  -H "x-goog-api-key: $HILINKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Find the race condition in this multi-threaded C++ snippet: [code here]"
          }
        ]
      }
    ]
  }'

带生成参数

curl "https://api.hilinkup.com/v1beta/models/aliyun/kimi-k3:generateContent" \
  -H "x-goog-api-key: $HILINKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Write a short product FAQ for an AI API gateway."
          }
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.3,
      "maxOutputTokens": 512
    }
  }'

配置映射

Google Gemini 官方配置	HiLinkup 配置
API Key	HiLinkup API Key
Base URL / Endpoint	`https://api.hilinkup.com`，最终路径为 `/v1beta/models/{model}:generateContent`
Model	HiLinkup 可用且支持 generateContent 协议的模型 ID，例如 `aliyun/kimi-k3`
Auth header	`x-goog-api-key: $HILINKUP_API_KEY`

Gemini 接口路径不是 /v1/chat/completions。如果客户端要求填写完整接口地址，应填写 https://api.hilinkup.com/v1beta/models/{model}:generateContent。

常见问题

404 或模型路径错误

检查 URL 中是否包含 /v1beta/models/，并且模型 ID 后面紧跟 :generateContent。不要在模型 ID 前额外添加 models/ 两次。

401 或 403

确认使用 HiLinkup API Key，并通过 x-goog-api-key 传递。不要把 Key 放在 OpenAI 的 Authorization: Bearer 头里。

OpenAI 客户端可以直接调用 Gemini 路径吗？

不建议。OpenAI 客户端会拼接 OpenAI 风格路径。Gemini 风格调用应使用支持自定义 HTTP 请求或 Gemini Provider 的客户端。

授权

x-goog-api-key

string

header

必填

Gemini 兼容端点使用 x-goog-api-key 头携带 API Key。

路径参数

model

string

必填

provider-qualified 模型 ID，例如 aliyun/kimi-k3。

请求体

application/json

contents

object[]

必填

Show child attributes

响应

200

Gemini generateContent 结果

最后修改于 2026年8月12日

Gemini 兼容生成内容

curl --request POST \
  --url https://api.hilinkup.com/v1beta/models/{model}:generateContent \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: <api-key>' \
  --data '
{
  "contents": [
    {
      "parts": [
        {
          "text": "用一句话介绍 HiLinkup。"
        }
      ]
    }
  ]
}
'

import requests

url = "https://api.hilinkup.com/v1beta/models/{model}:generateContent"

payload = { "contents": [{ "parts": [{ "text": "用一句话介绍 HiLinkup。" }] }] }
headers = {
    "x-goog-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-goog-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({contents: [{parts: [{text: '用一句话介绍 HiLinkup。'}]}]})
};

fetch('https://api.hilinkup.com/v1beta/models/{model}:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

API 基础

常用 API

Endpoint

Headers

最小请求

带生成参数

配置映射

常见问题

授权

路径参数

请求体

响应

​Endpoint

​Headers

​最小请求

​带生成参数

​配置映射

​常见问题

授权

路径参数

请求体

响应

Endpoint

Headers

最小请求

带生成参数

配置映射

常见问题