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

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Retrieve voice consent

audio.voice_consents.retrieve(consent_id) -> VoiceConsent
GET
/audio/voice_consents/{consent_id}

Retrieves a voice consent recording.

Parameters
consent_id: str
Returns
class VoiceConsent: …

A consent recording used to authorize creation of a custom voice.

id: str

The consent recording identifier.

created_at: int

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

formatunixtime
language: str

The BCP 47 language tag for the consent phrase (for example, en-US).

name: str

The label provided when the consent recording was uploaded.

object: Literal["audio.voice_consent"]

The object type, which is always audio.voice_consent.

Retrieve voice consent

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
voice_consent = client.audio.voice_consents.retrieve(
    "consent_id",
)
print(voice_consent.id)
200 example
{
  "id": "cons_1234",
  "created_at": 0,
  "language": "language",
  "name": "name",
  "object": "audio.voice_consent"
}
Returns Examples
200 example
{
  "id": "cons_1234",
  "created_at": 0,
  "language": "language",
  "name": "name",
  "object": "audio.voice_consent"
}