POST/realtime/translations/client_secrets

Create translation client secret

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.

RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 body fields

Create a client secret with the given translation session configuration.

expires_afterobjectoptional

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.

sessionobjectrequired

Realtime translation session configuration. Translation sessions stream source audio in and translated audio plus transcript deltas out continuously.

1 status code

200Translation client secret created successfully.

valuestringrequired

The generated client secret value.

expires_atintegerrequired

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

sessionobjectrequired

A Realtime translation session. Translation sessions continuously translate input audio into the configured output language.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.clientSecrets.create({
  session: {},
  expiresAfter: {},
});

{
  "value": "example_value",
  "expires_at": 1,
  "session": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "translation",
    "expires_at": 1,
    "model": "example_value",
    "audio": {
      "input": {
        "transcription": {
          "model": "example_value"
        },
        "noise_reduction": {
          "type": "near_field"
        }
      },
      "output": {
        "language": "example_value"
      }
    }
  }
}

Request

Response