ai() API

LLM provider, model, media, routing, and embedding APIs.

Most Used

`ai`

Create a provider client from a provider name and options.

Field	Value
Kind	`function`
Ax concept	`ai`
API section	AxAI
Form	`ai(provider='openai', **options)`
Returns	AI client/service

Important Options

api key
model
api URL
headers
transport

Examples

Python

client = ai("openai", api_key=os.environ["OPENAI_API_KEY"])

Full reference

`OpenAICompatibleClient`

OpenAI-compatible chat, stream, embedding, audio, and realtime provider boundary.

Field	Value
Kind	`type`
Ax concept	`OpenAICompatibleClient`
API section	AxAI
Form	`OpenAICompatibleClient(options=None)`
Returns	provider client

Important Options

api key
model
base URL
transport

Full reference

`OpenAIResponsesClient`

OpenAI Responses provider mapping using the same Core-owned request and response contract.

Field	Value
Kind	`type`
Ax concept	`OpenAIResponsesClient`
API section	AxAI
Form	`OpenAIResponsesClient(options=None)`
Returns	provider client

Important Options

api key
model
audio
realtime

Full reference

`GoogleGeminiClient`

Gemini provider mapping for chat, streaming, media, tools, embeddings, and usage normalization.

Field	Value
Kind	`type`
Ax concept	`GoogleGeminiClient`
API section	AxAI
Form	`GoogleGeminiClient(options=None)`
Returns	provider client

Important Options

api key
model
embed model

Full reference

`AnthropicClient`

Anthropic provider mapping for messages, thinking, cache control, streaming, and usage normalization.

Field	Value
Kind	`type`
Ax concept	`AnthropicClient`
API section	AxAI
Form	`AnthropicClient(options=None)`
Returns	provider client

Important Options

api key
model
thinking
cache control

Full reference

`AxBalancer`

Retry and route requests across multiple provider services while preserving Ax request shape.

Field	Value
Kind	`type`
Ax concept	`AxBalancer`
API section	AxAI
Form	`AxBalancer(services, options=None)`
Returns	AI service

Important Options

services
retry policy
capability requirements

Full reference

`MultiServiceRouter`

Choose a service by capability or model routing policy.

Field	Value
Kind	`type`
Ax concept	`MultiServiceRouter`
API section	AxAI
Form	`MultiServiceRouter(services)`
Returns	AI service

Important Options

services
routing

Full reference

`ProviderRouter`

Route provider requests to registered provider clients.

Field	Value
Kind	`type`
Ax concept	`ProviderRouter`
API section	AxAI
Form	`ProviderRouter(providers, routing=None, processing=None)`
Returns	AI service

Important Options

providers
routing
processing

Full reference

Full Reference

Open the full Python reference. This page highlights the ai symbols most relevant to everyday use.