cicora.ai
Specifica APICLI e app

CLI e integrazioni

Configura un client con una chiave, un modello e un URL di base corrispondente al suo protocollo; conserva il segreto nell'ambiente.

Riferimento per l'integrazione: scegli i parametri e le funzionalità disponibili dalle impostazioni API del tuo account e dal catalogo dei modelli per il tuo ambiente.

Scegli l'URL compatibile

Per un client in stile OpenAI, imposta CICORA_API_BASE_URL=https://cicora.ai/api/v1 e non aggiungere un secondo /v1.

Per un client Messages o Claude Code, imposta ANTHROPIC_BASE_URL=https://cicora.ai/api: quel client aggiunge autonomamente /v1/messages. Verifica la configurazione tramite il catalogo dei modelli prima dell'inferenza.

Configurazione del client compatibile
bash
export CICORA_API_BASE_URL=https://cicora.ai/api/v1
export CICORA_API_KEY=replace_with_your_key

curl "$CICORA_API_BASE_URL/models" \
  --header "Authorization: Bearer $CICORA_API_KEY"

Avvio sicuro

  • Passa le variabili d'ambiente tramite un gestore di segreti o un profilo sicuro.
  • Escludi i file .env e le configurazioni esportate dai commit.
  • Assegna a ogni applicazione la propria chiave, affinché l'accesso possa essere revocato senza interrompere le altre.

Contratto portabile

Conserva i log di richiesta e risposta senza Authorization o dati utente, quando il tuo regime di conservazione lo consente.

Se un client compone il proprio percorso, confronta l'URL finale nel suo log di debug prima della prima generazione.