Specifica API
Riferimento per integrazioni nei flussi di lavoro di testo, agenti, contenuti multimediali e recupero.
https://cicora.ai/api/v1https://cicora.ai/apiRiferimento 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.
Invia una prima richiestaInizia
Invia una prima richiesta, seleziona un modello dal catalogo e conserva un identificatore della richiesta per la diagnosi.
AutenticazioneInvia una chiave API in un'intestazione Bearer e mantieni separate le credenziali di produzione da quelle di sviluppo.
SDK e client HTTPUsa URL di base diversi per i client in stile OpenAI e Messages: fanno riferimento a un'unica specifica ma compongono i percorsi in modo diverso.
CLI e integrazioniConfigura un client con una chiave, un modello e un URL di base corrispondente al suo protocollo; conserva il segreto nell'ambiente.
Domande frequenti per sviluppatoriBrevi risposte pratiche su chiavi, URL di base, modelli, costi e diagnosi delle integrazioni.
Account e catalogo
Costruisci la selezione dei modelli dai dati del catalogo invece di usare un elenco codificato direttamente nella tua applicazione.
Team e chiavi APISepara chiavi, proprietari, budget e tracce di utilizzo tra applicazioni e spazi di lavoro.
LimitiConsidera i limiti di chiave, organizzazione, modello e instradamento come parte del flusso di lavoro dell'utente.
Utilizzo e costiCollega i metadati della risposta e i tuoi log delle richieste ad azioni reali degli utenti.
Dati e privacyRiduci al minimo i dati trasmessi, separa l'identificatore dell'utente finale dal contenuto e controlla la conservazione nel tuo prodotto.
Testo e agenti
Crea conversazioni a più turni nel consueto formato messages e seleziona un modello per ogni richiesta.
Messages APIUsa il formato Messages per conversazioni con un'istruzione system di primo livello e un limite di output esplicito.
Responses APIUsa un solo oggetto di input quando è utile alla tua applicazione gestire elementi di output e azioni in un unico modello di dati.
StreamingRicevi token e delta strutturati tramite SSE senza attendere la risposta completa.
Strumenti e chiamata di funzioniDescrivi le funzioni con JSON Schema, esegui la chiamata nella tua applicazione e restituisci il risultato alla conversazione.
Output strutturatiRichiedi un oggetto JSON o JSON Schema quando la risposta sarà utilizzata da un software anziché da una persona.
RagionamentoImposta l'intensità del ragionamento per ogni richiesta solo per i modelli che dichiarano tale funzionalità.
InstradamentoEsprimi i requisiti di esecuzione nelle preferenze del provider e conserva il risultato effettivo per l'osservabilità.
Memorizzazione del contesto nella cacheSepara il contesto ricorrente, affinché un client possa usare una memorizzazione nella cache compatibile dove il modello scelto lo supporta.
Ricerca webRecupera fonti aggiornate tramite una funzione `web_search` eseguita dal client e mantieni i link separati dal testo generato.
Contenuti multimediali e recupero
Carica un file tramite un'operazione dedicata, conserva il relativo ID e passa un riferimento in una richiesta compatibile successiva.
ImmaginiCrea immagini tramite un unico percorso e seleziona i parametri dalle funzionalità del modello scelto.
VideoAvvia il video come processo asincrono, conserva il relativo ID e mantieni la creazione separata dalla lettura del risultato.
AudioUsa operazioni separate per sintesi vocale, trascrizione e input audio a un modello.
EmbeddingTrasforma testo o input supportati in vettori per ricerca, raggruppamento e raccomandazioni.
RiordinamentoRiordina un piccolo insieme di candidati rispetto a una query per migliorare la precisione del recupero finale.
Esecuzione batchElabora le operazioni indipendenti in gruppi controllati quando il flusso di lavoro consente la consegna asincrona.