Gemini 3.1 Flash TTS Preview 语音合成

curl --request POST \
  --url https://api.shuyou.ai/v1/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-3.1-flash-tts-preview",
  "function": "audio",
  "input": {
    "prompt": "Say cheerfully: Have a wonderful day!",
    "style_instructions": "用温暖、轻快的语气朗读以下内容。",
    "voice": "Kore",
    "language": "en-US",
    "output_format": "mp3"
  },
  "webhook": "https://api.shuyou.ai/backend/api/callback"
}
'

{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

POST

predictions

curl --request POST \
  --url https://api.shuyou.ai/v1/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-3.1-flash-tts-preview",
  "function": "audio",
  "input": {
    "prompt": "Say cheerfully: Have a wonderful day!",
    "style_instructions": "用温暖、轻快的语气朗读以下内容。",
    "voice": "Kore",
    "language": "en-US",
    "output_format": "mp3"
  },
  "webhook": "https://api.shuyou.ai/backend/api/callback"
}
'

{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

文本（`input.prompt`）

必填。待合成文本（最多 32,000 字符）。可在文本中使用下列标记增强表现力：

标记	效果
`[sigh]`	叹气
`[laughing]`	笑声
`[whispering]`	低语
`[shouting]`	喊叫
`[extremely fast]`	极快语速

风格指令（`input.style_instructions`）

可选（最多 1,000 字符）。用自然语言描述语气、语速、口音与情感。默认值：Say the following.

音色（`input.voice`）

可选。默认 Kore。

`voice`
`Achernar`
`Achird`
`Algenib`
`Algieba`
`Alnilam`
`Aoede`
`Autonoe`
`Callirrhoe`
`Charon`
`Despina`
`Enceladus`
`Erinome`
`Fenrir`
`Gacrux`
`Iapetus`
`Kore`
`Laomedeia`
`Leda`
`Orus`
`Pulcherrima`
`Puck`
`Rasalgethi`
`Sadachbia`
`Sadaltager`
`Schedar`
`Sulafat`
`Umbriel`
`Vindemiatrix`
`Zephyr`
`Zubenelgenubi`

语种（`input.language`）

可选 BCP-47 语言代码。默认 en-US。

代码	代码	代码	代码
`af-ZA`	`am-ET`	`ar-001`	`ar-EG`
`az-AZ`	`be-BY`	`bg-BG`	`bn-BD`
`ca-ES`	`ceb-PH`	`cmn-CN`	`cmn-tw`
`cs-CZ`	`da-DK`	`de-DE`	`el-GR`
`en-AU`	`en-GB`	`en-IN`	`en-US`
`es-419`	`es-ES`	`es-MX`	`et-EE`
`eu-ES`	`fa-IR`	`fi-FI`	`fil-PH`
`fr-CA`	`fr-FR`	`gl-ES`	`gu-IN`
`he-IL`	`hi-IN`	`hr-HR`	`ht-HT`
`hu-HU`	`hy-AM`	`id-ID`	`is-IS`
`it-IT`	`ja-JP`	`jv-JV`	`ka-GE`
`kn-IN`	`ko-KR`	`kok-IN`	`la-VA`
`lb-LU`	`lo-LA`	`lt-LT`	`lv-LV`
`mai-IN`	`mg-MG`	`mk-MK`	`ml-IN`
`mn-MN`	`mr-IN`	`ms-MY`	`my-MM`
`nb-NO`	`ne-NP`	`nl-NL`	`nn-NO`
`or-IN`	`pa-IN`	`pl-PL`	`ps-AF`
`pt-BR`	`pt-PT`	`ro-RO`	`ru-RU`
`sd-IN`	`si-LK`	`sk-SK`	`sl-SI`
`sq-AL`	`sr-RS`	`sv-SE`	`sw-KE`
`ta-IN`	`te-IN`	`th-TH`	`tr-TR`
`uk-UA`	`ur-PK`	`vi-VN`

输出格式（`input.output_format`）

可选。默认 mp3。

取值	说明
`mp3`	MP3 音频
`wav`	WAV 音频
`ogg_opus`	Ogg Opus 音频

授权

Authorization

string

header

必填

Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

enum<string>

默认值:gemini-3.1-flash-tts-preview

必填

模型 ID。本接口使用 gemini-3.1-flash-tts-preview。

可用选项:

gemini-3.1-flash-tts-preview

示例:

"gemini-3.1-flash-tts-preview"

function

enum<string>

必填

任务类型。文本转语音须为 audio。

可用选项:

audio

示例:

"audio"

input

object

必填

Show child attributes

webhook

string<uri>

可选。任务完成、失败或取消时的 HTTPS 回调地址。

响应

异步任务已创建

data

object

必填

Show child attributes

Gemini 2.5 Flash Image 图像生成（Nano Banana）Inworld TTS 1.5 Mini 语音合成

​文本（input.prompt）

​风格指令（input.style_instructions）

​音色（input.voice）

​语种（input.language）

​输出格式（input.output_format）

授权

请求体

响应

文本（`input.prompt`）

风格指令（`input.style_instructions`）

音色（`input.voice`）

语种（`input.language`）

输出格式（`input.output_format`）