Skip to main content
POST
/
v1beta
/
models
/
{model}
:generateContent
Gemini 风格生成
curl --request POST \
  --url https://api.qhaigc.net/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "<string>"
        }
      ]
    }
  ],
  "generationConfig": {
    "temperature": 123,
    "maxOutputTokens": 123
  },
  "safetySettings": [
    {}
  ],
  "tools": [
    {}
  ]
}
'
{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>"
          }
        ]
      },
      "finishReason": "<string>"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123
  }
}

Base URL

  • https://api.qhaigc.net
  • https://api-hk.qhaigc.net

Endpoint

POST /v1beta/models/{model}:generateContent 示例模型:gemini-2.5-progemini-2.5-flash

鉴权与请求头

Header是否必填说明
Authorization: Bearer <YOUR_API_KEY>启航 API Key
Content-Type: application/jsonJSON 请求体

请求体格式(Gemini 原生)

字段类型必填说明
contentsarray对话内容,包含 roleparts
generationConfigobject生成参数(如 temperaturemaxOutputTokens
safetySettingsarray安全策略
toolsarray工具定义

请求示例

curl --location --request POST 'https://api.qhaigc.net/v1beta/models/gemini-2.5-pro:generateContent' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请用简洁中文解释 RAG 的工作流程"
        }
      ]
    }
  ],
  "generationConfig": {
    "temperature": 0.4,
    "maxOutputTokens": 512
  }
}'

响应结构示例

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "RAG 的流程通常分为检索、增强、生成三步..."
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 18,
    "candidatesTokenCount": 76,
    "totalTokenCount": 94
  }
}

官方格式参考

相关页面

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

model
string
required

模型名称,如 gemini-2.5-pro

Body

application/json
contents
object[]
required
generationConfig
object
safetySettings
object[]
tools
object[]

Response

200 - application/json

成功响应

candidates
object[]
usageMetadata
object