OpenAI()
GPT models direct from OpenAI, with your own API key. Costs go direct to the vendor at their rates — no markup, nothing on your Axon balance.
export default defineProfile({
providers: [OpenAI()],
})
Serves openai/*.
Credentials
Set the environment variable, or pass key on the declaration:
OPENAI_API_KEY=...
providers: [OpenAI({ key: process.env.MY_OWN_VAR })]
Unlike OpenRouter() and
Codex(), direct providers are not vaulted yet: the
credential comes from the agent's environment. A deployed agent needs it set as a runtime
secret, or should use a vaulted route instead.
Declaring this provider without the variable set is not an error. The failure comes when something tries to use it, and names the variable you need.
Options
OpenAI(options?: ProviderOptions)
| Option | Default | Description |
|---|---|---|
key | OPENAI_API_KEY | Your own credential, passed directly |
url | the provider's API | Endpoint override |
slots | unbounded | Ceiling on concurrent calls a fanned-out role may spend here |
Model ids
Bare OpenAI slugs:
export default defineAgent({ model: "openai:gpt-5.5" })
Not the same as Codex()
Codex() reaches OpenAI through a ChatGPT subscription over
OAuth, with a per-account catalogue and no per-token cost. This is the API platform,
billed per token. Same vendor, different product, different bill.