Translations

Client Secrets

Create translation client secret

post /realtime/translations/client_secrets

Create a Realtime translation client secret with an associated translation session configuration.

Client secrets are short-lived tokens that can be passed to a client app, such as a web frontend or mobile client, which grants access to the Realtime Translation API without leaking your main API key. You can configure a custom TTL for each client secret.

Returns the created client secret and the effective translation session object. The client secret is a string that looks like ek_1234.

Body Parameters

session: RealtimeTranslationSessionCreateRequest

Realtime translation session configuration. Translation sessions stream source audio in and translated audio plus transcript deltas out continuously.
- model: string
  
  The Realtime translation model used for this session.
- audio: optional object { input, output }
  
  Configuration for translation input and output audio.
  - input: optional object { noise_reduction, transcription }
    - noise_reduction: optional object { type }
      
      Optional input noise reduction. Set to null to disable it.
      - type: NoiseReductionType
        
        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.
        
        "near_field"
        
        "far_field"
    - transcription: optional object { model }
      
      Optional source-language transcription. When configured, the server emits session.input_transcript.delta events. Translation itself still runs from the input audio stream.
      - model: string
        
        The transcription model to use for source transcript deltas.
  - output: optional object { language }
    - language: optional string
      
      Target language for translated output audio and transcript deltas.
expires_after: optional object { anchor, seconds }

Configuration for the client secret expiration. Expiration refers to the time after which a client secret will no longer be valid for creating sessions. The session itself may continue after that time once started. A secret can be used to create multiple sessions until it expires.
- anchor: optional "created_at"
  
  The anchor point for the client secret expiration, meaning that seconds will be added to the created_at time of the client secret to produce an expiration timestamp. Only created_at is currently supported.
  - "created_at"
- seconds: optional number
  
  The number of seconds from the anchor point to the expiration. Select a value between 10 and 7200 (2 hours). This default to 600 seconds (10 minutes) if not specified.

Returns

RealtimeTranslationClientSecretCreateResponse object { expires_at, session, value }

Response from creating a translation session and client secret for the Realtime API.
- expires_at: number
  
  Expiration timestamp for the client secret, in seconds since epoch.
- session: RealtimeTranslationSession
  
  A Realtime translation session. Translation sessions continuously translate input audio into the configured output language.
  - id: string
    
    Unique identifier for the session that looks like sess_1234567890abcdef.
  - audio: object { input, output }
    
    Configuration for translation input and output audio.
    - input: optional object { noise_reduction, transcription }
      - noise_reduction: optional object { type }
        
        Optional input noise reduction.
        
        type: NoiseReductionType
        
        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.
        
        "near_field"
        
        "far_field"
      - transcription: optional object { model }
        
        Optional source-language transcription. When configured, the server emits session.input_transcript.delta events. Translation itself still runs from the input audio stream.
        
        model: string
        
        The transcription model used for source transcript deltas.
    - output: optional object { language }
      - language: optional string
        
        Target language for translated output audio and transcript deltas.
  - expires_at: number
    
    Expiration timestamp for the session, in seconds since epoch.
  - model: string
    
    The Realtime translation model used for this session. This field is set at session creation and cannot be changed with session.update.
  - type: "translation"
    
    The session type. Always translation for Realtime translation sessions.
    - "translation"
- value: string
  
  The generated client secret value.

Example

curl https://api.openai.com/v1/realtime/translations/client_secrets \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "session": {
            "model": "model"
          }
        }'

Response

{
  "expires_at": 0,
  "session": {
    "id": "id",
    "audio": {
      "input": {
        "noise_reduction": {
          "type": "near_field"
        },
        "transcription": {
          "model": "model"
        }
      },
      "output": {
        "language": "language"
      }
    },
    "expires_at": 0,
    "model": "model",
    "type": "translation"
  },
  "value": "value"
}

Example

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

resources/realtime/subresources/translations/index.md +246 −0 created

1# Translations

3# Client Secrets

5## Create translation client secret

7**post** `/realtime/translations/client_secrets`

9Create a Realtime translation client secret with an associated translation session configuration.

11Client secrets are short-lived tokens that can be passed to a client app,

12such as a web frontend or mobile client, which grants access to the Realtime

13Translation API without leaking your main API key. You can configure a custom

14TTL for each client secret.

16Returns the created client secret and the effective translation session object.

17The client secret is a string that looks like `ek_1234`.

19### Body Parameters

21- `session: RealtimeTranslationSessionCreateRequest`

23 Realtime translation session configuration. Translation sessions stream source

24 audio in and translated audio plus transcript deltas out continuously.

26 - `model: string`

28 The Realtime translation model used for this session.

30 - `audio: optional object { input, output }`

32 Configuration for translation input and output audio.

34 - `input: optional object { noise_reduction, transcription }`

36 - `noise_reduction: optional object { type }`

38 Optional input noise reduction. Set to `null` to disable it.

40 - `type: NoiseReductionType`

42 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.

44 - `"near_field"`

46 - `"far_field"`

48 - `transcription: optional object { model }`

50 Optional source-language transcription. When configured, the server emits

51 `session.input_transcript.delta` events. Translation itself still runs from

52 the input audio stream.

54 - `model: string`

56 The transcription model to use for source transcript deltas.

58 - `output: optional object { language }`

60 - `language: optional string`

62 Target language for translated output audio and transcript deltas.

64- `expires_after: optional object { anchor, seconds }`

66 Configuration for the client secret expiration. Expiration refers to the time after which

67 a client secret will no longer be valid for creating sessions. The session itself may

68 continue after that time once started. A secret can be used to create multiple sessions

69 until it expires.

71 - `anchor: optional "created_at"`

73 The anchor point for the client secret expiration, meaning that `seconds` will be added to the `created_at` time of the client secret to produce an expiration timestamp. Only `created_at` is currently supported.

75 - `"created_at"`

77 - `seconds: optional number`

79 The number of seconds from the anchor point to the expiration. Select a value between `10` and `7200` (2 hours). This default to 600 seconds (10 minutes) if not specified.

81### Returns

83- `RealtimeTranslationClientSecretCreateResponse object { expires_at, session, value }`

85 Response from creating a translation session and client secret for the Realtime API.

87 - `expires_at: number`

89 Expiration timestamp for the client secret, in seconds since epoch.

91 - `session: RealtimeTranslationSession`

93 A Realtime translation session. Translation sessions continuously translate input

94 audio into the configured output language.

96 - `id: string`

98 Unique identifier for the session that looks like `sess_1234567890abcdef`.

100 - `audio: object { input, output }`

101

102 Configuration for translation input and output audio.

103

104 - `input: optional object { noise_reduction, transcription }`

105

106 - `noise_reduction: optional object { type }`

107

108 Optional input noise reduction.

109

110 - `type: NoiseReductionType`

111

112 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.

113

114 - `"near_field"`

115

116 - `"far_field"`

117

118 - `transcription: optional object { model }`

119

120 Optional source-language transcription. When configured, the server emits

121 `session.input_transcript.delta` events. Translation itself still runs from

122 the input audio stream.

123

124 - `model: string`

125

126 The transcription model used for source transcript deltas.

127

128 - `output: optional object { language }`

129

130 - `language: optional string`

131

132 Target language for translated output audio and transcript deltas.

133

134 - `expires_at: number`

135

136 Expiration timestamp for the session, in seconds since epoch.

137

138 - `model: string`

139

140 The Realtime translation model used for this session. This field is set at

141 session creation and cannot be changed with `session.update`.

142

143 - `type: "translation"`

144

145 The session type. Always `translation` for Realtime translation sessions.

146

147 - `"translation"`

148

149 - `value: string`

150

151 The generated client secret value.

152

153### Example

154

155```http

156curl https://api.openai.com/v1/realtime/translations/client_secrets \

157 -H 'Content-Type: application/json' \

158 -H "Authorization: Bearer $OPENAI_API_KEY" \

159 -d '{

160 "session": {

161 "model": "model"

162 }

163 }'

164```

165

166#### Response

167

168```json

169{

170 "expires_at": 0,

171 "session": {

172 "id": "id",

173 "audio": {

174 "input": {

175 "noise_reduction": {

176 "type": "near_field"

177 },

178 "transcription": {

179 "model": "model"

180 }

181 },

182 "output": {

183 "language": "language"

184 }

185 },

186 "expires_at": 0,

187 "model": "model",

188 "type": "translation"

189 },

190 "value": "value"

191}

192```

193

194### Example

195

196```http

197curl -X POST https://api.openai.com/v1/realtime/translations/client_secrets \

198 -H "Authorization: Bearer $OPENAI_API_KEY" \

199 -H "Content-Type: application/json" \

200 -d '{

201 "expires_after": {

202 "anchor": "created_at",

203 "seconds": 600

204 },

205 "session": {

206 "model": "gpt-realtime-translate",

207 "audio": {

208 "input": {

209 "transcription": {

210 "model": "gpt-realtime-whisper"

211 },

212 "noise_reduction": null

213 },

214 "output": {

215 "language": "es"

216 }

217 }

218 }

219 }'

220```

221

222#### Response

223

224```json

225{

226 "value": "ek_68af296e8e408191a1120ab6383263c2",

227 "expires_at": 1756310470,

228 "session": {

229 "id": "sess_C9CiUVUzUzYIssh3ELY1d",

230 "type": "translation",

231 "expires_at": 1756310470,

232 "model": "gpt-realtime-translate",

233 "audio": {

234 "input": {

235 "transcription": {

236 "model": "gpt-realtime-whisper"

237 },

238 "noise_reduction": null

239 },

240 "output": {

241 "language": "es"

242 }

243 }

244 }

245}

246```

resources/realtime/subresources/translations/index.md 2026-05-05 23:00 UTC to 2026-05-07 21:57 UTC

Translations

Client Secrets

Create translation client secret

Body Parameters

Returns

Example

Response

Example

Response