原生Gemini格式

原生Gemini格式

POST /v1beta/models/{model}:generateContent

Gemini 音频生成接口。 可使用gemini-2.5-flash-preview-tts等模型

路径参数 (Path Params)

参数名	类型	必选	描述	示例
model	string	是	模型名称	gemini-2.5-flash-preview-tts

请求头 (Headers)

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

请求体 (Request Body)

Content-Type: application/json

字段	类型	必选	描述
contents	array of object	是
contents[].parts	array of object	否
contents[].parts[].text	string	否
generationConfig	object	是
generationConfig.responseModalities	array of string	是
generationConfig.speechConfig	object	是
generationConfig.speechConfig.voiceConfig	object	是
generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig	object	是
generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig.voiceName	string	是

请求体示例

{
  "contents": [
    {
      "parts": [
        {
          "text": "string"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "string"
    ],
    "speechConfig": {
      "voiceConfig": {
        "prebuiltVoiceConfig": {
          "voiceName": "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
  }
}