Gemini原生格式

Gemini原生格式

POST /v1beta/models/{model}:generateContent/

Gemini 图片生成

路径参数 (Path Params)

参数名	类型	必选	描述	示例
model	string	是	模型名称	gemini-3-pro-image-preview

请求头 (Headers)

参数名	类型	必选	描述	示例
Authorization	string	否	鉴权令牌	Bearer ********************

请求体 (Request Body)

Content-Type: application/json

字段	类型	必选	描述
contents	array of object	是
contents[].role	string	否
contents[].parts	array of object	否
contents[].parts[].text	string	否
generationConfig	object	是
generationConfig.thinkingConfig	object	是
generationConfig.thinkingConfig.includeThoughts	boolean	是	是否返回思考内容
generationConfig.responseModalities	array of string	是
generationConfig.imageConfig	object	是
generationConfig.imageConfig.aspectRatio	string	是
generationConfig.imageConfig.imageSize	string	是

请求体示例

{
  "contents": [
    {
      "role": "string",
      "parts": [
        {
          "text": "string"
        }
      ]
    }
  ],
  "generationConfig": {
    "thinkingConfig": {
      "includeThoughts": true
    },
    "responseModalities": [
      "string"
    ],
    "imageConfig": {
      "aspectRatio": "string",
      "imageSize": "string"
    }
  }
}

返回响应 (Responses)

200 - 成功

字段	类型	描述
candidates	array of object
candidates[].content	object
candidates[].content.role	string
candidates[].content.parts	array of object
candidates[].finishReason	string
candidates[].safetyRatings	array of object
usageMetadata	object
usageMetadata.promptTokenCount	integer
usageMetadata.candidatesTokenCount	integer
usageMetadata.totalTokenCount	integer

响应示例

{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {}
        ]
      },
      "finishReason": "string",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}