Following PR #545. Added a simple Ephemeral API token creation in order to be used to authenticate browser clients for the Realtime API. Useful to WebRTC integration.

Added Spec and basic documentation on how to use it.

response = client.real_time.create(parameters: { model: "gpt-4o-realtime-preview-2024-12-17" })
puts "ephemeral key: #{response.dig('client_secret', 'value')}"
# => "ephemeral key: ek_abc123"

Then in the client-side application, make a POST request to the Real-Time API with the ephemeral key and the SDP offer.

const OPENAI_REALTIME_URL = 'https://api.openai.com/v1/realtime/sessions'
const MODEL = 'gpt-4o-realtime-preview-2024-12-17'

const response = await fetch(`${OPENAI_REALTIME_URL}?model=${MODEL}`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/sdp',
    'Authorization': `Bearer ${ephemeralKey}`,
    'OpenAI-Beta': 'realtime=v1'
  },
  body: offer.sdp
})

API doc: https://platform.openai.com/docs/api-reference/realtime

All Submissions:

• Have you followed the guidelines in our Contributing document?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?
• Have you added an explanation of what your changes do and why you'd like us to include them?