API-määritys
Viiteohje teksti-, agentti-, media- ja tiedonhakutyönkulkujen integrointiin.
https://cicora.ai/api/v1https://cicora.ai/apiIntegraatio-opas: valitse parametrit ja saatavilla olevat ominaisuudet ympäristösi tilin API-asetuksista ja malliluettelosta.
Lähetä ensimmäinen pyyntöKäytön aloittaminen
Lähetä ensimmäinen pyyntö, valitse malli luettelosta ja säilytä pyyntötunniste diagnostiikkaa varten.
TodennusLähetä API-avain Bearer-otsakkeessa ja pidä tuotantotunnukset erillään kehitystunnuksista.
SDK:t ja HTTP-asiakasohjelmatKäytä eri perus-URL-osoitteita OpenAI-tyylisille ja Messages-asiakkaille: ne kohdistuvat samaan määritykseen mutta muodostavat polut eri tavoin.
Komentorivi ja integraatiotMääritä asiakasohjelmalle avain, malli ja sen protokollaa vastaava perus-URL-osoite; säilytä salaisuus ympäristössä.
Kehittäjien usein kysytyt kysymyksetLyhyitä käytännön vastauksia avaimista, perus-URL-osoitteista, malleista, kustannuksista ja integraation diagnostiikasta.
Tili ja luettelo
Rakenna mallin valinta luettelotiedoista sovellukseen kovakoodatun luettelon sijasta.
Tiimit ja API-avaimetErota avaimet, omistajat, budjetit ja käytön jäljet sovellusten ja työtilojen välillä.
RajatKäsittele avain-, organisaatio-, malli- ja reititysrajoja osana käyttäjän työnkulkua.
Käyttö ja kustannuksetYhdistä vastausten metatiedot ja omat pyyntölokisi todellisiin käyttäjän toimiin.
Tiedot ja tietosuojaMinimoi siirrettävät tiedot, pidä loppukäyttäjän tunniste erillään sisällöstä ja hallitse säilytystä tuotteessasi.
Teksti ja agentit
Luo monivaiheisia keskusteluja tutussa viestimuodossa ja valitse malli jokaiseen pyyntöön.
Messages APIKäytä Messages-muotoa keskusteluihin, joissa on ylimmän tason järjestelmäohje ja nimenomainen tulosteraja.
Responses APIKäytä yhtä syöteobjektia, kun sovelluksesi hyötyy tulostekohteiden ja toimintojen käsittelystä yhdessä tietomallissa.
SuoratoistoVastaanota tokeneita ja rakenteisia deltoja SSE:n kautta odottamatta koko vastausta.
Työkalut ja funktiokutsutKuvaa funktiot JSON Schemalla, suorita kutsu sovelluksessasi ja palauta tulos keskusteluun.
Rakenteiset tulosteetPyydä JSON-objekti tai JSON Schema, kun vastauksen käsittelee ohjelmisto eikä ihminen.
PäättelyMääritä päättelypanos pyyntökohtaisesti vain malleille, jotka ilmoittavat tukevansa ominaisuutta.
ReititysIlmaise suoritusta koskevat vaatimukset palveluntarjoaja-asetuksissa ja säilytä toteutunut tulos havainnointia varten.
Kontekstin välimuistitusErota toistuva konteksti, jotta asiakas voi käyttää yhteensopivaa välimuistitusta valitun mallin tukiessa sitä.
VerkkohakuNouda tuoreita lähteitä asiakasohjelman suorittamalla `web_search`-funktiolla ja pidä linkit erillään luodusta tekstistä.
Media ja tiedonhaku
Lähetä tiedosto erillisellä toiminnolla, säilytä sen tunnus ja välitä viite myöhemmässä yhteensopivassa pyynnössä.
KuvatLuo kuvia yhdellä reitillä ja valitse parametrit valitun mallin ominaisuuksista.
VideoKäynnistä video asynkronisena työnä, säilytä sen työtunnus ja pidä luominen erillään tuloksen lukemisesta.
ÄäniKäytä erillisiä toimintoja puhesynteesiin, litterointiin ja mallin äänisyötteeseen.
UpotuksetMuunna teksti tai tuetut syötteet vektoreiksi hakua, ryhmittelyä ja suosituksia varten.
UudelleenjärjestysJärjestä pieni ehdokasjoukko uudelleen kyselyä vasten lopullisen tiedonhaun tarkkuuden parantamiseksi.
EräsuoritusKäsittele itsenäiset toiminnot hallituissa ryhmissä, kun työnkulku sallii asynkronisen toimituksen.