OpenAI 创建自定义音色

创建音色

post /audio/voices

根据文本提示，或根据授权录音及音频样本创建音色。

基于提示创建时，以JSON或multipart表单发送type: "prompt"、name及prompt。基于音频样本创建时，以multipart表单发送type: "audio_sample"、name、audio_sample及consent录音ID。省略type时默认为audio_sample。

返回已保存音色的元数据。从文本提示创建的音色仅Live支持，Realtime及speech端点不支持。响应不包含试听音频。

请求体参数

媒体类型为 application/json。

• name: string

新音色名称，长度为 1 至 256 个字符。

• prompt: string

所需音色的描述，不能只包含空白字符，长度为 1 至 2000 个字符。

• type: "prompt"

设为prompt，从文本描述创建音色。

• "prompt"

• model: optional string or "auto" or "2026-10-08"

创建音色使用的模型，默认为auto。

• string

• "auto" or "2026-10-08"

创建音色使用的模型，默认为auto。

• "auto"

• "2026-10-08"

• script_hint: optional string

可选文本，供音色在创建时朗读。省略时会根据提示生成朗读稿。去除首尾空白后不能为空；长度须为 1 至 2000 个字符，过短的朗读稿会被拒绝。

返回值

• Voice object { id, created_at, name, 3 more }

可用于音频输出的自定义音色。从文本提示创建的音色仅Live支持。

• id: string

可在API端点中引用的音色标识。

• created_at: integer（Unix 时间戳）

音色创建时的Unix时间戳，单位为秒。

• name: string

音色名称。

• object: "audio.voice"

对象类型，固定为audio.voice。

• "audio.voice"

• type: "audio_sample" or "prompt"

音色的创建方式。

• "audio_sample"

• "prompt"

• prompt: optional string

创建音色时的原始文本提示。保存了提示的提示生成音色会包含此字段；音频样本音色及未保存提示的旧音色会省略。

示例

## [中文] 发送POST请求；将示例API凭证及呼叫标识替换为应用使用的值。
curl https://api.openai.com/v1/audio/voices \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "name": "x",
          "prompt": "x",
          "type": "prompt"
        }'

响应

中文说明：以下为原文配置、命令或事件示例，字段名、枚举、标识符及数值保留。

{
  "id": "id",
  "created_at": 0,
  "name": "name",
  "object": "audio.voice",
  "type": "audio_sample",
  "prompt": "prompt"
}

示例

代码内文字译释：

• 温暖的旁白。
• 温暖、平静的旁白，吐字清晰，节奏从容。

## [中文] 发送POST请求；将示例API凭证及呼叫标识替换为应用使用的值。
curl https://api.openai.com/v1/audio/voices \
  -X POST \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "prompt",
    "name": "Warm narrator",
    "prompt": "A warm, calm narrator with a clear, measured delivery.",
    "model": "auto"
  }'