ai() API

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

Most Used

`ai`

Create a provider client from a named deployment profile 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 or credential provider
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, with opt-in adaptive cost, reliability, and deadline routing.

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
adaptive strategy

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 requests by capability, preserving native media for supporting providers and degrading only when required.

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

Advanced / internals / full reference

`typesafe`

Create the native Typesafe/Jev client separately from ordinary AI services. Default model: jev-latest.

Field	Value
Kind	`function`
Ax concept	`typesafe`
API section	AxAI
Form	`typesafe(options)`
Returns	AxAITypesafeClient

Important Options

api key or credential provider
endpoint
transport
timeout
retry

Full reference

`AxAITypesafeClient`

Native System One questions and model discovery. Returns typed Noul probabilities, Choice labels, fractional Score positions, model, and usage.

Field	Value
Kind	`type`
Ax concept	`AxAITypesafeClient`
API section	AxAI
Form	`AxAITypesafeClient`
Returns	native Typesafe responses

Important Options

system_one / systemOne / SystemOne
list_models / listModels / ListModels
structured or null entries
cancellation

Full reference

`AxCancellationToken`

Reusable one-shot cancellation for provider calls, streams, retries, and event-clock sleeps. Go uses context.Context.

Field	Value
Kind	`type`
Ax concept	`AxCancellationToken`
API section	AxAI
Form	`AxCancellationToken()`
Returns	cancellation token or context

Important Options

first reason wins
removable wake subscriptions
non-retryable cancellation

Full reference

`AxAIServiceAbortedError`

Terminal provider error raised when caller cancellation is observed.

Field	Value
Kind	`error`
Ax concept	`AxAIServiceAbortedError`
API section	AxAI
Form	`AxAIServiceAbortedError(reason)`
Returns	non-retryable provider error

Important Options

reason preservation
no retry
no provider failover

Full reference

`get_supported_ai_models`

Return the AxIR-backed provider and model catalog, including dynamic named profiles and portable capability metadata.

Field	Value
Kind	`function`
Ax concept	`get_supported_ai_models`
API section	AxAI
Form	`get_supported_ai_models(model_type=None)`
Returns	provider catalog entries

Important Options

type filter
thinkingLevels
serviceTiers
isDynamic

Examples

Python

catalog = get_supported_ai_models()

Full reference

`dict[str, str]`

Request metadata passed to a renewable credential callback for every transport attempt.

Field	Value
Kind	`type`
Ax concept	`AxCredentialRequest`
API section	AxAI
Form	`dict[str, str]`
Returns	credential request

Important Options

profile
operation
method
URL

Full reference

`Callable[[dict[str, str]], dict[str, str]]`

Return fresh request headers that override static profile authentication.

Field	Value
Kind	`interface`
Ax concept	`AxCredentialProvider`
API section	AxAI
Form	`Callable[[dict[str, str]], dict[str, str]]`
Returns	header map or credential error

Important Options

chat
stream
embeddings
Responses
audio
retries

Full reference

`AIClient.owned_worker_factory`

Optional factory for an independent client worker with preserved configuration, authentication and routing. Built-in providers supply it; custom services may omit it without changing chat compatibility.

Field	Value
Kind	`method`
Ax concept	`owned_client_factory`
API section	AxAI
Form	`AIClient.owned_worker_factory()`
Returns	worker factory or unavailable

Important Options

owned configuration
shared balancer accounting
no borrowed client transfer

Full reference

`AxChatSession`

Optional normalized session capability for custom provider adapters. High-level programs own tool execution and continuation; chat-only services remain supported.

Field	Value
Kind	`interface`
Ax concept	`AxChatSession`
API section	AxAI
Form	`AxChatSession`
Returns	run-owned chat session

Important Options

normalized events
completed calls
submit results
steering
reasoning updates
close

Full reference

`closable generator`

Incremental, closeable provider event stream. Retry and failover stop once content is delivered.

Field	Value
Kind	`type`
Ax concept	`AxProviderStream`
API section	AxAI
Form	`client.stream(request)`
Returns	incremental chat events

Important Options

next event
terminal error
consumer cancellation
upstream close

Examples

Python

for event in client.stream(request): handle(event)

Full reference

`AxUsageContext`

Application attribution merged from service defaults and per-call overrides.

Field	Value
Kind	`type`
Ax concept	`AxUsageContext`
API section	AxAI
Form	`dict[str, object]`
Returns	usage context

Important Options

tenant
user
request
run
feature
attributes

Full reference

`AxUsageEvent`

Normalized token usage and correlation data for one completed chat or embedding operation.

Field	Value
Kind	`type`
Ax concept	`AxUsageEvent`
API section	AxAI
Form	`AxUsageEvent`
Returns	usage event

Important Options

provider
model
tokens
context
correlation IDs
streaming

Full reference

`AxUsageObserver`

Best-effort process-wide callback for normalized usage events.

Field	Value
Kind	`interface`
Ax concept	`AxUsageObserver`
API section	AxAI
Form	`AxUsageObserver`
Returns	usage observer

Important Options

fail-open delivery
synchronous enqueue

Full reference

`set_usage_observer`

Field	Value
Kind	`function`
Ax concept	`set_usage_observer`
API section	AxAI
Form	`set_usage_observer(observer)`
Returns	void

Important Options

observer
clear

Examples

Python

set_usage_observer(events.append)

Full reference

`AxRuntimeHooks`

Non-serializable rate limiter, tracer, and meter overrides for one service or program execution.

Field	Value
Kind	`type`
Ax concept	`AxRuntimeHooks`
API section	AxAI
Form	`AxRuntimeHooks(rate_limiter=None, tracer=None, meter=None)`
Returns	runtime hooks

Important Options

rate limiter
tracer
meter
precedence

Examples

Python

hooks = AxRuntimeHooks(rate_limiter=limiter, tracer=tracer, meter=meter)

Full reference

`AxRateLimitInfo`

Provider and model metadata supplied to a request-wrapper rate limiter.

Field	Value
Kind	`type`
Ax concept	`AxRateLimitInfo`
API section	AxAI
Form	`AxRateLimitInfo`
Returns	rate-limit context

Important Options

operation
provider
model
streaming
previous usage

Full reference

`AxRateLimiter`

Request wrapper that can delay, reject, or execute a chat or embedding request.

Field	Value
Kind	`interface`
Ax concept	`AxRateLimiter`
API section	AxAI
Form	`AxRateLimiter`
Returns	provider result

Important Options

next
metadata
errors

Full reference

`AxTracer`

Dependency-neutral tracer that creates metadata-only Ax spans.

Field	Value
Kind	`interface`
Ax concept	`AxTracer`
API section	AxAI
Form	`AxTracer`
Returns	span

Important Options

start span
parent span
fail-open

Full reference

`AxMeter`

Dependency-neutral meter for Ax counters, histograms, and gauges.

Field	Value
Kind	`interface`
Ax concept	`AxMeter`
API section	AxAI
Form	`AxMeter`
Returns	instrument

Important Options

counter
histogram
gauge
fail-open

Full reference

`AxGlobals`

Process-wide live defaults for runtime hooks and usage observation.

Field	Value
Kind	`type`
Ax concept	`AxGlobals`
API section	AxAI
Form	`AxGlobals`
Returns	global hooks

Important Options

rate limiter
tracer
meter
usage observer

Full reference

`set_rate_limiter`

Field	Value
Kind	`function`
Ax concept	`set_rate_limiter`
API section	AxAI
Form	`set_rate_limiter(limiter)`
Returns	void

Important Options

limiter
clear

Examples

Python

set_rate_limiter(limiter)

Full reference

`set_tracer`

Field	Value
Kind	`function`
Ax concept	`set_tracer`
API section	AxAI
Form	`set_tracer(tracer)`
Returns	void

Important Options

tracer
clear

Examples

Python

set_tracer(tracer)

Full reference

`set_meter`

Field	Value
Kind	`function`
Ax concept	`set_meter`
API section	AxAI
Form	`set_meter(meter)`
Returns	void

Important Options

meter
clear

Examples

Python

set_meter(meter)

Full reference

`AxBalancerAdaptiveStrategy`

Configure adaptive provider routing without changing the ordered default.

Field	Value
Kind	`type`
Ax concept	`AxBalancerAdaptiveStrategy`
API section	AxAI
Form	`AxBalancerAdaptiveStrategy`
Returns	adaptive strategy

Important Options

deadline
bad outcome cost
expected tokens
stable route keys
slice
stats store
routing events

Full reference

`AxBalancerStatsStore`

Store shared adaptive decision state with atomic observations.

Field	Value
Kind	`interface`
Ax concept	`AxBalancerStatsStore`
API section	AxAI
Form	`AxBalancerStatsStore`
Returns	stats store

Important Options

get
observe

Full reference

`AxInMemoryBalancerStatsStore`

Thread-safe in-memory adaptive stats store.

Field	Value
Kind	`type`
Ax concept	`AxInMemoryBalancerStatsStore`
API section	AxAI
Form	`AxInMemoryBalancerStatsStore`
Returns	stats store

Full reference

`create_balancer_route_stats`

Create neutral adaptive route statistics.

Field	Value
Kind	`function`
Ax concept	`create_balancer_route_stats`
API section	AxAI
Form	`create_balancer_route_stats`
Returns	route stats

Full reference

`update_balancer_route_stats`

Purely reduce one success or failure observation into route statistics.

Field	Value
Kind	`function`
Ax concept	`update_balancer_route_stats`
API section	AxAI
Form	`update_balancer_route_stats`
Returns	route stats

Important Options

current stats
observation

Full reference

`sample_balancer_route_health`

Sample failure and deadline-miss probability for adaptive exploration.

Field	Value
Kind	`function`
Ax concept	`sample_balancer_route_health`
API section	AxAI
Form	`sample_balancer_route_health`
Returns	sampled health

Important Options

route stats
deadline

Full reference

Full Reference

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