Source: https://ailoot.ai/docs/en/integrations/pydantic-ai/
Canonical: https://ailoot.ai/docs/en/integrations/pydantic-ai/
Language: en

[SDKs and frameworks](https://ailoot.ai/docs/en/integrations/#sdk) 

# Pydantic AI

[Markdown](https://ailoot.ai/docs/en/integrations/pydantic-ai/index.md)

Agent framework · OpenAI Chat, OpenAI Responses

| Format | Where to set it up |
| --- | --- |
| OpenAI Chat, OpenAI Responses | OpenAIProvider(base\_url=..., api\_key=...) with OpenAIChatModel for Chat Completions or OpenAIResponsesModel for Responses, or the OPENAI\_BASE\_URL variable |

## [](https://ailoot.ai/docs/en/integrations/pydantic-ai/#setup)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.

```python
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai import OpenAIProvider
model = OpenAIChatModel("deepseek-v4-pro",
    provider=OpenAIProvider(base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"]))
agent = Agent(model)
print(agent.run_sync("Hello").output)
```

Example model: `deepseek-v4-pro, gpt-6.1-sol (for OpenAIResponsesModel)`. Choose any other model from the [catalog](https://ailoot.ai/models/en/) — check that it supports the format you need.

## [](https://ailoot.ai/docs/en/integrations/pydantic-ai/#notes)Good to know

Include /v1 in the URL. The documentation defaults to OpenAIResponsesModel: use it only for models with the responses method; use OpenAIChatModel for the others.

## [](https://ailoot.ai/docs/en/integrations/pydantic-ai/#check)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](https://ailoot.ai/docs/en/errors/).
- 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](https://ailoot.ai/docs/en/billing/reserve/).

Application documentation: [https://pydantic.dev/docs/ai/models/openai/](https://pydantic.dev/docs/ai/models/openai/)

Still have questions? Send your Request ID and a description — we'll help you troubleshoot.[Contact support](mailto:support@ailoot.ai)

## Ailoot · The company and its project portfolio





Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control.





The company and its project portfolio: millions of customers; monthly sales in the billions.





Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.