Skip to main content
POST
/
v1beta
/
models
/
{model}
:generateContent
curl --request POST \ --url https://model-api.skyengine.com.cn/v1beta/models/{model}:generateContent \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "contents": [ { "parts": [ { "text": "请介绍一下人工智能的发展历史" } ] } ] } '
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "你好，请介绍一下你自己"
          }
        ],
        "role": "user"
      },
      "finishReason": "FINISH_REASON_UNSPECIFIED",
      "index": 123,
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "HARM_PROBABILITY_UNSPECIFIED",
          "blocked": true
        }
      ],
      "citationMetadata": {
        "citationSources": [
          {
            "startIndex": 123,
            "endIndex": 123,
            "uri": "<string>",
            "license": "<string>"
          }
        ]
      },
      "tokenCount": 123
    }
  ],
  "promptFeedback": {
    "blockReason": "BLOCK_REASON_UNSPECIFIED",
    "safetyRatings": [
      {
        "category": "<string>",
        "probability": "HARM_PROBABILITY_UNSPECIFIED",
        "blocked": true
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "cachedContentTokenCount": 123
  },
  "modelVersion": "gemini-2.5-flash"
}

Authorizations

​
Authorization
string
header
required

ModelHub API密钥认证。在 Authorization HTTP Header 中包含您的 API-Key，格式为 Bearer {API_KEY}

Path Parameters

​
model
string
required

模型名称，如 gemini-2.5-flash

Example:

"gemini-2.5-flash"

Body

application/json
​
contents
object[]
required

输入内容列表，表示对话历史

Example:
[{ "parts": [{ "text": "你好，请介绍一下你自己" }] }]
​
tools
object[]

可用的工具列表

​
toolConfig
object

工具配置选项

​
safetySettings
object[]

安全设置

​
systemInstruction
object

系统指令

​
generationConfig
object

生成配置参数

Response

成功生成内容

​
candidates
object[]

生成的候选回答

​
promptFeedback
object

提示词反馈信息

​
usageMetadata
object

使用情况统计

​
modelVersion
string

使用的模型版本

Example:

"gemini-2.5-flash"