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

[SDK e framework](https://ailoot.ai/docs/it/integrations/#sdk) 

# Pydantic AI

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

Framework per agenti · OpenAI Chat, OpenAI Responses

| Formato | Dove configurare |
| --- | --- |
| OpenAI Chat, OpenAI Responses | OpenAIProvider(base\_url=..., api\_key=...) con il modello OpenAIChatModel (Chat Completions) oppure OpenAIResponsesModel (Responses); alternativa — variabile OPENAI\_BASE\_URL |

## [](https://ailoot.ai/docs/it/integrations/pydantic-ai/#setup)Configurazione

Copia la configurazione e sostituisci `sk-...` con la tua chiave dall’area personale Ailoot. È meglio conservarla nella variabile d’ambiente `AILOOT_API_KEY`, se l’applicazione lo supporta.

Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.

```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("Ciao").output)
```

Modello di esempio: `deepseek-v4-pro, gpt-6.1-sol (per OpenAIResponsesModel)`. Scegli qualsiasi altro modello dal [catalogo](https://ailoot.ai/models/it/) — verifica che supporti il formato necessario.

## [](https://ailoot.ai/docs/it/integrations/pydantic-ai/#notes)Da sapere

Indirizzo con /v1. La documentazione usa per impostazione predefinita OpenAIResponsesModel: sceglilo solo per modelli con metodo responses; per gli altri OpenAIChatModel.

## [](https://ailoot.ai/docs/it/integrations/pydantic-ai/#check)Verifica

- Per il formato OpenAI l’indirizzo è `https://api.ailoot.ai/v1` (oppure il percorso completo, se l’applicazione chiede l’indirizzo completo).
- Fai una domanda breve. Se ricevi un errore, controlla codice e Request ID e consulta la pagina [Errori e limiti](https://ailoot.ai/docs/it/errors/).
- 404 subito dopo la configurazione indica quasi sempre un indirizzo errato: manca o è superfluo il segmento `/v1`.
- 402 — il saldo non basta per la riserva. Gli agenti riservano più di una chat: [perché](https://ailoot.ai/docs/it/billing/reserve/).

Documentazione dell’applicazione: [https://pydantic.dev/docs/ai/models/openai/](https://pydantic.dev/docs/ai/models/openai/)

Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.