{"command":{"effect":"write","timeoutSeconds":120,"inputSchema":{"type":"object","description":"Create a Realtime translation client secret with an associated translation session configuration.\n\nClient secrets are short-lived tokens that can be passed to a client app,\nsuch as a web frontend or mobile client, which grants access to the Realtime\nTranslation API without leaking your main API key. You can configure a custom\nTTL for each client secret.\n\nReturns the created client secret and the effective translation session object.\nThe client secret is a string that looks like `ek_1234`.\n","properties":{"body":{"$ref":"#/definitions/RealtimeTranslationClientSecretCreateRequest"}},"required":["body"],"additionalProperties":false,"definitions":{"RealtimeTranslationClientSecretCreateRequest":{"type":"object","title":"Realtime translation client secret creation request","description":"Create a translation session and client secret for the Realtime API.\n","properties":{"expires_after":{"type":"object","title":"Client secret expiration","description":"Configuration for the client secret expiration. Expiration refers to the time after which\na client secret will no longer be valid for creating sessions. The session itself may\ncontinue after that time once started. A secret can be used to create multiple sessions\nuntil it expires.\n","properties":{"anchor":{"type":"string","enum":["created_at"],"description":"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.\n","default":"created_at"},"seconds":{"type":"integer","description":"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.\n","minimum":10,"maximum":7200,"default":600}}},"session":{"$ref":"#/definitions/RealtimeTranslationSessionCreateRequest"}},"required":["session"]},"RealtimeTranslationSessionCreateRequest":{"type":"object","title":"Realtime translation session configuration","description":"Realtime translation session configuration. Translation sessions stream source\naudio in and translated audio plus transcript deltas out continuously.\n","properties":{"model":{"type":"string","description":"The Realtime translation model used for this session.\n"},"audio":{"type":"object","description":"Configuration for translation input and output audio.\n","properties":{"input":{"type":"object","properties":{"transcription":{"anyOf":[{"type":"object","description":"Optional source-language transcription. When configured, the server emits\n`session.input_transcript.delta` events. Translation itself still runs from\nthe input audio stream.\n","properties":{"model":{"type":"string","description":"The transcription model to use for source transcript deltas."}},"required":["model"]},{"type":"null"}]},"noise_reduction":{"anyOf":[{"type":"object","description":"Optional input noise reduction. Set to `null` to disable it.\n","properties":{"type":{"$ref":"#/definitions/NoiseReductionType"},"strength":{"$ref":"#/definitions/RealtimeNoiseReductionStrength"}},"required":["type"]},{"type":"null"}]}}},"output":{"type":"object","properties":{"language":{"type":"string","description":"Target language for translated output audio and transcript deltas.\n"}}}}}},"required":["model"]},"NoiseReductionType":{"type":"string","enum":["near_field","far_field"],"description":"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.\n"},"RealtimeNoiseReductionStrength":{"type":"number","minimum":0,"maximum":1,"default":1,"description":"Input noise suppression strength. Higher values apply more suppression.\nDefaults to 1 when noise reduction is first enabled. Omitting strength\nfrom a session update preserves the current strength.\n"}}},"name":"Create translation client secret","id":"openai.create-realtime-translation-client-secret","example":{"body":{"session":{"model":"example"}}},"maxRequests":1,"summary":false}}