Documentazione / sviluppatori

Una API. Ora tocca a te.

Autentica le richieste, trova i modelli e integra la tua prima conversazione. Gli esempi vengono eseguiti sul server.

Usa una chiave API CONSTELLO e un modello accessibile al tuo account. Le richieste eseguite consumano crediti in base all’utilizzo.

Guida rapida

Crea il tuo account su gateway.constello.ch, ricarica il saldo se necessario e crea una chiave nella sezione Chiavi API. Scegli un identificativo in Modelli IA o tramite GET /v1/models. Imposta queste variabili nel terminale.

BASE URLhttps://gateway.constello.ch/v1
Shell 
export GATEWAY_URL="https://gateway.constello.ch"
export GATEWAY_API_KEY="YOUR_GATEWAY_TOKEN"
export GATEWAY_MODEL="YOUR_MODEL_ID"

Sintassi Bash / zsh. Sostituisci i valori di esempio. Gli esempi Python e JavaScript usano le stesse variabili d’ambiente.

In uno SDK compatibile OpenAI, imposta base_url o baseURL su https://gateway.constello.ch/v1. Negli esempi GATEWAY_URL indica la radice senza /v1: i percorsi aggiungono già questo prefisso.

Autenticazione

Invia la chiave API CONSTELLO nell’header Authorization. Usa una chiave API, mai la password del tuo account.

Authorization: Bearer YOUR_GATEWAY_TOKEN

Conserva la chiave nelle variabili d’ambiente del server o dello strumento locale. Non inserirla nel JavaScript pubblico o in Git. Usa esclusivamente l’indirizzo HTTPS della Gateway.

Modelli

GET/v1/models

Elenca i modelli accessibili con la tua chiave. Copia esattamente un identificativo restituito nel campo model della richiesta.

cURL 
curl "$GATEWAY_URL/v1/models" \
  -H "Authorization: Bearer $GATEWAY_API_KEY"

Conversazioni

POST/v1/chat/completions

Invia un array di messaggi a un modello configurato. Questi esempi richiedono una risposta completa, senza streaming. Python usa la libreria standard; JavaScript richiede Node.js 18 o successivo.

Campo Tipo Descrizione
model string Obbligatorio. Identificativo esatto di un modello configurato.
messages array Obbligatorio. Messaggi contenenti role e content.
stream boolean Facoltativo. true per ricevere la risposta progressivamente.

Streaming

Aggiungi stream: true e usa un client capace di leggere eventi SSE. Con cURL, -N disattiva il buffering dell’output.

cURL / SSE 
curl -N "$GATEWAY_URL/v1/chat/completions" \
  -H "Authorization: Bearer $GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"stream":true}'

Sostituisci YOUR_MODEL_ID con un identificativo accessibile al tuo account. Gestisci errori e interruzioni del flusso. Il supporto streaming dipende dal modello.

Risolvere un errore

Controlla lo stato HTTP e il messaggio restituito, poi i log della Gateway. Non condividere gli header di autenticazione nelle segnalazioni.

Accesso negato

Verifica token, stato, scadenza e restrizioni.

Quota o limite raggiunto

Controlla saldo, quota della chiave e limiti delle richieste. Distanzia le chiamate in caso di limitazione temporanea.

Modello non disponibile

Verifica l’identificativo del modello e le restrizioni della chiave. Controlla lo stato dei servizi e contatta l’assistenza se il problema persiste; non inviare mai la chiave.

Apri la console