Options for the OpenAI GPT-Live full-duplex voice model.

interface GPTLiveModelOptions {
    apiKey?: string;
    baseURL?: string;
    connOptions?: APIConnectOptions;
    delegation?: DelegationTarget;
    maxSessionDuration?: null | number;
    model?: string;
    responsesOptions?: ResponsesDelegationOptions;
    voice?: Record<string, unknown> | GPTLiveVoices | string & {};
}

Properties

apiKey?: string

Falls back to OPENAI_API_KEY.

baseURL?: string

Falls back to OPENAI_BASE_URL, then https://api.openai.com/v1.

connOptions?: APIConnectOptions

Connection/startup timeout and retry limits. Defaults to DEFAULT_API_CONNECT_OPTIONS.

delegation?: DelegationTarget

Fixed at startup. Client delegation requires an agent with no tools.

maxSessionDuration?: null | number

Recycle the connection after this many milliseconds. Null (the default) disables the timer.

model?: string

Voice model identifier. Defaults to gpt-live-1.

responsesOptions?: ResponsesDelegationOptions

Backend configuration when delegation is responses (the default).

voice?: Record<string, unknown> | GPTLiveVoices | string & {}

A named voice (marin by default), or an authorized custom voice object. Fixed at startup. Names pass through unchanged.