跳转到主要内容
POST
生成语音

选择音色

为了让请求可在不同提供商之间移植,请设置顶层 voice。Phaseo 会将它映射为路由到的提供商的音色;如果路由到的提供商和模型不接受该 voice,会返回 400 invalid_request_error,并附带 param: "voice"。 对于 eleven-labs/eleven-v4 和 eleven-labs/eleven-v4-turbo,可以传入任意 20 个字符的 ElevenLabs 音色库 ID,包括自定义克隆音色。按需设置 config.elevenlabs.voice_settings.stability 和 similarity_boost。Eleven v4 不支持 speed 或 voice_settings.style。

传入提供商原生音色

要使用提供商自己的音色设置而不是 voice:
  • ElevenLabs:config.elevenlabs.voice_id、config.elevenlabs.voice 或 config.elevenlabs.voiceName。
  • Google:config.google.voice_name 或 config.google.voiceName。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求体

application/json
model
string
必填
input
string
必填
models
string[]

在 model 之后按顺序尝试的可选回退模型。model 为必填项,且始终是主模型。当某次尝试以 429、500、502、503 或 504 失败时,会尝试下一项;其他错误按原样返回。最多接受 25 个模型 ID 或预设;重复项以及与 model 相同的项会被忽略。每次尝试都会作为独立请求进行验证、记录和计费,响应中的 model 字段和路由追踪会显示实际处理请求的模型。流式请求仅在发送第一个字节之前回退,视频和音乐任务仅在提交时回退。Batch、realtime 和 council 请求会拒绝 models。动态路由上设置的回退优先,且 phaseo/auto 不能与 models 一起使用。

Required array length: 1 - 25 elements
Minimum string length: 1
示例:
voice
string
speed
number
必填范围: 0.25 <= x <= 4
format
enum<string>
可用选项:
mp3,
wav,
ogg,
aac
provider
object

用于网关选择的提供商路由偏好设置。

config
object

响应

200 - audio/mpeg

音频文件

The response is of type file.

最后修改于 2026年11月16日