---
title: "Create a realtime client secret"
method: POST
path: "/v1/realtime/client_secrets"
tags: ["Realtime"]
---

# Create a realtime client secret

`POST /v1/realtime/client_secrets`

## Request

- Base URL: `https://api.llmgateway.io`
- URL: `https://api.llmgateway.io/v1/realtime/client_secrets`
- Auth: HTTP bearer

## Request body

- object
  - `expires_after` object
    - `anchor` 'created_at'
    - `seconds` integer
  - `session` union, required
    - object
      - `type` 'realtime', required
      - `model` string, required
      - `instructions` string
      - `audio` object
        - `input` object
          - `transcription` object, nullable
            - `model` string, required
        - `output` object
          - `voice` string
    - object
      - `type` 'transcription', required
      - `audio` object, required
        - `input` object, required
          - `transcription` object, required
            - `model` string, required

## Response `200`

Short-lived secret for a realtime WebSocket session.

- object
  - `value` string, required
  - `expires_at` number, required
  - `session` union, required
    - object
      - `type` 'realtime', required
      - `model` string, required
    - object
      - `type` 'transcription', required
      - `audio` object, required
        - `input` object, required
          - `transcription` object, required
            - `model` string, required

## Other responses

- `default`: Authentication, validation, or availability error.

## Changes

- **2026-09-16** `4d350bc8131d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmgateway/apis/llmgateway-api/changes/v1/realtime/client_secrets/post.md)

---

[API](https://skmtc.dev/llmgateway/apis/llmgateway-api.md) - [All operations](https://skmtc.dev/llmgateway/apis/llmgateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmgateway/apis/llmgateway-api/revisions/ded707bdf4a1?raw)