Impostazioni
Impostazioni
Gestisci le impostazioni del modello AI. Usa questi endpoint per configurare BYOK (Bring Your Own Key) per i provider AI.
Ottieni le Impostazioni
GET /v1/settingsRestituisce la configurazione corrente del modello AI.
Richiesta
curl https://api.laddro.com/v1/settings \
-H "x-api-key: YOUR_API_KEY"Risposta
{
"data": {
"model": {
"provider": "openai",
"modelId": "gpt-4o-mini",
"isCustom": false
}
}
}Se nessun modello personalizzato e impostato, isCustom sara false e verra utilizzato il modello predefinito del sistema (OpenAI gpt-4o-mini).
Imposta il Modello AI (BYOK)
PUT /v1/settings/modelConfigura un provider AI personalizzato e un modello usando la tua chiave API. Richiede un abbonamento Laddro ricorrente attivo.
Corpo della Richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
provider | string | Si | Nome del provider (es. openai, anthropic) |
modelId | string | Si | ID del modello (es. gpt-4.1-mini) |
apiKey | string | Si | La tua chiave API per il provider |
Richiesta
curl -X PUT https://api.laddro.com/v1/settings/model \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "anthropic",
"modelId": "claude-haiku-4.5",
"apiKey": "sk-ant-..."
}'Risposta
{
"data": {
"model": {
"provider": "anthropic",
"modelId": "claude-haiku-4.5",
"isCustom": true
}
},
"message": "Model updated successfully"
}La tua chiave API viene validata con una chiamata di test prima del salvataggio. Le chiavi non valide vengono rifiutate con un messaggio di errore chiaro.
Errori
| Stato | Descrizione |
|---|---|
400 | Provider o ID modello non valido |
401 | Chiave API mancante o non valida |
403 | BYOK richiede un abbonamento ricorrente attivo |
422 | Validazione della chiave API del provider fallita |
Ripristina il Modello Predefinito
DELETE /v1/settings/modelRimuovi la configurazione del modello personalizzato e ripristina il modello predefinito del sistema.
Richiesta
curl -X DELETE https://api.laddro.com/v1/settings/model \
-H "x-api-key: YOUR_API_KEY"Risposta
{
"data": {
"model": {
"provider": "openai",
"modelId": "gpt-4o-mini",
"isCustom": false
}
},
"message": "Model reset to default"
}Consulta la Guida BYOK per le istruzioni di configurazione e i provider supportati.