Realtime
Create a translation client secret
Creates a short-lived Realtime translation client secret with an associated translation session configuration.
Request Body
Create a client secret with the given translation session configuration.
expires_after
OpenAI.RealtimeTranslationClientSecretCreateRequestExpiresAfter
anchor
enum
session
OpenAI.RealtimeTranslationSessionCreateRequest
required
Realtime translation session configuration. Translation sessions stream source audio in and translated audio plus transcript deltas out continuously.
model
string
required
The Realtime translation model used for this session.
audio
OpenAI.RealtimeTranslationSessionCreateRequestAudio
input
OpenAI.RealtimeTranslationSessionCreateRequestAudioInput
transcription
OpenAI.RealtimeTranslationSessionCreateRequestAudioInputTranscription | null
noise_reduction
OpenAI.RealtimeTranslationSessionCreateRequestAudioInputNoiseReduction | null
type
enum
required
Type of noise reduction. near_field is for close-talking microphones such as headphones, far_field is for far-field microphones such as laptop or conference room microphones.
output
OpenAI.RealtimeTranslationSessionCreateRequestAudioOutput
Responses
The request has succeeded.
Body
value
string
required
The generated client secret value.
expires_at
integer
required
Expiration timestamp for the client secret, in seconds since epoch.
session
OpenAI.RealtimeTranslationSession
required
A Realtime translation session. Translation sessions continuously translate input audio into the configured output language.
id
string
required
Unique identifier for the session that looks like sess_1234567890abcdef.
type
enum
required
The session type. Always translation for Realtime translation sessions.
expires_at
integer
required
Expiration timestamp for the session, in seconds since epoch.
model
string
required
The Realtime translation model used for this session. This field is set at session creation and cannot be changed with session.update.
audio
OpenAI.RealtimeTranslationSessionAudio
required
input
OpenAI.RealtimeTranslationSessionAudioInput
transcription
OpenAI.RealtimeTranslationSessionAudioInputTranscription | null
noise_reduction
OpenAI.RealtimeTranslationSessionAudioInputNoiseReduction | null
type
enum
required
Type of noise reduction. near_field is for close-talking microphones such as headphones, far_field is for far-field microphones such as laptop or conference room microphones.
output
OpenAI.RealtimeTranslationSessionAudioOutput
Request
curl -X POST https://api.openai.com/v1/realtime/translations/client_secrets \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"expires_after": {
"anchor": "created_at",
"seconds": 600
},
"session": {
"model": "gpt-realtime-translate",
"audio": {
"input": {
"transcription": {
"model": "gpt-realtime-whisper"
},
"noise_reduction": null
},
"output": {
"language": "es"
}
}
}
}'Response
{
"value": "ek_68af296e8e408191a1120ab6383263c2",
"expires_at": 1756310470,
"session": {
"id": "sess_C9CiUVUzUzYIssh3ELY1d",
"type": "translation",
"expires_at": 1756310470,
"model": "gpt-realtime-translate",
"audio": {
"input": {
"transcription": {
"model": "gpt-realtime-whisper"
},
"noise_reduction": null
},
"output": {
"language": "es"
}
}
}
}