Gemini Omni Audio 生语音

本页由 ModelFold 文档站根据上游官方 OpenAPI 文档同步生成。接口路径、参数、示例与官方保持一致；品牌与 API 域名已替换为 ModelFold。

接口

POST /omni/audio/create

完整 URL: https://ai.modelfold.online/v1/omni/audio/create

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

同步接口。登记一个音色配置并立即返回 data.audioId，不生成音频文件。将 audioId 填入视频、角色接口的 audio_ids 使用。

返回 data.audioId，将其填入 gemini-omni-video、google/gemini-omni-flash-1-1、gemini-omni-character 的 audio_ids。

TIP

本接口免费。

相关资源

• 模型市场 — 浏览全部可用模型与能力
• 通用 API — 查看账户积分与调用情况

请求参数

请求体 (application/json)

参数	类型	必填	说明
audio_id	string	是	枚举语音ID，用于选择预设语音角色。 achernar - 女声，柔和，高音调 achird - 男声，友好，中音调 algenib - 男声，沙哑，低音调 algieba - 男声，随和，中低音调 alnilam - 男声，沉稳，中低音调 aoede - 女声，轻快，中音调 autonoe - 女声，明亮，中音调 callirrhoe - 女声，随和，中音调 charon - 男声，知性，低音调 despina - 女声，流畅，中音调 enceladus - 男声，气声，低音调 erinome - 女声，清晰，中音调 fenrir - 男声，活泼，偏年轻音调 gacrux - 女声，成熟，中音调 iapetus - 男声，清晰，中低音调 kore - 女声，干练，中音调 laomedeia - 女声，欢快，中高音调 leda - 女声，年轻，中高音调 orus - 男声，沉稳，中低音调 puck - 男声，欢快，中音调 pulcherrima - 无性别，前置感，中高音调 rasalgethi - 男声，知性，中音调 sadachbia - 男声，生动，低音调 sadaltager - 男声，博学，中音调 schedar - 男声，平稳，中低音调 sulafat - 女声，温暖，中音调 umbriel - 男声，流畅，低音调 vindemiatrix - 女声，温柔，中音调 zephyr - 女声，明亮，中高音调 zubenelgenubi - 男声，随性，中低音调 示例：achernar。
name	string	是	语音名称，最大长度为 210 字符。 示例：Adam Narrator。
voice_description	string	否	语音特征描述，用于定义声音的音色、风格、语速、情绪等，最大长度为 20000 字符。 示例：一个沉稳、清晰、富有亲和力的男性声音，适合科技产品讲解与日常对话。。
example_dialogue	string	否	对话示例，例如“你好,我是Adam”，最大长度为 120 字符。 示例：你好,我是Adam。

请求示例

curl -X POST "https://ai.modelfold.online/v1/omni/audio/create" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "audio_id": "achernar",
  "name": "achernar Narrator",
  "voice_description": "一个沉稳、清晰、富有亲和力的男性声音，适合科技产品讲解与日常对话。",
  "example_dialogue": "你好,我是achernar"
}'

{
  "audio_id": "achernar",
  "name": "achernar Narrator",
  "voice_description": "一个沉稳、清晰、富有亲和力的男性声音，适合科技产品讲解与日常对话。",
  "example_dialogue": "你好,我是achernar"
}

响应

200 — 请求成功

参数	类型	必填	说明
code	integer	否	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。
data	object	否	—
data.audioId	string	否	—
data.name	string	否	—
msg	string	否	—

{
  "code": 200,
  "msg": "success",
  "data": {
    "audioId": "a8f1c2d3e4f5...",
    "name": "温柔女声"
  }
}