API dei modelli
Annota AI offre i modelli di chat del catalogo Modelli tramite l’API dei modelli, compatibile con OpenAI Chat Completions. Funziona qualsiasi client o SDK OpenAI: imposta la base URL e una chiave API della tua organizzazione.
Base URL
Sezione intitolata “Base URL”https://api.annota.ai/openai/v1L’API supporta:
GET /models: elenca i modelli del catalogo. Non richiede una chiave API.POST /chat/completions: invia una richiesta di chat, con o senza streaming. Richiede una chiave API.
Usa l’ID del
modello mostrato nel catalogo, ad esempio deepseek-v4.1-flash-1017.
Crea una chiave API
Sezione intitolata “Crea una chiave API”Le chiavi API appartengono all’organizzazione, non a un membro, e ne usano i crediti finché non vengono revocate. Solo proprietario e admin possono gestirle. Gli altri membri possono chiedere una chiave al proprietario o a un admin dell’organizzazione.
- Vai in Impostazioni > Chiavi API e seleziona Crea chiave API.
- Inserisci un Nome che indica dove usi la chiave, ad esempio un progetto o un server, e seleziona Crea chiave API.
- In Copia la tua chiave API, copia la chiave e salvala in un posto sicuro, poi seleziona Ho salvato la chiave.
La pagina Chiavi API elenca ogni chiave con nome, chiave mascherata, chi l’ha creata, quando e l’ultimo utilizzo. Un’organizzazione può avere un numero limitato di chiavi: revocane una prima di crearne un’altra.
Fai una richiesta
Sezione intitolata “Fai una richiesta”Gli esempi leggono la chiave dalla variabile d’ambiente ANNOTA_AI_API_KEY.
Ogni pagina modello nell’app ha gli stessi esempi in cURL, Python,
TypeScript, Go e Rust nella sezione API.
curl https://api.annota.ai/openai/v1/chat/completions \ -H "Authorization: Bearer $ANNOTA_AI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-v4.1-flash-1017", "messages": [{"role": "user", "content": "Hello"}] }'Installa l’SDK OpenAI per Python, poi esegui:
import os
from openai import OpenAI
client = OpenAI( base_url="https://api.annota.ai/openai/v1", api_key=os.environ["ANNOTA_AI_API_KEY"],)
completion = client.chat.completions.create( model="deepseek-v4.1-flash-1017", messages=[{"role": "user", "content": "Hello"}],)print(completion.choices[0].message.content)Crediti
Sezione intitolata “Crediti”Ogni richiesta costa esattamente le tariffe del modello che usa, per milione di token di input, input in cache e output, e viene pagata con i crediti dell’organizzazione. Le richieste non contano mai nel limite di utilizzo settimanale di Brain dei membri. Una richiesta richiede un saldo di crediti positivo.
- L’utilizzo compare come API compatibile con OpenAI nell’utilizzo della fatturazione. Vedi Utilizzo dei crediti.
- Se un client si disconnette durante una risposta in streaming, ciò che il modello ha già generato viene comunque addebitato.
Vedi Modelli per le tariffe.
Revoca una chiave
Sezione intitolata “Revoca una chiave”- Vai in Impostazioni > Chiavi API.
- Seleziona Revoca sulla riga della chiave e conferma.
Le richieste con la chiave smettono subito di funzionare. L’azione non si può annullare. Revocare una chiave è il modo per sostituirla se potrebbe essere stata esposta.
Passi successivi
Sezione intitolata “Passi successivi”© 2026 Annota S.r.l.