generateContent

使用指定模型生成文本内容

POST /v1beta/models/{model}:generateContent

cURL

text_only

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": "请介绍一下人工智能的发展历史"
        }
      ]
    }
  ]
}
'

200

{
  "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

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

Show child attributes

Example:

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

tools · object[]

可用的工具列表

Show child attributes

toolConfig · object

工具配置选项

Show child attributes

safetySettings · object[]

安全设置

Show child attributes

systemInstruction · object

系统指令

Show child attributes

generationConfig · object

生成配置参数

Show child attributes

Response

200

application/json

成功生成内容

candidates · object[]

生成的候选回答

Show child attributes

promptFeedback · object

提示词反馈信息

Show child attributes

usageMetadata · object

使用情况统计

Show child attributes

modelVersion · string

使用的模型版本

Example:

"gemini-2.5-flash"