01Router

Gemini 3.8 Flash TTS API

Google Gemini 3.8 Flash TTS: expressive speech in 30 voices with natural-language style control and inline vocal events like <laugh>.

Google·音频可用

低至$0.041/ 千字符$0.045省 10%

模型 IDgemini-3.8-flash-tts

在 Playground 试用查看 API
text-to-speechvoice

输入

文本

输出

音频

供应商

5 家供应商

Voice

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

近 7 天表现 · 近期请求较少，暂无统计数据。

Gemini 3.8 Flash TTS 价格

价格按单位计费；未指定供应商时，会路由到支持该参数组合且价格最低的供应商。

规格价格（美元）
全部规格
$0.041 / 千字符
1 积分$0.045省 10%

接入前先试用 Gemini 3.8 Flash TTS

写代码之前，先测试生成效果、对比各供应商价格并预估费用。

供应商
音频
预计费用

输入

prompt
voice
style_instructions

结果

空闲
生成结果会显示在这里。

本次请求的各供应商报价

输入提示词即可对比各供应商价格。

Gemini 3.8 Flash TTS 提示词示例

可直接使用的提示词，一键载入 Playground 再调整。

来源
场景分类

共 6 条提示词

Friendly sign-off

Narration

Thanks for listening today. Go make something you're proud of, and we'll see you next week!

Calm meditation intro

Wellness

Find a comfortable seat and let your shoulders drop. Breathe in slowly... and let it go. There is nowhere else you need to be right now.

Product launch voiceover

Advertising

Meet the new Aurora headphones. Twenty hours of battery, studio-grade sound, and silence the moment you need it.

Story with a laugh

Character

I told him the map was upside down. <laugh> He still insisted we were heading north.

查看更多

Gemini 3.8 Flash TTS API 文档

该模型的接口、请求字段与可直接运行的调用示例。

Base URL

https://01router.com/api/v1
llms.txt

快速开始

将 API_KEY 设为项目密钥，在服务端运行示例。示例中的媒体地址需替换为您自己的公开地址。

自动路由会选择支持当前请求的供应商。选择指定供应商，可查看它的参数约束和调用示例。

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "gemini-3.8-flash-tts",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Kore"
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

接口列表

这里只列出当前模型相关的接口，路径已包含 /api/v1。点击接口可跳转到使用说明。

POST
/api/v1/generations

创建生成任务（扣积分） · 需要 API 密钥

GET
/api/v1/generations/{id}

查询任务；运行中会向上游拉取状态 · 需要 API 密钥

POST
/api/v1/generations/{id}/cancel

取消进行中的生成任务（退还积分） · 需要 API 密钥

POST
/api/v1/quote

对所有供应商报价（不扣费，无需 Key） · 公开 · 无需密钥

GET
/api/v1/models/gemini-3.8-flash-tts

查询单个模型 · 公开 · 无需密钥

鉴权

以 Bearer Token 方式发送 API Key，费用从 Key 所属账户的积分中扣除。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
获取 API Key

输入参数

使用 Content-Type: application/json 发送请求。模型参数放在 input 中，model、provider、callback_url 放在最外层。

请求体

参数名类型必填说明
modelstring是"gemini-3.8-flash-tts"
providerstring否指定供应商；不传则自动路由到最便宜的。可选： fal | wavespeed | kie | vercel | openrouter
inputobject是模型参数，字段见下方 input 字段表。
callback_urlstring否可选的公开 HTTPS 回调地址，接收带签名的任务最终结果；仍可通过查询接口获取状态。

input · input 字段

必填字段已明确标记，其他字段省略时使用所列默认值。

参数名类型必填可选值默认值
prompt*string是——
voicestring否Kore | Puck | Charon | Fenrir | Leda | Orus | Aoede | Zephyr | Callirrhoe | Autonoe | Enceladus | Iapetus | Umbriel | Algieba | Despina | Erinome | Algenib | Rasalgethi | Laomedeia | Achernar | Alnilam | Schedar | Gacrux | Pulcherrima | Achird | Zubenelgenubi | Vindemiatrix | Sadachbia | Sadaltager | SulafatKore
style_instructions
e.g. "cheerful and friendly"; billing depends on the provider
string否——
任务回调 →

输出结果

创建任务成功不代表生成完成。保存 id，查询到 succeeded 或 failed 后，读取 outputs 或 error。示例金额仅作说明，实际费用由请求决定。

queued→processing→succeeded / failed

提交后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "gemini-3.8-flash-tts",
  "type": "audio",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Kore"
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

完成后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "gemini-3.8-flash-tts",
  "type": "audio",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Kore"
  },
  "outputs": [
    "https://example.com/output.wav"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

响应字段

参数名类型必填说明
idstring是任务 ID，用于查询或取消任务。
objectstring是generation
modelstring是gemini-3.8-flash-tts
typestring是audio
providerstring是供应商
statusstring是queued → processing → succeeded / failed。进入任一终态后停止轮询。
inputobject是模型参数，字段见下方 input 字段表。
outputsstring[]是结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。
errorstring | null是失败原因；无错误时为 null。
creditsnumber是本次请求扣除的积分。
price_usdnumber是本次请求的美元价格。
created_atstring是ISO 8601 格式的任务创建时间。
completed_atstring | null是ISO 8601 格式的完成时间；未完成时为 null。

获取结果

每隔几秒轮询，直到 status 为 succeeded 或 failed。输出链接由供应商托管，可能过期，请及时下载保存；也可以传 callback_url 接收推送。

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed。进入任一终态后停止轮询。 结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。

取消任务

取消取决于供应商支持情况和任务状态。确认取消后返回 status: failed、error: Canceled by user；不支持取消或已完成的任务返回 409 not_cancelable。

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

报价

请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "gemini-3.8-flash-tts",
  "input": {
    "prompt": "Welcome back. Let us get started.",
    "voice": "Kore"
  }
}
JSON

模型信息与参数

此公开接口返回模型参数，以及各供应商支持的参数约束和价格。

curl "https://01router.com/api/v1/models/gemini-3.8-flash-tts"

错误码

结合 HTTP 状态码和 error.message 排查。参数或认证错误需修正后再重试；生成任务失败则通过任务本身的 status 和 error 返回。

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400请求体或参数取值不合法

401缺少或无效的 API Key

402积分不足

404模型或任务不存在

409任务无法取消（已结束，或该供应商不支持取消）

429请求过于频繁，请稍后重试

502所有供应商都拒绝了任务（积分已退回）

鉴权、路由、计费与错误码详见 →

交给 AI 使用

将本模型文档交给编程助手：纯文本包含接口、输入约束、输出字段和请求示例。

打开 llms.txt

Gemini 3.8 Flash TTS 与同类模型对比

并排对比规格与起步价，选择前建议用同一提示词实测。

Gemini 3.8 Flash TTSSuno V6ElevenLabs Eleven v4ElevenLabs Eleven v4 Turbo
厂商GoogleSunoElevenLabsElevenLabs
起步价$0.041 / 千字符$0.045 / 次$0.072 / 千字符$0.036 / 千字符
输入文本文本文本文本
供应商5 家供应商4 家供应商3 家供应商3 家供应商
VoiceKore · Puck · Charon · Fenrir · Leda · Orus · Aoede · Zephyr · Callirrhoe · Autonoe · Enceladus · Iapetus · Umbriel · Algieba · Despina · Erinome · Algenib · Rasalgethi · Laomedeia · Achernar · Alnilam · Schedar · Gacrux · Pulcherrima · Achird · Zubenelgenubi · Vindemiatrix · Sadachbia · Sadaltager · Sulafat—undefined – undefinedundefined – undefined

Gemini 3.8 Flash TTS API 常见问题

Gemini 3.8 Flash TTS 有哪些音色？

内置 30 种预设音色，例如默认的 Kore，以及 Puck、Charon、Fenrir、Aoede、Zephyr 等。通过 voice 参数选择，Playground 里可以看到完整列表。

怎么控制语气和表达方式？

在 style_instructions 里描述想要的表达，比如“语速放慢、温柔舒缓”或“激动的体育解说”。文本里也可以插入 <laugh>、<sigh> 等标签。

单次请求能放多少文字？

建议单次控制在几千字符以内（各供应商上限约 8000 字符，包含风格说明）。有声书章节这类长文本请拆成多次请求。

适合用在哪些场景？

旁白配音、播客片头、有声书、在线课程、应用内语音提示，以及游戏角色配音等。

在 01router 上怎么计费？

不同供应商计费方式不同：按每 1000 字符计费，或按输入/输出 token 计费，各家价格见本页价格表；不指定供应商时会自动选最便宜的。生成失败会退还积分。

相关模型

同一个 API Key 即可调用的其他模型。

音频 · Suno

Suno V6

Suno V6 music generation: full songs with vocals or instrumentals from a description, or your own lyrics and style in custom mode. Each request returns two tracks.

低至 $0.045 / 次查看 API
音频 · ElevenLabs

ElevenLabs Eleven v4

ElevenLabs Eleven v4: expressive multilingual speech with audio tags, voice selection and delivery controls.

低至 $0.072 / 千字符查看 API
音频 · ElevenLabs

ElevenLabs Eleven v4 Turbo

ElevenLabs Eleven v4 Turbo: expressive multilingual speech with audio tags, voice selection and delivery controls.

低至 $0.036 / 千字符查看 API