cicora.ai
Specifica APIRisposte

Domande frequenti per sviluppatori

Brevi risposte pratiche su chiavi, URL di base, modelli, costi e diagnosi delle integrazioni.

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.

Da dove devo iniziare?

Crea una chiave separata, configura l'URL di base in stile OpenAI https://cicora.ai/api/v1, quindi esegui GET /models. Invia poi una richiesta di chat minima con l'identificatore di un modello selezionato.

Per un SDK Messages, usa la radice del gateway https://cicora.ai/api. In caso di 404, confronta l'URL finale con il protocollo del client: uno aggiunge un percorso dopo /v1, l'altro aggiunge /v1/messages.

Una prima richiesta diagnostica sicura
bash
curl --include --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

Soluzioni frequenti

  • Non memorizzare una chiave nel codice del client e non pubblicarla in una segnalazione o in uno screenshot.
  • Non considerare un esempio di prezzo come prezzo corrente: leggi il catalogo e i metadati della risposta.
  • Non trasferire parametri o funzionalità tra modelli senza controllare il modello.

Quando serve assistenza

Raccogli timestamp, metodo, URL senza segreti nella query, stato HTTP, ID richiesta e corpo dell'errore deidentificato.

Non allegare una chiave, prompt completi contenenti dati riservati o file, a meno che non siano necessari per riprodurre il problema.