API-specifikation
Reference til integrationer i arbejdsgange med tekst, agenter, medier og informationssøgning.
https://cicora.ai/api/v1https://cicora.ai/apiIntegrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.
Send den første anmodningKom i gang
Send en første anmodning, vælg en model i kataloget, og gem et anmodnings-ID til diagnosticering.
GodkendelseSend en API-nøgle i en Bearer-header, og hold produktionslegitimationsoplysninger adskilt fra udviklingslegitimationsoplysninger.
SDK'er og HTTP-klienterBrug forskellige basis-URL'er til klienter i OpenAI-stil og Messages-klienter: de er målrettet samme specifikation, men sammensætter stier forskelligt.
Kommandolinje og integrationerKonfigurér en klient med en nøgle, en model og en basis-URL, der svarer til dens protokol; opbevar hemmeligheden i miljøet.
Almindelige spørgsmål for udviklereKorte, praktiske svar om nøgler, basis-URL'er, modeller, omkostninger og diagnosticering af integrationer.
Konto og katalog
Byg modelvalget fra katalogdata i stedet for en hardkodet liste i applikationen.
Team og API-nøglerHold nøgler, ejere, budgetter og brugsspor adskilt mellem applikationer og arbejdsområder.
GrænserBehandl grænser for nøgle, organisation, model og routing som en del af brugerflowet.
Brug og omkostningerKnyt metadata fra svaret og dine egne anmodningslogs til faktiske brugerhandlinger.
Data og privatlivMinimér overførte data, hold et slutbruger-ID adskilt fra indholdet, og styr opbevaringen i produktet.
Tekst og agenter
Opret samtaler over flere runder i det velkendte messages-format, og vælg en model for hver anmodning.
Messages APIBrug Messages-formatet til samtaler med en systeminstruktion på øverste niveau og en udtrykkelig grænse for output.
Responses APIBrug ét input-objekt, når applikationen har nytte af at behandle outputelementer og handlinger i én datamodel.
StreamingModtag tokens og strukturerede deltaer gennem SSE uden at vente på hele svaret.
Værktøjer og funktionskaldBeskriv funktioner med JSON Schema, kør kaldet i applikationen, og returnér resultatet til samtalen.
Strukturerede outputAnmod om et JSON-objekt eller JSON Schema når svaret skal bruges af software, ikke af en person.
RæsonneringAngiv ræsonneringsindsats per anmodning kun for modeller som angiver at de understøtter funktionen.
RoutingAngiv krav til kørsel i udbyderpræferencerne, og bevar det faktiske resultat af hensyn til observerbarhed.
KontekstcachingAdskil tilbagevendende kontekst, så klienten kan bruge kompatibel caching, hvor den valgte model understøtter det.
WebsøgningHent aktuelle kilder gennem en klientudført `web_search`-funktion, og hold links adskilt fra genereret tekst.
Medier og informationssøgning
Upload en fil gennem en dedikeret operation, bevar dens ID, og send en reference i en senere kompatibel anmodning.
BillederOpret billeder gennem én rute, og vælg parametre ud fra den valgte models funktioner.
VideoStart video som et asynkront job, bevar job-ID'et, og hold oprettelsen adskilt fra læsningen af resultatet.
LydBrug separate operationer for talesyntese, transskription og lydinput til en model.
EmbeddingsGør tekst eller understøttede input om til vektorer for søgning, klyngedannelse og anbefalinger.
RerankOmranger et lille sæt kandidater i forhold til en forespørgsel for at forbedre præcisionen i den endelige søgning.
BatchkørselBehandl uafhængige operationer i kontrollerede grupper når arbejdsgangen tillader asynkron levering.