> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voker.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate Voker with OpenAI

## Installation

<Tabs>
  <Tab title="Python">
    Make sure the OpenAI SDK is installed:

    <CodeGroup>
      ```bash pip theme={null}
      pip install openai
      ```

      ```bash uv theme={null}
      uv add openai
      ```

      ```bash poetry theme={null}
      poetry add openai
      ```
    </CodeGroup>

    Make sure the Voker Python SDK is [installed](/sdks/python#installation).
  </Tab>

  <Tab title="TypeScript">
    Make sure the OpenAI SDK is installed:

    <CodeGroup>
      ```bash npm theme={null}
      npm install openai
      ```

      ```bash pnpm theme={null}
      pnpm add openai
      ```

      ```bash bun theme={null}
      bun add openai
      ```

      ```bash yarn theme={null}
      yarn add openai
      ```
    </CodeGroup>

    Make sure the Voker TypeScript SDK is [installed](/sdks/typescript#installation).
  </Tab>
</Tabs>

<Note>the SDK does not currently support Audio, Video or Image modalities.</Note>

## Usage

<Tabs>
  <Tab title="Python">
    ### Chat Completions

    ```py theme={null}
    from openai import OpenAI  # [!code --]
    from voker.ai.provider_openai import OpenAI  # [!code ++]

    client = OpenAI()

    client.chat.completions.create(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gpt-4.1-mini",
        messages=[
            {
                "role": "user",
                "content": "Hello, world!",
            }
        ],
    )
    ```

    ### Async Chat Completions

    ```py theme={null}
    from openai import AsyncOpenAI  # [!code --]
    from voker.ai.provider_openai import AsyncOpenAI  # [!code ++]

    client = AsyncOpenAI()

    await client.chat.completions.create(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gpt-4.1-mini",
        messages=[
            {
                "role": "user",
                "content": "Hello, world!",
            }
        ],
    )
    ```

    ### Responses

    ```py theme={null}
    from openai import OpenAI  # [!code --]
    from voker.ai.provider_openai import OpenAI  # [!code ++]

    client = OpenAI()

    client.responses.create(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gpt-4.1-mini",
        input="Hello, world!",
    )
    ```

    ### Async Responses

    ```py theme={null}
    from openai import AsyncOpenAI  # [!code --]
    from voker.ai.provider_openai import AsyncOpenAI  # [!code ++]

    client = AsyncOpenAI()

    await client.responses.create(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gpt-4.1-mini",
        input="Hello, world!",
    )
    ```
  </Tab>

  <Tab title="TypeScript">
    ### Chat Completions

    ```ts theme={null}
    import { OpenAI } from 'openai'; // [!code --]
    import { OpenAI } from '@voker/voker/ai/provider-openai'; // [!code ++]

    const client = new OpenAI();

    await client.chat.completions.create({
        vokerAgent: 'customer-support-agent', // required // [!code ++]
        vokerSession: 'user-session-1', // required // [!code ++]
        model: 'gpt-4o',
        messages: [
            {
                role: 'user',
                content: 'Hello, world!',
            },
        ],
    });
    ```

    ### Responses

    ```ts theme={null}
    import { OpenAI } from 'openai'; // [!code --]
    import { OpenAI } from '@voker/voker/ai/provider-openai'; // [!code ++]

    const client = new OpenAI();

    await client.responses.create({
        vokerAgent: 'customer-support-agent', // required // [!code ++]
        vokerSession: 'user-session-1', // required // [!code ++]
        model: 'gpt-4o',
        input: 'Hello, world!',
    });
    ```
  </Tab>
</Tabs>

## Next steps

* [Python SDK reference](/sdks/python) - environment setup, API key configuration, and full method reference.
* [TypeScript SDK reference](/sdks/typescript) - installation, configuration, and type definitions.