Skip to main content

Installation

Make sure the OpenAI SDK is installed:
pip install openai
Make sure the Voker SDK is installed:
pip install voker
Voker does not currently support Audio, Video, or Image modalities.

Usage

Replace your existing OpenAI import with the Voker-wrapped version, then add the required Voker metadata fields to each call you want to track.

Chat Completions

from openai import OpenAI 
from voker.ai.provider_openai import OpenAI 

client = OpenAI()

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

Async Chat Completions

from openai import AsyncOpenAI 
from voker.ai.provider_openai import AsyncOpenAI 

client = AsyncOpenAI()

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

Responses API

from openai import OpenAI 
from voker.ai.provider_openai import OpenAI 

client = OpenAI()

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

Async Responses API

from openai import AsyncOpenAI 
from voker.ai.provider_openai import AsyncOpenAI 

client = AsyncOpenAI()

await client.responses.create(
  voker_agent="customer-support-agent", # required
  voker_session="user-session-1",       # required
  model="gpt-4.1-mini",
  input="Hello, world!",
)
Use voker_agent to identify which agent made the call, and voker_session to tie calls to a specific user session.

Next steps