=encoding utf8

=head1 NAME

OpenAPI::Client::OpenAI::Path::realtime-transcription_sessions - Documentation for the /realtime/transcription_sessions path.

=head1 DESCRIPTION

This document describes the API endpoint at C</realtime/transcription_sessions>.

=head1 PATHS


=head2 C<POST /realtime/transcription_sessions>

Create an ephemeral API token for use in client-side applications with the
Realtime API specifically for realtime transcriptions. 
Can be configured with the same session parameters as the C<transcription_session.update> client event.

It responds with a session object, plus a C<client_secret> key which contains
a usable ephemeral API token that can be used to authenticate browser clients
for the Realtime API.



=head3 Operation ID

C<create-realtime-transcription-session>

    $client->create-realtime-transcription-session( ... );

=head3 Parameters

=over 4

=back

=head3 Request Body
  
=head3 Content Type: C<application/json>

    
      Realtime transcription session object configuration.

      
      
Example:

    {
       "client_secret" : {
          "expires_at" : null
       },
       "include" : [
          null
       ],
       "input_audio_noise_reduction" : null,
       "input_audio_transcription" : null,
       "turn_detection" : null
    }


             

=head3 Responses


=head4 Status Code: C<200>

Session created successfully.


=head4 Content Types:

=over 4


=item * C<application/json>

Example (See the L<OpenAI spec for more detail|https://github.com/openai/openai-openapi/blob/master/openapi.yaml>):

    {
      "id": "sess_BBwZc7cFV3XizEyKGDCGL",
      "object": "realtime.transcription_session",
      "expires_at": 1742188264,
      "modalities": ["audio", "text"],
      "turn_detection": {
        "type": "server_vad",
        "threshold": 0.5,
        "prefix_padding_ms": 300,
        "silence_duration_ms": 200
      },
      "input_audio_format": "pcm16",
      "input_audio_transcription": {
        "model": "gpt-4o-transcribe",
        "language": null,
        "prompt": ""
      },
      "client_secret": null
    }


=back

=head1 SEE ALSO

L<OpenAPI::Client::OpenAI::Path>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2023-2025 by Nelson Ferraz

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.14.0 or,
at your option, any later version of Perl 5 you may have available.

=cut