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));

Use the Gemini-style endpoint when your application already follows Google’s Gemini API request shape. Keep contents, parts, and generationConfig; replace the host, API key, and model ID.

Reference format: Gemini API text generation. HiLinkup supports common text generation structures; capabilities depend on the selected model.

“Gemini generateContent” is the protocol shape, not a requirement to use an overseas Gemini model. Examples use the HiLinkup platform model aliyun/kimi-k3; confirm available IDs with /v1/models.

Endpoint

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

Replace {model} with an available Gemini-compatible model ID, for example:

aliyun/kimi-k3

Headers

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

Minimal request

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]"
          }
        ]
      }
    ]
  }'

Configuration map

Google Gemini setting	HiLinkup setting
API key	HiLinkup API key
Base URL / endpoint	`https://api.hilinkup.com`, final path `/v1beta/models/{model}:generateContent`
Model	A HiLinkup model ID that supports generateContent, such as `aliyun/kimi-k3`
Auth header	`x-goog-api-key: $HILINKUP_API_KEY`

Gemini does not use /v1/chat/completions. If a client asks for a full endpoint, use https://api.hilinkup.com/v1beta/models/{model}:generateContent.

Authorizations

x-goog-api-key

string

header

required

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

Path Parameters

model

string

required

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

Body

application/json

contents

object[]

required

Show child attributes

Response

200

Gemini generateContent 结果

Last modified on August 12, 2026

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 basics

Endpoints

Endpoint

Headers

Minimal request

Configuration map

Authorizations

Path Parameters

Body

Response

​Endpoint

​Headers

​Minimal request

​Configuration map

Authorizations

Path Parameters

Body

Response

Endpoint

Headers

Minimal request

Configuration map