SpyBara
Go Premium

resources/audio/subresources/voices/methods/create/index.md 2026-09-30 22:59 UTC to 2026-10-01 22:59 UTC

This page contains 70 additions and 13 deletions.

2026
Thu 1 22:59 Thu 8 23:01

For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.

Create voice

post /audio/voices

Creates a voice from a text prompt or from a consent recording and an audio sample.

For prompt-based creation, send type: "prompt" with a name and prompt as JSON or multipart form data. For creation from an audio sample, send type: "audio_sample" with a name, audio_sample, and consent recording ID as multipart form data. The type defaults to audio_sample when omitted.

Returns the saved voice's metadata. Voices created from text prompts are supported only in Live, not in Realtime or the speech endpoint. The response does not include preview audio.

Body Parameters

  • name: string

    The name of the new voice.

  • prompt: string

    A description of the desired voice. Must not contain only whitespace.

  • type: "prompt"

    Set to prompt to create a voice from a text description.

    • "prompt"

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

    The voice creation model to use. Defaults to auto.

    • string

    • "auto" or "2026-10-01"

      The voice creation model to use. Defaults to auto.

      • "auto"

      • "2026-10-01"

  • script_hint: optional string

    Optional text for the voice to speak during creation. If omitted, a script is generated from the prompt. Must not be blank after trimming whitespace; scripts that are too short are rejected.

Returns

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

    A custom voice that can be used for audio output. Voices created from text prompts are supported only in Live.

    • id: string

      The voice identifier, which can be referenced in API endpoints.

    • created_at: number

      The Unix timestamp (in seconds) for when the voice was created.

    • name: string

      The name of the voice.

    • object: "audio.voice"

      The object type, which is always audio.voice.

      • "audio.voice"

    • type: "audio_sample" or "prompt"

      How the voice was created. Voices created from text prompts are supported only in Live.

      • "audio_sample"

      • "prompt"

Example

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"
        }'

Response

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

Example

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"
  }'