Realtime translation server events

For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.

These are events emitted from the OpenAI Realtime Translation WebSocket server to the client.

error

Returned when an error occurs, which could be a client problem or a server problem. Most errors are recoverable and the session will stay open, we recommend to implementors to monitor and log error messages by default.

Schema

Schema name: RealtimeServerEventError

{
  "(resource) realtime > (model) realtime_error_event > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeServerEventError",
    "docstring": "Returned when an error occurs, which could be a client problem or a server\nproblem. Most errors are recoverable and the session will stay open, we\nrecommend to implementors to monitor and log error messages by default.\n",
    "ident": "RealtimeErrorEvent",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "error"
        },
        {
          "ident": "event_id"
        },
        {
          "ident": "type"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_error_event > (schema) > (property) error",
      "(resource) realtime > (model) realtime_error_event > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_error_event > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_error_event > (schema) > (property) error": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error",
    "deprecated": false,
    "key": "error",
    "docstring": "Details of the error.",
    "type": {
      "kind": "HttpTypeReference",
      "ident": "RealtimeError",
      "$ref": "(resource) realtime > (model) realtime_error > (schema)"
    },
    "optional": false,
    "nullable": false,
    "modelImplicit": false,
    "schemaType": "object",
    "modelPath": "(resource) realtime > (model) realtime_error",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_error > (schema) > (property) message",
      "(resource) realtime > (model) realtime_error > (schema) > (property) type",
      "(resource) realtime > (model) realtime_error > (schema) > (property) code",
      "(resource) realtime > (model) realtime_error > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_error > (schema) > (property) param"
    ]
  },
  "(resource) realtime > (model) realtime_error_event > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The unique ID of the server event.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_error_event > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The event type, must be `error`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeServerEventError/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "error"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_error_event > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_error > (schema) > (property) message": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/message",
    "deprecated": false,
    "key": "message",
    "docstring": "A human-readable error message.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_error > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The type of error (e.g., \"invalid_request_error\", \"server_error\").\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_error > (schema) > (property) code": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/code",
    "deprecated": false,
    "key": "code",
    "docstring": "Error code, if any.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": true,
    "nullable": true,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_error > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The event_id of the client event that caused the error, if applicable.\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": true,
    "nullable": true,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_error > (schema) > (property) param": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/param",
    "deprecated": false,
    "key": "param",
    "docstring": "Parameter related to the error, if any.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": true,
    "nullable": true,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_error > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error",
    "docstring": "Details of the error.",
    "ident": "RealtimeError",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "message"
        },
        {
          "ident": "type"
        },
        {
          "ident": "code"
        },
        {
          "ident": "event_id"
        },
        {
          "ident": "param"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_error > (schema) > (property) message",
      "(resource) realtime > (model) realtime_error > (schema) > (property) type",
      "(resource) realtime > (model) realtime_error > (schema) > (property) code",
      "(resource) realtime > (model) realtime_error > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_error > (schema) > (property) param"
    ]
  },
  "(resource) realtime > (model) realtime_error_event > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "error"
    }
  }
}

Example

{
    "event_id": "event_890",
    "type": "error",
    "error": {
        "type": "invalid_request_error",
        "code": "invalid_event",
        "message": "The 'type' field is missing.",
        "param": null,
        "event_id": "event_567"
    }
}

session.created

Returned when a translation session is created. Emitted automatically when a new connection is established as the first server event. This event contains the default translation session configuration.

Schema

Schema name: RealtimeTranslationServerEventSessionCreated

{
  "(resource) realtime > (model) realtime_translation_session_created_event > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated",
    "docstring": "Returned when a translation session is created. Emitted automatically when a\nnew connection is established as the first server event. This event contains\nthe default translation session configuration.\n",
    "ident": "RealtimeTranslationSessionCreatedEvent",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "event_id"
        },
        {
          "ident": "session"
        },
        {
          "ident": "type"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) session",
      "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The unique ID of the server event.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) session": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/session",
    "deprecated": false,
    "key": "session",
    "docstring": "The translation session configuration.",
    "title": "Realtime translation session",
    "type": {
      "kind": "HttpTypeReference",
      "ident": "RealtimeTranslationSession",
      "$ref": "(resource) realtime > (model) realtime_translation_session > (schema)"
    },
    "optional": false,
    "nullable": false,
    "modelImplicit": false,
    "schemaType": "object",
    "modelPath": "(resource) realtime > (model) realtime_translation_session",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The event type, must be `session.created`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "session.created"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/id",
    "deprecated": false,
    "key": "id",
    "docstring": "Unique identifier for the session that looks like `sess_1234567890abcdef`.\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio",
    "deprecated": false,
    "key": "audio",
    "docstring": "Configuration for translation input and output audio.\n",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "input"
        },
        {
          "ident": "output"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/expires_at",
    "deprecated": false,
    "key": "expires_at",
    "docstring": "Expiration timestamp for the session, in seconds since epoch.",
    "type": {
      "kind": "HttpTypeNumber"
    },
    "constraints": {
      "format": "unixtime"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "integer",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/model",
    "deprecated": false,
    "key": "model",
    "docstring": "The Realtime translation model used for this session. This field is set at\nsession creation and cannot be changed with `session.update`.\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The session type. Always `translation` for Realtime translation sessions.\n",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "translation"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationSession",
    "docstring": "A Realtime translation session. Translation sessions continuously translate input\naudio into the configured output language.\n",
    "ident": "RealtimeTranslationSession",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "id"
        },
        {
          "ident": "audio"
        },
        {
          "ident": "expires_at"
        },
        {
          "ident": "model"
        },
        {
          "ident": "type"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "session.created"
    }
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input",
    "deprecated": false,
    "key": "input",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "noise_reduction"
        },
        {
          "ident": "transcription"
        }
      ]
    },
    "optional": true,
    "nullable": false,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output",
    "deprecated": false,
    "key": "output",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "language"
        }
      ]
    },
    "optional": true,
    "nullable": false,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "translation"
    }
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction",
    "deprecated": false,
    "key": "noise_reduction",
    "docstring": "Optional input noise reduction.\n",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "type"
        }
      ]
    },
    "optional": true,
    "nullable": true,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription",
    "deprecated": false,
    "key": "transcription",
    "docstring": "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",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "model"
        }
      ]
    },
    "optional": true,
    "nullable": true,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output/properties/language",
    "deprecated": false,
    "key": "language",
    "docstring": "Target language for translated output audio and transcript deltas.\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": true,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction/anyOf/0/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "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",
    "type": {
      "kind": "HttpTypeReference",
      "ident": "NoiseReductionType",
      "$ref": "(resource) realtime > (model) noise_reduction_type > (schema)"
    },
    "optional": false,
    "nullable": false,
    "modelImplicit": false,
    "schemaType": "enum",
    "modelPath": "(resource) realtime > (model) noise_reduction_type",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 1"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription/anyOf/0/properties/model",
    "deprecated": false,
    "key": "model",
    "docstring": "The transcription model used for source transcript deltas.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "near_field"
    }
  },
  "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 1": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "far_field"
    }
  },
  "(resource) realtime > (model) noise_reduction_type > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/NoiseReductionType",
    "docstring": "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",
    "ident": "NoiseReductionType",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/NoiseReductionType",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "near_field"
        },
        {
          "kind": "HttpTypeLiteral",
          "literal": "far_field"
        }
      ]
    },
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 1"
    ]
  }
}

Example

{
  "type": "session.created",
  "event_id": "event_123",
  "session": {
    "id": "sess_123",
    "type": "translation",
    "model": "gpt-realtime-translate",
    "expires_at": 1714857600,
    "audio": {
      "input": {
        "transcription": {
          "model": "gpt-realtime-whisper",
          "language": "en"
        },
        "noise_reduction": {
          "type": "near_field"
        }
      },
      "output": {
        "language": "fr"
      }
    }
  }
}

session.updated

Returned when a translation session is updated with a session.update event, unless there is an error.

Schema

Schema name: RealtimeTranslationServerEventSessionUpdated

{
  "(resource) realtime > (model) realtime_translation_session_updated_event > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated",
    "docstring": "Returned when a translation session is updated with a `session.update` event,\nunless there is an error.\n",
    "ident": "RealtimeTranslationSessionUpdatedEvent",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "event_id"
        },
        {
          "ident": "session"
        },
        {
          "ident": "type"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) session",
      "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The unique ID of the server event.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) session": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/session",
    "deprecated": false,
    "key": "session",
    "docstring": "The translation session configuration.",
    "title": "Realtime translation session",
    "type": {
      "kind": "HttpTypeReference",
      "ident": "RealtimeTranslationSession",
      "$ref": "(resource) realtime > (model) realtime_translation_session > (schema)"
    },
    "optional": false,
    "nullable": false,
    "modelImplicit": false,
    "schemaType": "object",
    "modelPath": "(resource) realtime > (model) realtime_translation_session",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The event type, must be `session.updated`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "session.updated"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/id",
    "deprecated": false,
    "key": "id",
    "docstring": "Unique identifier for the session that looks like `sess_1234567890abcdef`.\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio",
    "deprecated": false,
    "key": "audio",
    "docstring": "Configuration for translation input and output audio.\n",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "input"
        },
        {
          "ident": "output"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/expires_at",
    "deprecated": false,
    "key": "expires_at",
    "docstring": "Expiration timestamp for the session, in seconds since epoch.",
    "type": {
      "kind": "HttpTypeNumber"
    },
    "constraints": {
      "format": "unixtime"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "integer",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/model",
    "deprecated": false,
    "key": "model",
    "docstring": "The Realtime translation model used for this session. This field is set at\nsession creation and cannot be changed with `session.update`.\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The session type. Always `translation` for Realtime translation sessions.\n",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "translation"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationSession",
    "docstring": "A Realtime translation session. Translation sessions continuously translate input\naudio into the configured output language.\n",
    "ident": "RealtimeTranslationSession",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "id"
        },
        {
          "ident": "audio"
        },
        {
          "ident": "expires_at"
        },
        {
          "ident": "model"
        },
        {
          "ident": "type"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "session.updated"
    }
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input",
    "deprecated": false,
    "key": "input",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "noise_reduction"
        },
        {
          "ident": "transcription"
        }
      ]
    },
    "optional": true,
    "nullable": false,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction",
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output",
    "deprecated": false,
    "key": "output",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "language"
        }
      ]
    },
    "optional": true,
    "nullable": false,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "translation"
    }
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction",
    "deprecated": false,
    "key": "noise_reduction",
    "docstring": "Optional input noise reduction.\n",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "type"
        }
      ]
    },
    "optional": true,
    "nullable": true,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription",
    "deprecated": false,
    "key": "transcription",
    "docstring": "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",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "model"
        }
      ]
    },
    "optional": true,
    "nullable": true,
    "schemaType": "object",
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output/properties/language",
    "deprecated": false,
    "key": "language",
    "docstring": "Target language for translated output audio and transcript deltas.\n",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": true,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction/anyOf/0/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "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",
    "type": {
      "kind": "HttpTypeReference",
      "ident": "NoiseReductionType",
      "$ref": "(resource) realtime > (model) noise_reduction_type > (schema)"
    },
    "optional": false,
    "nullable": false,
    "modelImplicit": false,
    "schemaType": "enum",
    "modelPath": "(resource) realtime > (model) noise_reduction_type",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 1"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription/anyOf/0/properties/model",
    "deprecated": false,
    "key": "model",
    "docstring": "The transcription model used for source transcript deltas.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "near_field"
    }
  },
  "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 1": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "far_field"
    }
  },
  "(resource) realtime > (model) noise_reduction_type > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/NoiseReductionType",
    "docstring": "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",
    "ident": "NoiseReductionType",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/NoiseReductionType",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "near_field"
        },
        {
          "kind": "HttpTypeLiteral",
          "literal": "far_field"
        }
      ]
    },
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",
      "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 1"
    ]
  }
}

Example

{
  "type": "session.updated",
  "event_id": "event_124",
  "session": {
    "id": "sess_123",
    "type": "translation",
    "model": "gpt-realtime-translate",
    "expires_at": 1714857600,
    "audio": {
      "input": {
        "transcription": {
          "model": "gpt-realtime-whisper",
          "language": "en"
        },
        "noise_reduction": {
          "type": "near_field"
        }
      },
      "output": {
        "language": "es"
      }
    }
  }
}

session.closed

Returned when a realtime translation session is closed.

Schema

Schema name: RealtimeTranslationServerEventSessionClosed

{
  "(resource) realtime > (model) realtime_translation_session_closed_event > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed",
    "docstring": "Returned when a realtime translation session is closed.\n",
    "ident": "RealtimeTranslationSessionClosedEvent",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "event_id"
        },
        {
          "ident": "type"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) type"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The unique ID of the server event.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The event type, must be `session.closed`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "session.closed"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "session.closed"
    }
  }
}

Example

{
  "event_id": "event_987",
  "type": "session.closed"
}

session.input_transcript.delta

Returned when optional source-language transcript text is available. This event is emitted only when audio.input.transcription is configured.

Transcript deltas are append-only text fragments. Clients should not insert unconditional spaces between deltas.

Schema

Schema name: RealtimeTranslationServerEventSessionInputTranscriptDelta

{
  "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta",
    "docstring": "Returned when optional source-language transcript text is available. This event\nis emitted only when `audio.input.transcription` is configured.\n\nTranscript deltas are append-only text fragments. Clients should not insert\nunconditional spaces between deltas.\n",
    "ident": "RealtimeTranslationInputTranscriptDeltaEvent",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "delta"
        },
        {
          "ident": "event_id"
        },
        {
          "ident": "type"
        },
        {
          "ident": "elapsed_ms"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) delta",
      "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) type",
      "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) elapsed_ms"
    ]
  },
  "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) delta": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/delta",
    "deprecated": false,
    "key": "delta",
    "docstring": "Append-only source-language transcript text.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The unique ID of the server event.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The event type, must be `session.input_transcript.delta`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "session.input_transcript.delta"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) elapsed_ms": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/elapsed_ms",
    "deprecated": false,
    "key": "elapsed_ms",
    "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. It advances in 200 ms increments, but multiple transcript\ndeltas may share the same `elapsed_ms`. Treat it as alignment metadata,\nnot a unique transcript-delta identifier.\n",
    "type": {
      "kind": "HttpTypeNumber"
    },
    "optional": true,
    "nullable": true,
    "schemaType": "integer",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "session.input_transcript.delta"
    }
  }
}

Example

{
  "event_id": "event_125",
  "type": "session.input_transcript.delta",
  "delta": " hear",
  "elapsed_ms": 1200
}

session.output_transcript.delta

Returned when translated transcript text is available.

Transcript deltas are append-only text fragments. Clients should not insert unconditional spaces between deltas.

Schema

Schema name: RealtimeTranslationServerEventSessionOutputTranscriptDelta

{
  "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta",
    "docstring": "Returned when translated transcript text is available.\n\nTranscript deltas are append-only text fragments. Clients should not insert\nunconditional spaces between deltas.\n",
    "ident": "RealtimeTranslationOutputTranscriptDeltaEvent",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "delta"
        },
        {
          "ident": "event_id"
        },
        {
          "ident": "type"
        },
        {
          "ident": "elapsed_ms"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) delta",
      "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) type",
      "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) elapsed_ms"
    ]
  },
  "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) delta": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/delta",
    "deprecated": false,
    "key": "delta",
    "docstring": "Append-only transcript text for the translated output audio.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The unique ID of the server event.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The event type, must be `session.output_transcript.delta`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "session.output_transcript.delta"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) elapsed_ms": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/elapsed_ms",
    "deprecated": false,
    "key": "elapsed_ms",
    "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. It advances in 200 ms increments, but multiple transcript\ndeltas may share the same `elapsed_ms`. Treat it as alignment metadata,\nnot a unique transcript-delta identifier.\n",
    "type": {
      "kind": "HttpTypeNumber"
    },
    "optional": true,
    "nullable": true,
    "schemaType": "integer",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "session.output_transcript.delta"
    }
  }
}

Example

{
  "event_id": "event_124",
  "type": "session.output_transcript.delta",
  "delta": " escuch",
  "elapsed_ms": 1200
}

session.output_audio.delta

Returned when translated output audio is available. Output audio deltas are 200 ms frames of PCM16 audio.

Schema

Schema name: RealtimeTranslationServerEventSessionOutputAudioDelta

{
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema)": {
    "kind": "HttpDeclTypeAlias",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta",
    "docstring": "Returned when translated output audio is available. Output audio deltas are\n200 ms frames of PCM16 audio.\n",
    "ident": "RealtimeTranslationOutputAudioDeltaEvent",
    "type": {
      "kind": "HttpTypeObject",
      "members": [
        {
          "ident": "delta"
        },
        {
          "ident": "event_id"
        },
        {
          "ident": "type"
        },
        {
          "ident": "channels"
        },
        {
          "ident": "elapsed_ms"
        },
        {
          "ident": "format"
        },
        {
          "ident": "sample_rate"
        }
      ]
    },
    "childrenParentSchema": "object",
    "children": [
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) delta",
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) event_id",
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) type",
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) channels",
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) elapsed_ms",
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) format",
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) sample_rate"
    ]
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) delta": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/delta",
    "deprecated": false,
    "key": "delta",
    "docstring": "Base64-encoded translated audio data.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) event_id": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/event_id",
    "deprecated": false,
    "key": "event_id",
    "docstring": "The unique ID of the server event.",
    "type": {
      "kind": "HttpTypeString"
    },
    "optional": false,
    "nullable": false,
    "schemaType": "string",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) type": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/type",
    "deprecated": false,
    "key": "type",
    "docstring": "The event type, must be `session.output_audio.delta`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/type",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "session.output_audio.delta"
        }
      ]
    },
    "optional": false,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) type > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) channels": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/channels",
    "deprecated": false,
    "key": "channels",
    "docstring": "Number of audio channels.",
    "type": {
      "kind": "HttpTypeNumber"
    },
    "default": 1,
    "optional": true,
    "nullable": false,
    "schemaType": "integer",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) elapsed_ms": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/elapsed_ms",
    "deprecated": false,
    "key": "elapsed_ms",
    "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. Treat `elapsed_ms` as alignment metadata, not a unique\nevent identifier.\n",
    "type": {
      "kind": "HttpTypeNumber"
    },
    "optional": true,
    "nullable": true,
    "schemaType": "integer",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) format": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/format",
    "deprecated": false,
    "key": "format",
    "docstring": "Audio encoding for `delta`.",
    "type": {
      "kind": "HttpTypeUnion",
      "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/format",
      "types": [
        {
          "kind": "HttpTypeLiteral",
          "literal": "pcm16"
        }
      ]
    },
    "optional": true,
    "nullable": false,
    "schemaType": "enum",
    "childrenParentSchema": "enum",
    "children": [
      "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) format > (member) 0"
    ]
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) sample_rate": {
    "kind": "HttpDeclProperty",
    "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/sample_rate",
    "deprecated": false,
    "key": "sample_rate",
    "docstring": "Sample rate of the audio delta.",
    "type": {
      "kind": "HttpTypeNumber"
    },
    "default": 24000,
    "optional": true,
    "nullable": false,
    "schemaType": "integer",
    "children": []
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) type > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "session.output_audio.delta"
    }
  },
  "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) format > (member) 0": {
    "kind": "HttpDeclReference",
    "type": {
      "kind": "HttpTypeLiteral",
      "literal": "pcm16"
    }
  }
}

Example

{
  "event_id": "event_123",
  "type": "session.output_audio.delta",
  "delta": "Base64EncodedAudioDelta",
  "sample_rate": 24000,
  "channels": 1,
  "format": "pcm16",
  "elapsed_ms": 1200
}

resources/realtime/translation-server-events.md +318 −316

1# Realtime translation server events1# Realtime translation server events

2 2

3> For the complete documentation index, see [llms.txt](/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.

3These are events emitted from the OpenAI Realtime Translation WebSocket server to the client.5These are events emitted from the OpenAI Realtime Translation WebSocket server to the client.

4 6

5## error7## error

17 "(resource) realtime > (model) realtime_error_event > (schema)": {19 "(resource) realtime > (model) realtime_error_event > (schema)": {

18 "kind": "HttpDeclTypeAlias",20 "kind": "HttpDeclTypeAlias",

19 "oasRef": "#/components/schemas/RealtimeServerEventError",21 "oasRef": "#/components/schemas/RealtimeServerEventError",

22 "docstring": "Returned when an error occurs, which could be a client problem or a server\nproblem. Most errors are recoverable and the session will stay open, we\nrecommend to implementors to monitor and log error messages by default.\n",

20 "ident": "RealtimeErrorEvent",23 "ident": "RealtimeErrorEvent",

21 "type": {24 "type": {

22 "kind": "HttpTypeObject",25 "kind": "HttpTypeObject",

32 }35 }

33 ]36 ]

34 },37 },

35 "docstring": "Returned when an error occurs, which could be a client problem or a server\nproblem. Most errors are recoverable and the session will stay open, we\nrecommend to implementors to monitor and log error messages by default.\n",

36 "childrenParentSchema": "object",38 "childrenParentSchema": "object",

37 "children": [39 "children": [

38 "(resource) realtime > (model) realtime_error_event > (schema) > (property) error",40 "(resource) realtime > (model) realtime_error_event > (schema) > (property) error",

42 },44 },

43 "(resource) realtime > (model) realtime_error_event > (schema) > (property) error": {45 "(resource) realtime > (model) realtime_error_event > (schema) > (property) error": {

44 "kind": "HttpDeclProperty",46 "kind": "HttpDeclProperty",

~~45 "docstring": "Details of the error.",~~47 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error",

48 "deprecated": false,

46 "key": "error",49 "key": "error",

~~47 "optional": false,~~50 "docstring": "Details of the error.",

~~48 "nullable": false,~~

49 "type": {51 "type": {

50 "kind": "HttpTypeReference",52 "kind": "HttpTypeReference",

51 "ident": "RealtimeError",53 "ident": "RealtimeError",

52 "$ref": "(resource) realtime > (model) realtime_error > (schema)"54 "$ref": "(resource) realtime > (model) realtime_error > (schema)"

53 },55 },

~~54 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error",~~56 "optional": false,

~~55 "deprecated": false,~~57 "nullable": false,

~~56 "schemaType": "object",~~

57 "modelImplicit": false,58 "modelImplicit": false,

59 "schemaType": "object",

58 "modelPath": "(resource) realtime > (model) realtime_error",60 "modelPath": "(resource) realtime > (model) realtime_error",

59 "childrenParentSchema": "object",61 "childrenParentSchema": "object",

60 "children": [62 "children": [

67 },69 },

68 "(resource) realtime > (model) realtime_error_event > (schema) > (property) event_id": {70 "(resource) realtime > (model) realtime_error_event > (schema) > (property) event_id": {

69 "kind": "HttpDeclProperty",71 "kind": "HttpDeclProperty",

~~70 "docstring": "The unique ID of the server event.",~~72 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/event_id",

73 "deprecated": false,

71 "key": "event_id",74 "key": "event_id",

~~72 "optional": false,~~75 "docstring": "The unique ID of the server event.",

~~73 "nullable": false,~~

74 "type": {76 "type": {

75 "kind": "HttpTypeString"77 "kind": "HttpTypeString"

76 },78 },

~~77 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/event_id",~~79 "optional": false,

~~78 "deprecated": false,~~80 "nullable": false,

79 "schemaType": "string",81 "schemaType": "string",

80 "children": []82 "children": []

81 },83 },

82 "(resource) realtime > (model) realtime_error_event > (schema) > (property) type": {84 "(resource) realtime > (model) realtime_error_event > (schema) > (property) type": {

83 "kind": "HttpDeclProperty",85 "kind": "HttpDeclProperty",

~~84 "docstring": "The event type, must be `error`.",~~86 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/type",

87 "deprecated": false,

85 "key": "type",88 "key": "type",

~~86 "optional": false,~~89 "docstring": "The event type, must be `error`.",

~~87 "nullable": false,~~

88 "type": {90 "type": {

89 "kind": "HttpTypeUnion",91 "kind": "HttpTypeUnion",

92 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/type",

90 "types": [93 "types": [

91 {94 {

92 "kind": "HttpTypeLiteral",95 "kind": "HttpTypeLiteral",

93 "literal": "error"96 "literal": "error"

94 }97 }

~~95 ],~~98 ]

~~96 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/type"~~

97 },99 },

~~98 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/type",~~100 "optional": false,

~~99 "deprecated": false,~~101 "nullable": false,

100 "schemaType": "enum",102 "schemaType": "enum",

101 "childrenParentSchema": "enum",103 "childrenParentSchema": "enum",

102 "children": [104 "children": [

105 },107 },

106 "(resource) realtime > (model) realtime_error > (schema) > (property) message": {108 "(resource) realtime > (model) realtime_error > (schema) > (property) message": {

107 "kind": "HttpDeclProperty",109 "kind": "HttpDeclProperty",

108 "docstring": "A human-readable error message.",110 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/message",

111 "deprecated": false,

109 "key": "message",112 "key": "message",

110 "optional": false,113 "docstring": "A human-readable error message.",

111 "nullable": false,

112 "type": {114 "type": {

113 "kind": "HttpTypeString"115 "kind": "HttpTypeString"

114 },116 },

115 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/message",117 "optional": false,

116 "deprecated": false,118 "nullable": false,

117 "schemaType": "string",119 "schemaType": "string",

118 "children": []120 "children": []

119 },121 },

120 "(resource) realtime > (model) realtime_error > (schema) > (property) type": {122 "(resource) realtime > (model) realtime_error > (schema) > (property) type": {

121 "kind": "HttpDeclProperty",123 "kind": "HttpDeclProperty",

122 "docstring": "The type of error (e.g., \"invalid_request_error\", \"server_error\").\n",124 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/type",

125 "deprecated": false,

123 "key": "type",126 "key": "type",

124 "optional": false,127 "docstring": "The type of error (e.g., \"invalid_request_error\", \"server_error\").\n",

125 "nullable": false,

126 "type": {128 "type": {

127 "kind": "HttpTypeString"129 "kind": "HttpTypeString"

128 },130 },

129 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/type",131 "optional": false,

130 "deprecated": false,132 "nullable": false,

131 "schemaType": "string",133 "schemaType": "string",

132 "children": []134 "children": []

133 },135 },

134 "(resource) realtime > (model) realtime_error > (schema) > (property) code": {136 "(resource) realtime > (model) realtime_error > (schema) > (property) code": {

135 "kind": "HttpDeclProperty",137 "kind": "HttpDeclProperty",

136 "docstring": "Error code, if any.",138 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/code",

139 "deprecated": false,

137 "key": "code",140 "key": "code",

138 "optional": true,141 "docstring": "Error code, if any.",

139 "nullable": true,

140 "type": {142 "type": {

141 "kind": "HttpTypeString"143 "kind": "HttpTypeString"

142 },144 },

143 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/code",145 "optional": true,

144 "deprecated": false,146 "nullable": true,

145 "schemaType": "string",147 "schemaType": "string",

146 "children": []148 "children": []

147 },149 },

148 "(resource) realtime > (model) realtime_error > (schema) > (property) event_id": {150 "(resource) realtime > (model) realtime_error > (schema) > (property) event_id": {

149 "kind": "HttpDeclProperty",151 "kind": "HttpDeclProperty",

150 "docstring": "The event_id of the client event that caused the error, if applicable.\n",152 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/event_id",

153 "deprecated": false,

151 "key": "event_id",154 "key": "event_id",

152 "optional": true,155 "docstring": "The event_id of the client event that caused the error, if applicable.\n",

153 "nullable": true,

154 "type": {156 "type": {

155 "kind": "HttpTypeString"157 "kind": "HttpTypeString"

156 },158 },

157 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/event_id",159 "optional": true,

158 "deprecated": false,160 "nullable": true,

159 "schemaType": "string",161 "schemaType": "string",

160 "children": []162 "children": []

161 },163 },

162 "(resource) realtime > (model) realtime_error > (schema) > (property) param": {164 "(resource) realtime > (model) realtime_error > (schema) > (property) param": {

163 "kind": "HttpDeclProperty",165 "kind": "HttpDeclProperty",

164 "docstring": "Parameter related to the error, if any.",166 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/param",

167 "deprecated": false,

165 "key": "param",168 "key": "param",

166 "optional": true,169 "docstring": "Parameter related to the error, if any.",

167 "nullable": true,

168 "type": {170 "type": {

169 "kind": "HttpTypeString"171 "kind": "HttpTypeString"

170 },172 },

171 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error/properties/param",173 "optional": true,

172 "deprecated": false,174 "nullable": true,

173 "schemaType": "string",175 "schemaType": "string",

174 "children": []176 "children": []

175 },177 },

176 "(resource) realtime > (model) realtime_error > (schema)": {178 "(resource) realtime > (model) realtime_error > (schema)": {

177 "kind": "HttpDeclTypeAlias",179 "kind": "HttpDeclTypeAlias",

178 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error",180 "oasRef": "#/components/schemas/RealtimeServerEventError/properties/error",

181 "docstring": "Details of the error.",

179 "ident": "RealtimeError",182 "ident": "RealtimeError",

180 "type": {183 "type": {

181 "kind": "HttpTypeObject",184 "kind": "HttpTypeObject",

197 }200 }

198 ]201 ]

199 },202 },

200 "docstring": "Details of the error.",

201 "childrenParentSchema": "object",203 "childrenParentSchema": "object",

202 "children": [204 "children": [

203 "(resource) realtime > (model) realtime_error > (schema) > (property) message",205 "(resource) realtime > (model) realtime_error > (schema) > (property) message",

248 "(resource) realtime > (model) realtime_translation_session_created_event > (schema)": {250 "(resource) realtime > (model) realtime_translation_session_created_event > (schema)": {

249 "kind": "HttpDeclTypeAlias",251 "kind": "HttpDeclTypeAlias",

250 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated",252 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated",

253 "docstring": "Returned when a translation session is created. Emitted automatically when a\nnew connection is established as the first server event. This event contains\nthe default translation session configuration.\n",

251 "ident": "RealtimeTranslationSessionCreatedEvent",254 "ident": "RealtimeTranslationSessionCreatedEvent",

252 "type": {255 "type": {

253 "kind": "HttpTypeObject",256 "kind": "HttpTypeObject",

263 }266 }

264 ]267 ]

265 },268 },

266 "docstring": "Returned when a translation session is created. Emitted automatically when a\nnew connection is established as the first server event. This event contains\nthe default translation session configuration.\n",

267 "childrenParentSchema": "object",269 "childrenParentSchema": "object",

268 "children": [270 "children": [

269 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) event_id",271 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) event_id",

273 },275 },

274 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) event_id": {276 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) event_id": {

275 "kind": "HttpDeclProperty",277 "kind": "HttpDeclProperty",

276 "docstring": "The unique ID of the server event.",278 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/event_id",

279 "deprecated": false,

277 "key": "event_id",280 "key": "event_id",

278 "optional": false,281 "docstring": "The unique ID of the server event.",

279 "nullable": false,

280 "type": {282 "type": {

281 "kind": "HttpTypeString"283 "kind": "HttpTypeString"

282 },284 },

283 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/event_id",285 "optional": false,

284 "deprecated": false,286 "nullable": false,

285 "schemaType": "string",287 "schemaType": "string",

286 "children": []288 "children": []

287 },289 },

288 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) session": {290 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) session": {

289 "kind": "HttpDeclProperty",291 "kind": "HttpDeclProperty",

290 "title": "Realtime translation session",292 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/session",

291 "docstring": "The translation session configuration.",293 "deprecated": false,

292 "key": "session",294 "key": "session",

293 "optional": false,295 "docstring": "The translation session configuration.",

294 "nullable": false,296 "title": "Realtime translation session",

295 "type": {297 "type": {

296 "kind": "HttpTypeReference",298 "kind": "HttpTypeReference",

297 "ident": "RealtimeTranslationSession",299 "ident": "RealtimeTranslationSession",

298 "$ref": "(resource) realtime > (model) realtime_translation_session > (schema)"300 "$ref": "(resource) realtime > (model) realtime_translation_session > (schema)"

299 },301 },

300 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/session",302 "optional": false,

301 "deprecated": false,303 "nullable": false,

302 "schemaType": "object",

303 "modelImplicit": false,304 "modelImplicit": false,

305 "schemaType": "object",

304 "modelPath": "(resource) realtime > (model) realtime_translation_session",306 "modelPath": "(resource) realtime > (model) realtime_translation_session",

305 "childrenParentSchema": "object",307 "childrenParentSchema": "object",

306 "children": [308 "children": [

313 },315 },

314 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) type": {316 "(resource) realtime > (model) realtime_translation_session_created_event > (schema) > (property) type": {

315 "kind": "HttpDeclProperty",317 "kind": "HttpDeclProperty",

316 "docstring": "The event type, must be `session.created`.",318 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/type",

319 "deprecated": false,

317 "key": "type",320 "key": "type",

318 "optional": false,321 "docstring": "The event type, must be `session.created`.",

319 "nullable": false,

320 "type": {322 "type": {

321 "kind": "HttpTypeUnion",323 "kind": "HttpTypeUnion",

324 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/type",

322 "types": [325 "types": [

323 {326 {

324 "kind": "HttpTypeLiteral",327 "kind": "HttpTypeLiteral",

325 "literal": "session.created"328 "literal": "session.created"

326 }329 }

327 ],330 ]

328 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/type"

329 },331 },

330 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionCreated/properties/type",332 "optional": false,

331 "deprecated": false,333 "nullable": false,

332 "schemaType": "enum",334 "schemaType": "enum",

333 "childrenParentSchema": "enum",335 "childrenParentSchema": "enum",

334 "children": [336 "children": [

337 },339 },

338 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id": {340 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id": {

339 "kind": "HttpDeclProperty",341 "kind": "HttpDeclProperty",

340 "docstring": "Unique identifier for the session that looks like `sess_1234567890abcdef`.\n",342 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/id",

343 "deprecated": false,

341 "key": "id",344 "key": "id",

342 "optional": false,345 "docstring": "Unique identifier for the session that looks like `sess_1234567890abcdef`.\n",

343 "nullable": false,

344 "type": {346 "type": {

345 "kind": "HttpTypeString"347 "kind": "HttpTypeString"

346 },348 },

347 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/id",349 "optional": false,

348 "deprecated": false,350 "nullable": false,

349 "schemaType": "string",351 "schemaType": "string",

350 "children": []352 "children": []

351 },353 },

352 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio": {354 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio": {

353 "kind": "HttpDeclProperty",355 "kind": "HttpDeclProperty",

354 "docstring": "Configuration for translation input and output audio.\n",356 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio",

357 "deprecated": false,

355 "key": "audio",358 "key": "audio",

356 "optional": false,359 "docstring": "Configuration for translation input and output audio.\n",

357 "nullable": false,

358 "type": {360 "type": {

359 "kind": "HttpTypeObject",361 "kind": "HttpTypeObject",

360 "members": [362 "members": [

366 }368 }

367 ]369 ]

368 },370 },

369 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio",371 "optional": false,

370 "deprecated": false,372 "nullable": false,

371 "schemaType": "object",373 "schemaType": "object",

372 "childrenParentSchema": "object",374 "childrenParentSchema": "object",

373 "children": [375 "children": [

377 },379 },

378 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at": {380 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at": {

379 "kind": "HttpDeclProperty",381 "kind": "HttpDeclProperty",

380 "docstring": "Expiration timestamp for the session, in seconds since epoch.",382 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/expires_at",

383 "deprecated": false,

381 "key": "expires_at",384 "key": "expires_at",

382 "optional": false,385 "docstring": "Expiration timestamp for the session, in seconds since epoch.",

383 "nullable": false,

384 "type": {386 "type": {

385 "kind": "HttpTypeNumber"387 "kind": "HttpTypeNumber"

386 },388 },

387 "constraints": {389 "constraints": {

388 "format": "unixtime"390 "format": "unixtime"

389 },391 },

390 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/expires_at",392 "optional": false,

391 "deprecated": false,393 "nullable": false,

392 "schemaType": "integer",394 "schemaType": "integer",

393 "children": []395 "children": []

394 },396 },

395 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model": {397 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model": {

396 "kind": "HttpDeclProperty",398 "kind": "HttpDeclProperty",

397 "docstring": "The Realtime translation model used for this session. This field is set at\nsession creation and cannot be changed with `session.update`.\n",399 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/model",

400 "deprecated": false,

398 "key": "model",401 "key": "model",

399 "optional": false,402 "docstring": "The Realtime translation model used for this session. This field is set at\nsession creation and cannot be changed with `session.update`.\n",

400 "nullable": false,

401 "type": {403 "type": {

402 "kind": "HttpTypeString"404 "kind": "HttpTypeString"

403 },405 },

404 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/model",406 "optional": false,

405 "deprecated": false,407 "nullable": false,

406 "schemaType": "string",408 "schemaType": "string",

407 "children": []409 "children": []

408 },410 },

409 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type": {411 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type": {

410 "kind": "HttpDeclProperty",412 "kind": "HttpDeclProperty",

411 "docstring": "The session type. Always `translation` for Realtime translation sessions.\n",413 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",

414 "deprecated": false,

412 "key": "type",415 "key": "type",

413 "optional": false,416 "docstring": "The session type. Always `translation` for Realtime translation sessions.\n",

414 "nullable": false,

415 "type": {417 "type": {

416 "kind": "HttpTypeUnion",418 "kind": "HttpTypeUnion",

419 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",

417 "types": [420 "types": [

418 {421 {

419 "kind": "HttpTypeLiteral",422 "kind": "HttpTypeLiteral",

420 "literal": "translation"423 "literal": "translation"

421 }424 }

422 ],425 ]

423 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type"

424 },426 },

425 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",427 "optional": false,

426 "deprecated": false,428 "nullable": false,

427 "schemaType": "enum",429 "schemaType": "enum",

428 "childrenParentSchema": "enum",430 "childrenParentSchema": "enum",

429 "children": [431 "children": [

433 "(resource) realtime > (model) realtime_translation_session > (schema)": {435 "(resource) realtime > (model) realtime_translation_session > (schema)": {

434 "kind": "HttpDeclTypeAlias",436 "kind": "HttpDeclTypeAlias",

435 "oasRef": "#/components/schemas/RealtimeTranslationSession",437 "oasRef": "#/components/schemas/RealtimeTranslationSession",

438 "docstring": "A Realtime translation session. Translation sessions continuously translate input\naudio into the configured output language.\n",

436 "ident": "RealtimeTranslationSession",439 "ident": "RealtimeTranslationSession",

437 "type": {440 "type": {

438 "kind": "HttpTypeObject",441 "kind": "HttpTypeObject",

454 }457 }

455 ]458 ]

456 },459 },

457 "docstring": "A Realtime translation session. Translation sessions continuously translate input\naudio into the configured output language.\n",

458 "childrenParentSchema": "object",460 "childrenParentSchema": "object",

459 "children": [461 "children": [

460 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",462 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",

473 },475 },

474 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input": {476 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input": {

475 "kind": "HttpDeclProperty",477 "kind": "HttpDeclProperty",

478 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input",

479 "deprecated": false,

476 "key": "input",480 "key": "input",

477 "optional": true,

478 "nullable": false,

479 "type": {481 "type": {

480 "kind": "HttpTypeObject",482 "kind": "HttpTypeObject",

481 "members": [483 "members": [

487 }489 }

488 ]490 ]

489 },491 },

490 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input",492 "optional": true,

491 "deprecated": false,493 "nullable": false,

492 "schemaType": "object",494 "schemaType": "object",

493 "childrenParentSchema": "object",495 "childrenParentSchema": "object",

494 "children": [496 "children": [

498 },500 },

499 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output": {501 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output": {

500 "kind": "HttpDeclProperty",502 "kind": "HttpDeclProperty",

503 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output",

504 "deprecated": false,

501 "key": "output",505 "key": "output",

502 "optional": true,

503 "nullable": false,

504 "type": {506 "type": {

505 "kind": "HttpTypeObject",507 "kind": "HttpTypeObject",

506 "members": [508 "members": [

509 }511 }

510 ]512 ]

511 },513 },

512 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output",514 "optional": true,

513 "deprecated": false,515 "nullable": false,

514 "schemaType": "object",516 "schemaType": "object",

515 "childrenParentSchema": "object",517 "childrenParentSchema": "object",

516 "children": [518 "children": [

526 },528 },

527 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction": {529 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction": {

528 "kind": "HttpDeclProperty",530 "kind": "HttpDeclProperty",

529 "docstring": "Optional input noise reduction.\n",531 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction",

532 "deprecated": false,

530 "key": "noise_reduction",533 "key": "noise_reduction",

531 "optional": true,534 "docstring": "Optional input noise reduction.\n",

532 "nullable": true,

533 "type": {535 "type": {

534 "kind": "HttpTypeObject",536 "kind": "HttpTypeObject",

535 "members": [537 "members": [

538 }540 }

539 ]541 ]

540 },542 },

541 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction",543 "optional": true,

542 "deprecated": false,544 "nullable": true,

543 "schemaType": "object",545 "schemaType": "object",

544 "childrenParentSchema": "object",546 "childrenParentSchema": "object",

545 "children": [547 "children": [

548 },550 },

549 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription": {551 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription": {

550 "kind": "HttpDeclProperty",552 "kind": "HttpDeclProperty",

551 "docstring": "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",553 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription",

554 "deprecated": false,

552 "key": "transcription",555 "key": "transcription",

553 "optional": true,556 "docstring": "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",

554 "nullable": true,

555 "type": {557 "type": {

556 "kind": "HttpTypeObject",558 "kind": "HttpTypeObject",

557 "members": [559 "members": [

560 }562 }

561 ]563 ]

562 },564 },

563 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription",565 "optional": true,

564 "deprecated": false,566 "nullable": true,

565 "schemaType": "object",567 "schemaType": "object",

566 "childrenParentSchema": "object",568 "childrenParentSchema": "object",

567 "children": [569 "children": [

570 },572 },

571 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language": {573 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language": {

572 "kind": "HttpDeclProperty",574 "kind": "HttpDeclProperty",

573 "docstring": "Target language for translated output audio and transcript deltas.\n",575 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output/properties/language",

576 "deprecated": false,

574 "key": "language",577 "key": "language",

575 "optional": true,578 "docstring": "Target language for translated output audio and transcript deltas.\n",

576 "nullable": false,

577 "type": {579 "type": {

578 "kind": "HttpTypeString"580 "kind": "HttpTypeString"

579 },581 },

580 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output/properties/language",582 "optional": true,

581 "deprecated": false,583 "nullable": false,

582 "schemaType": "string",584 "schemaType": "string",

583 "children": []585 "children": []

584 },586 },

585 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type": {587 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type": {

586 "kind": "HttpDeclProperty",588 "kind": "HttpDeclProperty",

587 "docstring": "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",589 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction/anyOf/0/properties/type",

590 "deprecated": false,

588 "key": "type",591 "key": "type",

589 "optional": false,592 "docstring": "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",

590 "nullable": false,

591 "type": {593 "type": {

592 "kind": "HttpTypeReference",594 "kind": "HttpTypeReference",

593 "ident": "NoiseReductionType",595 "ident": "NoiseReductionType",

594 "$ref": "(resource) realtime > (model) noise_reduction_type > (schema)"596 "$ref": "(resource) realtime > (model) noise_reduction_type > (schema)"

595 },597 },

596 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction/anyOf/0/properties/type",598 "optional": false,

597 "deprecated": false,599 "nullable": false,

598 "schemaType": "enum",

599 "modelImplicit": false,600 "modelImplicit": false,

601 "schemaType": "enum",

600 "modelPath": "(resource) realtime > (model) noise_reduction_type",602 "modelPath": "(resource) realtime > (model) noise_reduction_type",

601 "childrenParentSchema": "enum",603 "childrenParentSchema": "enum",

602 "children": [604 "children": [

606 },608 },

607 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model": {609 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model": {

608 "kind": "HttpDeclProperty",610 "kind": "HttpDeclProperty",

609 "docstring": "The transcription model used for source transcript deltas.",611 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription/anyOf/0/properties/model",

612 "deprecated": false,

610 "key": "model",613 "key": "model",

611 "optional": false,614 "docstring": "The transcription model used for source transcript deltas.",

612 "nullable": false,

613 "type": {615 "type": {

614 "kind": "HttpTypeString"616 "kind": "HttpTypeString"

615 },617 },

616 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription/anyOf/0/properties/model",618 "optional": false,

617 "deprecated": false,619 "nullable": false,

618 "schemaType": "string",620 "schemaType": "string",

619 "children": []621 "children": []

620 },622 },

635 "(resource) realtime > (model) noise_reduction_type > (schema)": {637 "(resource) realtime > (model) noise_reduction_type > (schema)": {

636 "kind": "HttpDeclTypeAlias",638 "kind": "HttpDeclTypeAlias",

637 "oasRef": "#/components/schemas/NoiseReductionType",639 "oasRef": "#/components/schemas/NoiseReductionType",

640 "docstring": "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",

638 "ident": "NoiseReductionType",641 "ident": "NoiseReductionType",

639 "type": {642 "type": {

640 "kind": "HttpTypeUnion",643 "kind": "HttpTypeUnion",

644 "oasRef": "#/components/schemas/NoiseReductionType",

641 "types": [645 "types": [

642 {646 {

643 "kind": "HttpTypeLiteral",647 "kind": "HttpTypeLiteral",

647 "kind": "HttpTypeLiteral",651 "kind": "HttpTypeLiteral",

648 "literal": "far_field"652 "literal": "far_field"

649 }653 }

650 ],654 ]

651 "oasRef": "#/components/schemas/NoiseReductionType"

652 },655 },

653 "docstring": "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",

654 "childrenParentSchema": "enum",656 "childrenParentSchema": "enum",

655 "children": [657 "children": [

656 "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",658 "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",

703 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema)": {705 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema)": {

704 "kind": "HttpDeclTypeAlias",706 "kind": "HttpDeclTypeAlias",

705 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated",707 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated",

708 "docstring": "Returned when a translation session is updated with a `session.update` event,\nunless there is an error.\n",

706 "ident": "RealtimeTranslationSessionUpdatedEvent",709 "ident": "RealtimeTranslationSessionUpdatedEvent",

707 "type": {710 "type": {

708 "kind": "HttpTypeObject",711 "kind": "HttpTypeObject",

718 }721 }

719 ]722 ]

720 },723 },

721 "docstring": "Returned when a translation session is updated with a `session.update` event,\nunless there is an error.\n",

722 "childrenParentSchema": "object",724 "childrenParentSchema": "object",

723 "children": [725 "children": [

724 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) event_id",726 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) event_id",

728 },730 },

729 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) event_id": {731 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) event_id": {

730 "kind": "HttpDeclProperty",732 "kind": "HttpDeclProperty",

731 "docstring": "The unique ID of the server event.",733 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/event_id",

734 "deprecated": false,

732 "key": "event_id",735 "key": "event_id",

733 "optional": false,736 "docstring": "The unique ID of the server event.",

734 "nullable": false,

735 "type": {737 "type": {

736 "kind": "HttpTypeString"738 "kind": "HttpTypeString"

737 },739 },

738 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/event_id",740 "optional": false,

739 "deprecated": false,741 "nullable": false,

740 "schemaType": "string",742 "schemaType": "string",

741 "children": []743 "children": []

742 },744 },

743 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) session": {745 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) session": {

744 "kind": "HttpDeclProperty",746 "kind": "HttpDeclProperty",

745 "title": "Realtime translation session",747 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/session",

746 "docstring": "The translation session configuration.",748 "deprecated": false,

747 "key": "session",749 "key": "session",

748 "optional": false,750 "docstring": "The translation session configuration.",

749 "nullable": false,751 "title": "Realtime translation session",

750 "type": {752 "type": {

751 "kind": "HttpTypeReference",753 "kind": "HttpTypeReference",

752 "ident": "RealtimeTranslationSession",754 "ident": "RealtimeTranslationSession",

753 "$ref": "(resource) realtime > (model) realtime_translation_session > (schema)"755 "$ref": "(resource) realtime > (model) realtime_translation_session > (schema)"

754 },756 },

755 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/session",757 "optional": false,

756 "deprecated": false,758 "nullable": false,

757 "schemaType": "object",

758 "modelImplicit": false,759 "modelImplicit": false,

760 "schemaType": "object",

759 "modelPath": "(resource) realtime > (model) realtime_translation_session",761 "modelPath": "(resource) realtime > (model) realtime_translation_session",

760 "childrenParentSchema": "object",762 "childrenParentSchema": "object",

761 "children": [763 "children": [

768 },770 },

769 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) type": {771 "(resource) realtime > (model) realtime_translation_session_updated_event > (schema) > (property) type": {

770 "kind": "HttpDeclProperty",772 "kind": "HttpDeclProperty",

771 "docstring": "The event type, must be `session.updated`.",773 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/type",

774 "deprecated": false,

772 "key": "type",775 "key": "type",

773 "optional": false,776 "docstring": "The event type, must be `session.updated`.",

774 "nullable": false,

775 "type": {777 "type": {

776 "kind": "HttpTypeUnion",778 "kind": "HttpTypeUnion",

779 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/type",

777 "types": [780 "types": [

778 {781 {

779 "kind": "HttpTypeLiteral",782 "kind": "HttpTypeLiteral",

780 "literal": "session.updated"783 "literal": "session.updated"

781 }784 }

782 ],785 ]

783 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/type"

784 },786 },

785 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionUpdated/properties/type",787 "optional": false,

786 "deprecated": false,788 "nullable": false,

787 "schemaType": "enum",789 "schemaType": "enum",

788 "childrenParentSchema": "enum",790 "childrenParentSchema": "enum",

789 "children": [791 "children": [

792 },794 },

793 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id": {795 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id": {

794 "kind": "HttpDeclProperty",796 "kind": "HttpDeclProperty",

795 "docstring": "Unique identifier for the session that looks like `sess_1234567890abcdef`.\n",797 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/id",

798 "deprecated": false,

796 "key": "id",799 "key": "id",

797 "optional": false,800 "docstring": "Unique identifier for the session that looks like `sess_1234567890abcdef`.\n",

798 "nullable": false,

799 "type": {801 "type": {

800 "kind": "HttpTypeString"802 "kind": "HttpTypeString"

801 },803 },

802 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/id",804 "optional": false,

803 "deprecated": false,805 "nullable": false,

804 "schemaType": "string",806 "schemaType": "string",

805 "children": []807 "children": []

806 },808 },

807 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio": {809 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio": {

808 "kind": "HttpDeclProperty",810 "kind": "HttpDeclProperty",

809 "docstring": "Configuration for translation input and output audio.\n",811 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio",

812 "deprecated": false,

810 "key": "audio",813 "key": "audio",

811 "optional": false,814 "docstring": "Configuration for translation input and output audio.\n",

812 "nullable": false,

813 "type": {815 "type": {

814 "kind": "HttpTypeObject",816 "kind": "HttpTypeObject",

815 "members": [817 "members": [

821 }823 }

822 ]824 ]

823 },825 },

824 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio",826 "optional": false,

825 "deprecated": false,827 "nullable": false,

826 "schemaType": "object",828 "schemaType": "object",

827 "childrenParentSchema": "object",829 "childrenParentSchema": "object",

828 "children": [830 "children": [

832 },834 },

833 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at": {835 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) expires_at": {

834 "kind": "HttpDeclProperty",836 "kind": "HttpDeclProperty",

835 "docstring": "Expiration timestamp for the session, in seconds since epoch.",837 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/expires_at",

838 "deprecated": false,

836 "key": "expires_at",839 "key": "expires_at",

837 "optional": false,840 "docstring": "Expiration timestamp for the session, in seconds since epoch.",

838 "nullable": false,

839 "type": {841 "type": {

840 "kind": "HttpTypeNumber"842 "kind": "HttpTypeNumber"

841 },843 },

842 "constraints": {844 "constraints": {

843 "format": "unixtime"845 "format": "unixtime"

844 },846 },

845 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/expires_at",847 "optional": false,

846 "deprecated": false,848 "nullable": false,

847 "schemaType": "integer",849 "schemaType": "integer",

848 "children": []850 "children": []

849 },851 },

850 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model": {852 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) model": {

851 "kind": "HttpDeclProperty",853 "kind": "HttpDeclProperty",

852 "docstring": "The Realtime translation model used for this session. This field is set at\nsession creation and cannot be changed with `session.update`.\n",854 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/model",

855 "deprecated": false,

853 "key": "model",856 "key": "model",

854 "optional": false,857 "docstring": "The Realtime translation model used for this session. This field is set at\nsession creation and cannot be changed with `session.update`.\n",

855 "nullable": false,

856 "type": {858 "type": {

857 "kind": "HttpTypeString"859 "kind": "HttpTypeString"

858 },860 },

859 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/model",861 "optional": false,

860 "deprecated": false,862 "nullable": false,

861 "schemaType": "string",863 "schemaType": "string",

862 "children": []864 "children": []

863 },865 },

864 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type": {866 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) type": {

865 "kind": "HttpDeclProperty",867 "kind": "HttpDeclProperty",

866 "docstring": "The session type. Always `translation` for Realtime translation sessions.\n",868 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",

869 "deprecated": false,

867 "key": "type",870 "key": "type",

868 "optional": false,871 "docstring": "The session type. Always `translation` for Realtime translation sessions.\n",

869 "nullable": false,

870 "type": {872 "type": {

871 "kind": "HttpTypeUnion",873 "kind": "HttpTypeUnion",

874 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",

872 "types": [875 "types": [

873 {876 {

874 "kind": "HttpTypeLiteral",877 "kind": "HttpTypeLiteral",

875 "literal": "translation"878 "literal": "translation"

876 }879 }

877 ],880 ]

878 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type"

879 },881 },

880 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/type",882 "optional": false,

881 "deprecated": false,883 "nullable": false,

882 "schemaType": "enum",884 "schemaType": "enum",

883 "childrenParentSchema": "enum",885 "childrenParentSchema": "enum",

884 "children": [886 "children": [

888 "(resource) realtime > (model) realtime_translation_session > (schema)": {890 "(resource) realtime > (model) realtime_translation_session > (schema)": {

889 "kind": "HttpDeclTypeAlias",891 "kind": "HttpDeclTypeAlias",

890 "oasRef": "#/components/schemas/RealtimeTranslationSession",892 "oasRef": "#/components/schemas/RealtimeTranslationSession",

893 "docstring": "A Realtime translation session. Translation sessions continuously translate input\naudio into the configured output language.\n",

891 "ident": "RealtimeTranslationSession",894 "ident": "RealtimeTranslationSession",

892 "type": {895 "type": {

893 "kind": "HttpTypeObject",896 "kind": "HttpTypeObject",

909 }912 }

910 ]913 ]

911 },914 },

912 "docstring": "A Realtime translation session. Translation sessions continuously translate input\naudio into the configured output language.\n",

913 "childrenParentSchema": "object",915 "childrenParentSchema": "object",

914 "children": [916 "children": [

915 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",917 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) id",

928 },930 },

929 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input": {931 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input": {

930 "kind": "HttpDeclProperty",932 "kind": "HttpDeclProperty",

933 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input",

934 "deprecated": false,

931 "key": "input",935 "key": "input",

932 "optional": true,

933 "nullable": false,

934 "type": {936 "type": {

935 "kind": "HttpTypeObject",937 "kind": "HttpTypeObject",

936 "members": [938 "members": [

942 }944 }

943 ]945 ]

944 },946 },

945 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input",947 "optional": true,

946 "deprecated": false,948 "nullable": false,

947 "schemaType": "object",949 "schemaType": "object",

948 "childrenParentSchema": "object",950 "childrenParentSchema": "object",

949 "children": [951 "children": [

953 },955 },

954 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output": {956 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output": {

955 "kind": "HttpDeclProperty",957 "kind": "HttpDeclProperty",

958 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output",

959 "deprecated": false,

956 "key": "output",960 "key": "output",

957 "optional": true,

958 "nullable": false,

959 "type": {961 "type": {

960 "kind": "HttpTypeObject",962 "kind": "HttpTypeObject",

961 "members": [963 "members": [

964 }966 }

965 ]967 ]

966 },968 },

967 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output",969 "optional": true,

968 "deprecated": false,970 "nullable": false,

969 "schemaType": "object",971 "schemaType": "object",

970 "childrenParentSchema": "object",972 "childrenParentSchema": "object",

971 "children": [973 "children": [

981 },983 },

982 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction": {984 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction": {

983 "kind": "HttpDeclProperty",985 "kind": "HttpDeclProperty",

984 "docstring": "Optional input noise reduction.\n",986 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction",

987 "deprecated": false,

985 "key": "noise_reduction",988 "key": "noise_reduction",

986 "optional": true,989 "docstring": "Optional input noise reduction.\n",

987 "nullable": true,

988 "type": {990 "type": {

989 "kind": "HttpTypeObject",991 "kind": "HttpTypeObject",

990 "members": [992 "members": [

993 }995 }

994 ]996 ]

995 },997 },

996 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction",998 "optional": true,

997 "deprecated": false,999 "nullable": true,

998 "schemaType": "object",1000 "schemaType": "object",

999 "childrenParentSchema": "object",1001 "childrenParentSchema": "object",

1000 "children": [1002 "children": [

1003 },1005 },

1004 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription": {1006 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription": {

1005 "kind": "HttpDeclProperty",1007 "kind": "HttpDeclProperty",

1006 "docstring": "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",1008 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription",

1009 "deprecated": false,

1007 "key": "transcription",1010 "key": "transcription",

1008 "optional": true,1011 "docstring": "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",

1009 "nullable": true,

1010 "type": {1012 "type": {

1011 "kind": "HttpTypeObject",1013 "kind": "HttpTypeObject",

1012 "members": [1014 "members": [

1015 }1017 }

1016 ]1018 ]

1017 },1019 },

1018 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription",1020 "optional": true,

1019 "deprecated": false,1021 "nullable": true,

1020 "schemaType": "object",1022 "schemaType": "object",

1021 "childrenParentSchema": "object",1023 "childrenParentSchema": "object",

1022 "children": [1024 "children": [

1025 },1027 },

1026 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language": {1028 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) output > (property) language": {

1027 "kind": "HttpDeclProperty",1029 "kind": "HttpDeclProperty",

1028 "docstring": "Target language for translated output audio and transcript deltas.\n",1030 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output/properties/language",

1031 "deprecated": false,

1029 "key": "language",1032 "key": "language",

1030 "optional": true,1033 "docstring": "Target language for translated output audio and transcript deltas.\n",

1031 "nullable": false,

1032 "type": {1034 "type": {

1033 "kind": "HttpTypeString"1035 "kind": "HttpTypeString"

1034 },1036 },

1035 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/output/properties/language",1037 "optional": true,

1036 "deprecated": false,1038 "nullable": false,

1037 "schemaType": "string",1039 "schemaType": "string",

1038 "children": []1040 "children": []

1039 },1041 },

1040 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type": {1042 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) noise_reduction > (property) type": {

1041 "kind": "HttpDeclProperty",1043 "kind": "HttpDeclProperty",

1042 "docstring": "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",1044 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction/anyOf/0/properties/type",

1045 "deprecated": false,

1043 "key": "type",1046 "key": "type",

1044 "optional": false,1047 "docstring": "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",

1045 "nullable": false,

1046 "type": {1048 "type": {

1047 "kind": "HttpTypeReference",1049 "kind": "HttpTypeReference",

1048 "ident": "NoiseReductionType",1050 "ident": "NoiseReductionType",

1049 "$ref": "(resource) realtime > (model) noise_reduction_type > (schema)"1051 "$ref": "(resource) realtime > (model) noise_reduction_type > (schema)"

1050 },1052 },

1051 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/noise_reduction/anyOf/0/properties/type",1053 "optional": false,

1052 "deprecated": false,1054 "nullable": false,

1053 "schemaType": "enum",

1054 "modelImplicit": false,1055 "modelImplicit": false,

1056 "schemaType": "enum",

1055 "modelPath": "(resource) realtime > (model) noise_reduction_type",1057 "modelPath": "(resource) realtime > (model) noise_reduction_type",

1056 "childrenParentSchema": "enum",1058 "childrenParentSchema": "enum",

1057 "children": [1059 "children": [

1061 },1063 },

1062 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model": {1064 "(resource) realtime > (model) realtime_translation_session > (schema) > (property) audio > (property) input > (property) transcription > (property) model": {

1063 "kind": "HttpDeclProperty",1065 "kind": "HttpDeclProperty",

1064 "docstring": "The transcription model used for source transcript deltas.",1066 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription/anyOf/0/properties/model",

1067 "deprecated": false,

1065 "key": "model",1068 "key": "model",

1066 "optional": false,1069 "docstring": "The transcription model used for source transcript deltas.",

1067 "nullable": false,

1068 "type": {1070 "type": {

1069 "kind": "HttpTypeString"1071 "kind": "HttpTypeString"

1070 },1072 },

1071 "oasRef": "#/components/schemas/RealtimeTranslationSession/properties/audio/properties/input/properties/transcription/anyOf/0/properties/model",1073 "optional": false,

1072 "deprecated": false,1074 "nullable": false,

1073 "schemaType": "string",1075 "schemaType": "string",

1074 "children": []1076 "children": []

1075 },1077 },

1090 "(resource) realtime > (model) noise_reduction_type > (schema)": {1092 "(resource) realtime > (model) noise_reduction_type > (schema)": {

1091 "kind": "HttpDeclTypeAlias",1093 "kind": "HttpDeclTypeAlias",

1092 "oasRef": "#/components/schemas/NoiseReductionType",1094 "oasRef": "#/components/schemas/NoiseReductionType",

1095 "docstring": "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",

1093 "ident": "NoiseReductionType",1096 "ident": "NoiseReductionType",

1094 "type": {1097 "type": {

1095 "kind": "HttpTypeUnion",1098 "kind": "HttpTypeUnion",

1099 "oasRef": "#/components/schemas/NoiseReductionType",

1096 "types": [1100 "types": [

1097 {1101 {

1098 "kind": "HttpTypeLiteral",1102 "kind": "HttpTypeLiteral",

1102 "kind": "HttpTypeLiteral",1106 "kind": "HttpTypeLiteral",

1103 "literal": "far_field"1107 "literal": "far_field"

1104 }1108 }

1105 ],1109 ]

1106 "oasRef": "#/components/schemas/NoiseReductionType"

1107 },1110 },

1108 "docstring": "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",

1109 "childrenParentSchema": "enum",1111 "childrenParentSchema": "enum",

1110 "children": [1112 "children": [

1111 "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",1113 "(resource) realtime > (model) noise_reduction_type > (schema) > (member) 0",

1157 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema)": {1159 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema)": {

1158 "kind": "HttpDeclTypeAlias",1160 "kind": "HttpDeclTypeAlias",

1159 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed",1161 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed",

1162 "docstring": "Returned when a realtime translation session is closed.\n",

1160 "ident": "RealtimeTranslationSessionClosedEvent",1163 "ident": "RealtimeTranslationSessionClosedEvent",

1161 "type": {1164 "type": {

1162 "kind": "HttpTypeObject",1165 "kind": "HttpTypeObject",

1169 }1172 }

1170 ]1173 ]

1171 },1174 },

1172 "docstring": "Returned when a realtime translation session is closed.\n",

1173 "childrenParentSchema": "object",1175 "childrenParentSchema": "object",

1174 "children": [1176 "children": [

1175 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) event_id",1177 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) event_id",

1178 },1180 },

1179 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) event_id": {1181 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) event_id": {

1180 "kind": "HttpDeclProperty",1182 "kind": "HttpDeclProperty",

1181 "docstring": "The unique ID of the server event.",1183 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/event_id",

1184 "deprecated": false,

1182 "key": "event_id",1185 "key": "event_id",

1183 "optional": false,1186 "docstring": "The unique ID of the server event.",

1184 "nullable": false,

1185 "type": {1187 "type": {

1186 "kind": "HttpTypeString"1188 "kind": "HttpTypeString"

1187 },1189 },

1188 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/event_id",1190 "optional": false,

1189 "deprecated": false,1191 "nullable": false,

1190 "schemaType": "string",1192 "schemaType": "string",

1191 "children": []1193 "children": []

1192 },1194 },

1193 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) type": {1195 "(resource) realtime > (model) realtime_translation_session_closed_event > (schema) > (property) type": {

1194 "kind": "HttpDeclProperty",1196 "kind": "HttpDeclProperty",

1195 "docstring": "The event type, must be `session.closed`.",1197 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/type",

1198 "deprecated": false,

1196 "key": "type",1199 "key": "type",

1197 "optional": false,1200 "docstring": "The event type, must be `session.closed`.",

1198 "nullable": false,

1199 "type": {1201 "type": {

1200 "kind": "HttpTypeUnion",1202 "kind": "HttpTypeUnion",

1203 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/type",

1201 "types": [1204 "types": [

1202 {1205 {

1203 "kind": "HttpTypeLiteral",1206 "kind": "HttpTypeLiteral",

1204 "literal": "session.closed"1207 "literal": "session.closed"

1205 }1208 }

1206 ],1209 ]

1207 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/type"

1208 },1210 },

1209 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionClosed/properties/type",1211 "optional": false,

1210 "deprecated": false,1212 "nullable": false,

1211 "schemaType": "enum",1213 "schemaType": "enum",

1212 "childrenParentSchema": "enum",1214 "childrenParentSchema": "enum",

1213 "children": [1215 "children": [

1250 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema)": {1252 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema)": {

1251 "kind": "HttpDeclTypeAlias",1253 "kind": "HttpDeclTypeAlias",

1252 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta",1254 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta",

1255 "docstring": "Returned when optional source-language transcript text is available. This event\nis emitted only when `audio.input.transcription` is configured.\n\nTranscript deltas are append-only text fragments. Clients should not insert\nunconditional spaces between deltas.\n",

1253 "ident": "RealtimeTranslationInputTranscriptDeltaEvent",1256 "ident": "RealtimeTranslationInputTranscriptDeltaEvent",

1254 "type": {1257 "type": {

1255 "kind": "HttpTypeObject",1258 "kind": "HttpTypeObject",

1268 }1271 }

1269 ]1272 ]

1270 },1273 },

1271 "docstring": "Returned when optional source-language transcript text is available. This event\nis emitted only when `audio.input.transcription` is configured.\n\nTranscript deltas are append-only text fragments. Clients should not insert\nunconditional spaces between deltas.\n",

1272 "childrenParentSchema": "object",1274 "childrenParentSchema": "object",

1273 "children": [1275 "children": [

1274 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) delta",1276 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) delta",

1279 },1281 },

1280 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) delta": {1282 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) delta": {

1281 "kind": "HttpDeclProperty",1283 "kind": "HttpDeclProperty",

1282 "docstring": "Append-only source-language transcript text.",1284 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/delta",

1285 "deprecated": false,

1283 "key": "delta",1286 "key": "delta",

1284 "optional": false,1287 "docstring": "Append-only source-language transcript text.",

1285 "nullable": false,

1286 "type": {1288 "type": {

1287 "kind": "HttpTypeString"1289 "kind": "HttpTypeString"

1288 },1290 },

1289 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/delta",1291 "optional": false,

1290 "deprecated": false,1292 "nullable": false,

1291 "schemaType": "string",1293 "schemaType": "string",

1292 "children": []1294 "children": []

1293 },1295 },

1294 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) event_id": {1296 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) event_id": {

1295 "kind": "HttpDeclProperty",1297 "kind": "HttpDeclProperty",

1296 "docstring": "The unique ID of the server event.",1298 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/event_id",

1299 "deprecated": false,

1297 "key": "event_id",1300 "key": "event_id",

1298 "optional": false,1301 "docstring": "The unique ID of the server event.",

1299 "nullable": false,

1300 "type": {1302 "type": {

1301 "kind": "HttpTypeString"1303 "kind": "HttpTypeString"

1302 },1304 },

1303 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/event_id",1305 "optional": false,

1304 "deprecated": false,1306 "nullable": false,

1305 "schemaType": "string",1307 "schemaType": "string",

1306 "children": []1308 "children": []

1307 },1309 },

1308 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) type": {1310 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) type": {

1309 "kind": "HttpDeclProperty",1311 "kind": "HttpDeclProperty",

1310 "docstring": "The event type, must be `session.input_transcript.delta`.",1312 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/type",

1313 "deprecated": false,

1311 "key": "type",1314 "key": "type",

1312 "optional": false,1315 "docstring": "The event type, must be `session.input_transcript.delta`.",

1313 "nullable": false,

1314 "type": {1316 "type": {

1315 "kind": "HttpTypeUnion",1317 "kind": "HttpTypeUnion",

1318 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/type",

1316 "types": [1319 "types": [

1317 {1320 {

1318 "kind": "HttpTypeLiteral",1321 "kind": "HttpTypeLiteral",

1319 "literal": "session.input_transcript.delta"1322 "literal": "session.input_transcript.delta"

1320 }1323 }

1321 ],1324 ]

1322 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/type"

1323 },1325 },

1324 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/type",1326 "optional": false,

1325 "deprecated": false,1327 "nullable": false,

1326 "schemaType": "enum",1328 "schemaType": "enum",

1327 "childrenParentSchema": "enum",1329 "childrenParentSchema": "enum",

1328 "children": [1330 "children": [

1331 },1333 },

1332 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) elapsed_ms": {1334 "(resource) realtime > (model) realtime_translation_input_transcript_delta_event > (schema) > (property) elapsed_ms": {

1333 "kind": "HttpDeclProperty",1335 "kind": "HttpDeclProperty",

1334 "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. It advances in 200 ms increments, but multiple transcript\ndeltas may share the same `elapsed_ms`. Treat it as alignment metadata,\nnot a unique transcript-delta identifier.\n",1336 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/elapsed_ms",

1337 "deprecated": false,

1335 "key": "elapsed_ms",1338 "key": "elapsed_ms",

1336 "optional": true,1339 "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. It advances in 200 ms increments, but multiple transcript\ndeltas may share the same `elapsed_ms`. Treat it as alignment metadata,\nnot a unique transcript-delta identifier.\n",

1337 "nullable": true,

1338 "type": {1340 "type": {

1339 "kind": "HttpTypeNumber"1341 "kind": "HttpTypeNumber"

1340 },1342 },

1341 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionInputTranscriptDelta/properties/elapsed_ms",1343 "optional": true,

1342 "deprecated": false,1344 "nullable": true,

1343 "schemaType": "integer",1345 "schemaType": "integer",

1344 "children": []1346 "children": []

1345 },1347 },

1380 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema)": {1382 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema)": {

1381 "kind": "HttpDeclTypeAlias",1383 "kind": "HttpDeclTypeAlias",

1382 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta",1384 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta",

1385 "docstring": "Returned when translated transcript text is available.\n\nTranscript deltas are append-only text fragments. Clients should not insert\nunconditional spaces between deltas.\n",

1383 "ident": "RealtimeTranslationOutputTranscriptDeltaEvent",1386 "ident": "RealtimeTranslationOutputTranscriptDeltaEvent",

1384 "type": {1387 "type": {

1385 "kind": "HttpTypeObject",1388 "kind": "HttpTypeObject",

1398 }1401 }

1399 ]1402 ]

1400 },1403 },

1401 "docstring": "Returned when translated transcript text is available.\n\nTranscript deltas are append-only text fragments. Clients should not insert\nunconditional spaces between deltas.\n",

1402 "childrenParentSchema": "object",1404 "childrenParentSchema": "object",

1403 "children": [1405 "children": [

1404 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) delta",1406 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) delta",

1409 },1411 },

1410 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) delta": {1412 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) delta": {

1411 "kind": "HttpDeclProperty",1413 "kind": "HttpDeclProperty",

1412 "docstring": "Append-only transcript text for the translated output audio.",1414 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/delta",

1415 "deprecated": false,

1413 "key": "delta",1416 "key": "delta",

1414 "optional": false,1417 "docstring": "Append-only transcript text for the translated output audio.",

1415 "nullable": false,

1416 "type": {1418 "type": {

1417 "kind": "HttpTypeString"1419 "kind": "HttpTypeString"

1418 },1420 },

1419 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/delta",1421 "optional": false,

1420 "deprecated": false,1422 "nullable": false,

1421 "schemaType": "string",1423 "schemaType": "string",

1422 "children": []1424 "children": []

1423 },1425 },

1424 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) event_id": {1426 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) event_id": {

1425 "kind": "HttpDeclProperty",1427 "kind": "HttpDeclProperty",

1426 "docstring": "The unique ID of the server event.",1428 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/event_id",

1429 "deprecated": false,

1427 "key": "event_id",1430 "key": "event_id",

1428 "optional": false,1431 "docstring": "The unique ID of the server event.",

1429 "nullable": false,

1430 "type": {1432 "type": {

1431 "kind": "HttpTypeString"1433 "kind": "HttpTypeString"

1432 },1434 },

1433 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/event_id",1435 "optional": false,

1434 "deprecated": false,1436 "nullable": false,

1435 "schemaType": "string",1437 "schemaType": "string",

1436 "children": []1438 "children": []

1437 },1439 },

1438 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) type": {1440 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) type": {

1439 "kind": "HttpDeclProperty",1441 "kind": "HttpDeclProperty",

1440 "docstring": "The event type, must be `session.output_transcript.delta`.",1442 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/type",

1443 "deprecated": false,

1441 "key": "type",1444 "key": "type",

1442 "optional": false,1445 "docstring": "The event type, must be `session.output_transcript.delta`.",

1443 "nullable": false,

1444 "type": {1446 "type": {

1445 "kind": "HttpTypeUnion",1447 "kind": "HttpTypeUnion",

1448 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/type",

1446 "types": [1449 "types": [

1447 {1450 {

1448 "kind": "HttpTypeLiteral",1451 "kind": "HttpTypeLiteral",

1449 "literal": "session.output_transcript.delta"1452 "literal": "session.output_transcript.delta"

1450 }1453 }

1451 ],1454 ]

1452 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/type"

1453 },1455 },

1454 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/type",1456 "optional": false,

1455 "deprecated": false,1457 "nullable": false,

1456 "schemaType": "enum",1458 "schemaType": "enum",

1457 "childrenParentSchema": "enum",1459 "childrenParentSchema": "enum",

1458 "children": [1460 "children": [

1461 },1463 },

1462 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) elapsed_ms": {1464 "(resource) realtime > (model) realtime_translation_output_transcript_delta_event > (schema) > (property) elapsed_ms": {

1463 "kind": "HttpDeclProperty",1465 "kind": "HttpDeclProperty",

1464 "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. It advances in 200 ms increments, but multiple transcript\ndeltas may share the same `elapsed_ms`. Treat it as alignment metadata,\nnot a unique transcript-delta identifier.\n",1466 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/elapsed_ms",

1467 "deprecated": false,

1465 "key": "elapsed_ms",1468 "key": "elapsed_ms",

1466 "optional": true,1469 "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. It advances in 200 ms increments, but multiple transcript\ndeltas may share the same `elapsed_ms`. Treat it as alignment metadata,\nnot a unique transcript-delta identifier.\n",

1467 "nullable": true,

1468 "type": {1470 "type": {

1469 "kind": "HttpTypeNumber"1471 "kind": "HttpTypeNumber"

1470 },1472 },

1471 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputTranscriptDelta/properties/elapsed_ms",1473 "optional": true,

1472 "deprecated": false,1474 "nullable": true,

1473 "schemaType": "integer",1475 "schemaType": "integer",

1474 "children": []1476 "children": []

1475 },1477 },

1508 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema)": {1510 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema)": {

1509 "kind": "HttpDeclTypeAlias",1511 "kind": "HttpDeclTypeAlias",

1510 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta",1512 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta",

1513 "docstring": "Returned when translated output audio is available. Output audio deltas are\n200 ms frames of PCM16 audio.\n",

1511 "ident": "RealtimeTranslationOutputAudioDeltaEvent",1514 "ident": "RealtimeTranslationOutputAudioDeltaEvent",

1512 "type": {1515 "type": {

1513 "kind": "HttpTypeObject",1516 "kind": "HttpTypeObject",

1535 }1538 }

1536 ]1539 ]

1537 },1540 },

1538 "docstring": "Returned when translated output audio is available. Output audio deltas are\n200 ms frames of PCM16 audio.\n",

1539 "childrenParentSchema": "object",1541 "childrenParentSchema": "object",

1540 "children": [1542 "children": [

1541 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) delta",1543 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) delta",

1549 },1551 },

1550 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) delta": {1552 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) delta": {

1551 "kind": "HttpDeclProperty",1553 "kind": "HttpDeclProperty",

1552 "docstring": "Base64-encoded translated audio data.",1554 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/delta",

1555 "deprecated": false,

1553 "key": "delta",1556 "key": "delta",

1554 "optional": false,1557 "docstring": "Base64-encoded translated audio data.",

1555 "nullable": false,

1556 "type": {1558 "type": {

1557 "kind": "HttpTypeString"1559 "kind": "HttpTypeString"

1558 },1560 },

1559 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/delta",1561 "optional": false,

1560 "deprecated": false,1562 "nullable": false,

1561 "schemaType": "string",1563 "schemaType": "string",

1562 "children": []1564 "children": []

1563 },1565 },

1564 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) event_id": {1566 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) event_id": {

1565 "kind": "HttpDeclProperty",1567 "kind": "HttpDeclProperty",

1566 "docstring": "The unique ID of the server event.",1568 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/event_id",

1569 "deprecated": false,

1567 "key": "event_id",1570 "key": "event_id",

1568 "optional": false,1571 "docstring": "The unique ID of the server event.",

1569 "nullable": false,

1570 "type": {1572 "type": {

1571 "kind": "HttpTypeString"1573 "kind": "HttpTypeString"

1572 },1574 },

1573 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/event_id",1575 "optional": false,

1574 "deprecated": false,1576 "nullable": false,

1575 "schemaType": "string",1577 "schemaType": "string",

1576 "children": []1578 "children": []

1577 },1579 },

1578 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) type": {1580 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) type": {

1579 "kind": "HttpDeclProperty",1581 "kind": "HttpDeclProperty",

1580 "docstring": "The event type, must be `session.output_audio.delta`.",1582 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/type",

1583 "deprecated": false,

1581 "key": "type",1584 "key": "type",

1582 "optional": false,1585 "docstring": "The event type, must be `session.output_audio.delta`.",

1583 "nullable": false,

1584 "type": {1586 "type": {

1585 "kind": "HttpTypeUnion",1587 "kind": "HttpTypeUnion",

1588 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/type",

1586 "types": [1589 "types": [

1587 {1590 {

1588 "kind": "HttpTypeLiteral",1591 "kind": "HttpTypeLiteral",

1589 "literal": "session.output_audio.delta"1592 "literal": "session.output_audio.delta"

1590 }1593 }

1591 ],1594 ]

1592 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/type"

1593 },1595 },

1594 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/type",1596 "optional": false,

1595 "deprecated": false,1597 "nullable": false,

1596 "schemaType": "enum",1598 "schemaType": "enum",

1597 "childrenParentSchema": "enum",1599 "childrenParentSchema": "enum",

1598 "children": [1600 "children": [

1601 },1603 },

1602 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) channels": {1604 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) channels": {

1603 "kind": "HttpDeclProperty",1605 "kind": "HttpDeclProperty",

1604 "docstring": "Number of audio channels.",1606 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/channels",

1607 "deprecated": false,

1605 "key": "channels",1608 "key": "channels",

1606 "optional": true,1609 "docstring": "Number of audio channels.",

1607 "nullable": false,

1608 "default": 1,

1609 "type": {1610 "type": {

1610 "kind": "HttpTypeNumber"1611 "kind": "HttpTypeNumber"

1611 },1612 },

1612 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/channels",1613 "default": 1,

1613 "deprecated": false,1614 "optional": true,

1615 "nullable": false,

1614 "schemaType": "integer",1616 "schemaType": "integer",

1615 "children": []1617 "children": []

1616 },1618 },

1617 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) elapsed_ms": {1619 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) elapsed_ms": {

1618 "kind": "HttpDeclProperty",1620 "kind": "HttpDeclProperty",

1619 "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. Treat `elapsed_ms` as alignment metadata, not a unique\nevent identifier.\n",1621 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/elapsed_ms",

1622 "deprecated": false,

1620 "key": "elapsed_ms",1623 "key": "elapsed_ms",

1621 "optional": true,1624 "docstring": "Timing metadata for stream alignment, derived from the translation frame\nwhen available. Treat `elapsed_ms` as alignment metadata, not a unique\nevent identifier.\n",

1622 "nullable": true,

1623 "type": {1625 "type": {

1624 "kind": "HttpTypeNumber"1626 "kind": "HttpTypeNumber"

1625 },1627 },

1626 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/elapsed_ms",1628 "optional": true,

1627 "deprecated": false,1629 "nullable": true,

1628 "schemaType": "integer",1630 "schemaType": "integer",

1629 "children": []1631 "children": []

1630 },1632 },

1631 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) format": {1633 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) format": {

1632 "kind": "HttpDeclProperty",1634 "kind": "HttpDeclProperty",

1633 "docstring": "Audio encoding for `delta`.",1635 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/format",

1636 "deprecated": false,

1634 "key": "format",1637 "key": "format",

1635 "optional": true,1638 "docstring": "Audio encoding for `delta`.",

1636 "nullable": false,

1637 "type": {1639 "type": {

1638 "kind": "HttpTypeUnion",1640 "kind": "HttpTypeUnion",

1641 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/format",

1639 "types": [1642 "types": [

1640 {1643 {

1641 "kind": "HttpTypeLiteral",1644 "kind": "HttpTypeLiteral",

1642 "literal": "pcm16"1645 "literal": "pcm16"

1643 }1646 }

1644 ],1647 ]

1645 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/format"

1646 },1648 },

1647 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/format",1649 "optional": true,

1648 "deprecated": false,1650 "nullable": false,

1649 "schemaType": "enum",1651 "schemaType": "enum",

1650 "childrenParentSchema": "enum",1652 "childrenParentSchema": "enum",

1651 "children": [1653 "children": [

1654 },1656 },

1655 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) sample_rate": {1657 "(resource) realtime > (model) realtime_translation_output_audio_delta_event > (schema) > (property) sample_rate": {

1656 "kind": "HttpDeclProperty",1658 "kind": "HttpDeclProperty",

1657 "docstring": "Sample rate of the audio delta.",1659 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/sample_rate",

1660 "deprecated": false,

1658 "key": "sample_rate",1661 "key": "sample_rate",

1659 "optional": true,1662 "docstring": "Sample rate of the audio delta.",

1660 "nullable": false,

1661 "default": 24000,

1662 "type": {1663 "type": {

1663 "kind": "HttpTypeNumber"1664 "kind": "HttpTypeNumber"

1664 },1665 },

1665 "oasRef": "#/components/schemas/RealtimeTranslationServerEventSessionOutputAudioDelta/properties/sample_rate",1666 "default": 24000,

1666 "deprecated": false,1667 "optional": true,

1668 "nullable": false,

1667 "schemaType": "integer",1669 "schemaType": "integer",

1668 "children": []1670 "children": []

1669 },1671 },

resources/realtime/translation-server-events.md 2026-07-25 05:59 UTC to 2026-07-29 15:02 UTC

Realtime translation server events

error

Schema

Example

session.created

Schema

Example

session.updated

Schema

Example

session.closed

Schema

Example

session.input_transcript.delta

Schema

Example

session.output_transcript.delta

Schema

Example

session.output_audio.delta

Schema

Example