OpenAI Agents SDK
MarkdownAgent framework · OpenAI Chat, OpenAI Responses
Full guide
| Format | Where to set it up |
|---|---|
| OpenAI Chat, OpenAI Responses | AsyncOpenAI(base_url=..., api_key=...) + OpenAIChatCompletionsModel(model=..., openai_client=client), or set_default_openai_client(client) globally |
Setup
Copy the configuration and replace sk-... with your key from the Ailoot Dashboard. Prefer storing the key in the environment variable AILOOT_API_KEY, if the application supports it.
Before starting, request GET /v1/models with your Ailoot key. Choose an exact model ID whose methods include POST /v1/chat/completions, POST /v1/responses, then use that ID in the configuration. For agents, also check tool support and the features required by your client version.
import os
from agents import Agent, Runner, AsyncOpenAI, OpenAIChatCompletionsModel, set_tracing_disabled
set_tracing_disabled(disabled=True)
client = AsyncOpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
model = OpenAIChatCompletionsModel(model="claude-sonnet-5-5", openai_client=client)
agent = Agent(name="Assistant", instructions="Respond in Russian", model=model)
print(Runner.run_sync(agent, "Hello").final_output)Example model: claude-sonnet-5-5, gpt-6.1-sol. Choose any other model from the catalog — check that it supports the format you need.
Good to know
Test
- For the OpenAI format, the URL is
https://api.ailoot.ai/v1(or the full path if the application asks for a full URL). - Ask a short question. If you get an error, check the code and Request ID, then consult Errors and limits.
- 404 immediately after setup almost always means the URL is wrong: an extra or missing
/v1. - 402 — insufficient balance for the reserve. Agents reserve more than chat: why.
Application documentation: https://openai.github.io/openai-agents-python/models/
Still have questions? Send your Request ID and a description — we'll help you troubleshoot.Contact support