1. Gemini v1beta
梧柏API使用文档
WHBAI · Google Gemini 原生
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • Gemini v1beta
    • Gemini 原生内容生成
      POST
    • 视频理解-url [原生格式] 开发中
      POST
    • 文本生成-流
      POST
    • 文本生成+思考-流
      POST
    • 图片生成
      POST
    • 图片生成 gemini-2.5-flash-image 控制宽高比
      POST
    • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
      POST
    • 图片编辑
      POST
    • 谷歌联网搜索
      POST
    • TTS 文本转语音
      POST
    • 文本生成 gemini-3-pro-preview:generateContent
      POST
    • Imagen 生成图片
      POST
    • Imagen 4 开发中
      POST
    • gemini-tts文本转语音
      POST
    • 文本嵌入
      POST
    • gemini-3.1-flash-lite-image
      POST
  • 数据模型
    • PostV1betaModelsModeNameGenerateContentRequest
    • PostV1betaModelsGemini25FlashImageGenerateContentRequest
    • PostV1betaModelsGemini3ProImagePreviewGenerateContentRequest
    • PostV1betaModelsGemini20FlashExpImageGenerationGenerateContentRequest
    • PostV1betaModelsGemini25FlashPreviewTtsGenerateContentRequest
    • PostV1betaModelsImagen40UltraGenerate001PredictRequest
    • PostV1betaModelsImagen40Generate001PredictRequest
    • PostV1betaModelsGemini25ProPreviewTtsGenerateContentRequest
    • PostV1betaModelsGeminiEmbedding001EmbedContentRequest
    • Gemini 3.1 Flash-Lite Image generateContent Request
    • PostV1betaModelsGemini31FlashLiteImageGenerateContentResponse
    • NewApiError
  1. Gemini v1beta

gemini-tts文本转语音

POST
/v1beta/models/gemini-2.5-pro-preview-tts:generateContent
官方文档:https://ai.google.dev/gemini-api/docs/text-generation?hl=zh-cn#multi-turn-conversations

网站中的模型与调用示例#

gemini-tts文本转语音#

官方文档:https://ai.google.dev/gemini-api/docs/text-generation?hl=zh-cn#multi-turn-conversations

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "contents": {
      "items": {
        "properties": {
          "parts": {
            "items": {
              "properties": {
                "text": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "generationConfig": {
      "properties": {
        "responseModalities": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "speechConfig": {
          "properties": {
            "voiceConfig": {
              "description": "指定的声音角色的名字",
              "properties": {
                "prebuiltVoiceConfig": {
                  "properties": {
                    "voiceName": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "voiceName"
                  ],
                  "type": "object"
                }
              },
              "required": [
                "prebuiltVoiceConfig"
              ],
              "type": "object"
            }
          },
          "required": [
            "voiceConfig"
          ],
          "type": "object"
        }
      },
      "required": [
        "responseModalities",
        "speechConfig"
      ],
      "type": "object"
    }
  },
  "required": [
    "contents",
    "generationConfig"
  ]
}

请求示例 · 示例#

{
  "contents": [
    {
      "parts": [
        {
          "text": "Say cheerfully: Have a wonderful day!"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "AUDIO"
    ],
    "speechConfig": {
      "voiceConfig": {
        "prebuiltVoiceConfig": {
          "voiceName": "Kore"
        }
      }
    }
  }
}

响应示例 · 成功示例#

源文档已省略示例内容。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Query 参数

Header 参数

Body 参数application/json

示例
{
    "contents": [
        {
            "parts": [
                {
                    "text": "Say cheerfully: Have a wonderful day!"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "AUDIO"
        ],
        "speechConfig": {
            "voiceConfig": {
                "prebuiltVoiceConfig": {
                    "voiceName": "Kore"
                }
            }
        }
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff '/v1beta/models/gemini-2.5-pro-preview-tts:generateContent?key={{YOUR_API_KEY}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "parts": [
                {
                    "text": "Say cheerfully: Have a wonderful day!"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "AUDIO"
        ],
        "speechConfig": {
            "voiceConfig": {
                "prebuiltVoiceConfig": {
                    "voiceName": "Kore"
                }
            }
        }
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "candidates": [
        {
            "content": {
                "role": "model",
                "parts": [
                    {
                        "inlineData": {
                            "mimeType": "audio/L16;codec=pcm;rate=24000",
                            "data": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA..."
                        }
                    }
                ]
            },
            "finishReason": "STOP",
            "index": 0,
            "safetyRatings": []
        }
    ],
    "promptFeedback": {
        "safetyRatings": []
    },
    "usageMetadata": {
        "promptTokenCount": 9,
        "candidatesTokenCount": 51,
        "totalTokenCount": 60,
        "thoughtsTokenCount": 0,
        "promptTokensDetails": [
            {
                "modality": "TEXT",
                "tokenCount": 9
            }
        ]
    },
    "modelVersion": "gemini-2.5-pro-preview-tts",
    "responseId": "nXxoaf7mPM6j_uMPyICzkQo"
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:06
上一页
Imagen 4 开发中
下一页
文本嵌入
Built with