Salta ai contenuti

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.

https://api.annota.ai/openai/v1

L’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.

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.

  1. Vai in Impostazioni > Chiavi API e seleziona Crea chiave API.
  2. Inserisci un Nome che indica dove usi la chiave, ad esempio un progetto o un server, e seleziona Crea chiave API.
  3. 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.

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.

Finestra del terminale
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"}]
}'

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.

  1. Vai in Impostazioni > Chiavi API.
  2. 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.