cicora.ai
Italiano
Specifica APIInizia

Avvio rapido

Invia una prima richiesta, seleziona un modello dal catalogo e conserva un identificatore della richiesta per la diagnosi.

SDK in stile OpenAI e curlhttps://cicora.ai/api/v1
SDK Messages e Claude Codehttps://cicora.ai/api

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.

1. Prepara l'ambiente

Conserva la chiave solo in una variabile d'ambiente o in un archivio di segreti. Il codice del browser non deve contenerla né scriverla nei log.

L'URL di base dell'integrazione è https://cicora.ai/api/v1. Ogni esempio seguente aggiunge il proprio percorso a tale base.

Prima richiesta
bash
export CICORA_API_KEY=replace_with_your_key

curl --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "messages": [{"role": "user", "content": "Explain this API in one sentence."}]
  }'

2. Componi la richiesta

  • Usa l'identificatore esatto del modello restituito dal catalogo.
  • Invia i messaggi in ordine conversazionale: system, user, assistant e tool quando necessario.
  • Inizia con una variabilità più bassa, quindi regola i parametri per l'attività.

3. Gestisci la risposta

Leggi il testo dal primo elemento di risposta disponibile e salva l'ID richiesta insieme al tuo ID traccia.

Controlla lo stato e la struttura dell'errore prima di riprovare. Riprova solo le operazioni per le quali la tua applicazione può impedire la duplicazione del lavoro.

Continua con