API spetsifikatsiyasi
Matn, agent, media va qidiruv ssenariylari bilan integratsiyalar uchun ma’lumotnoma.
https://cicora.ai/api/v1https://cicora.ai/apiIntegratsiya ma’lumotnomasi: muhitingiz uchun parametrlar va mavjud imkoniyatlarni akkaunt API sozlamalari hamda model katalogidan tanlang.
Birinchi so‘rovni yuborishBoshlash
Birinchi so‘rovni yuboring, katalogdan modelni tanlang va diagnostika uchun so‘rov identifikatorini saqlang.
AutentifikatsiyaAPI kalitini Bearer sarlavhasida yuboring va server muhitidagi kalitlarni ishlab chiqish kalitlaridan ajrating.
SDK va HTTP mijozlariOpenAI-style va Messages mijozlari uchun turli bazaviy URL lardan foydalaning: ular bitta spetsifikatsiyaga murojaat qiladi, lekin yo‘lni turlicha tuzadi.
CLI va integratsiyalarMijozni aynan uning protokoliga mos kalit, model va bazaviy URL bilan sozlang; maxfiy ma’lumot muhitda qoladi.
Dasturchilar uchun FAQKalitlar, bazaviy URL lar, modellar, xarajat va integratsiya diagnostikasi bo‘yicha qisqa amaliy javoblar.
Akkaunt va katalog
Model tanlashni ilovadagi qotirilgan ro‘yxatga emas, katalog ma’lumotlariga asoslang.
Jamoalar va API kalitlariKalitlar, egalari, byudjetlar va foydalanish izlarini ilovalar hamda ish maydonlari o‘rtasida ajrating.
LimitlarKalit, tashkilot, model va yo‘nalish limitlarini foydalanuvchi ssenariysining bir qismi sifatida hisobga oling.
Foydalanish va xarajatJavob metama’lumotlari va o‘z request log laringizni foydalanuvchining haqiqiy harakatlari bilan bog‘lang.
Ma’lumotlar va maxfiylikUzatiladigan ma’lumotlarni minimallashtiring, foydalanuvchi identifikatorini kontentdan ajrating va mahsulotingizda saqlash muddatini boshqaring.
Matn va agentlar
messages formatida ko‘p bosqichli dialoglar yarating va har bir so‘rov uchun modelni tanlang.
Messages APIYuqori darajadagi tizim ko‘rsatmasi va aniq chiqish limiti bo‘lgan dialoglar uchun Messages formatidan foydalaning.
Responses APIIlovaga chiqish elementlari va harakatlar bilan bitta ma’lumot modelida ishlash qulay bo‘lsa, yagona input obyektidan foydalaning.
Oqimli javoblarTo‘liq javobni kutmasdan SSE orqali tokenlar va tuzilgan deltalarni oling.
Tools va function callingFunksiyalarni JSON Schema bilan tavsiflang, chaqiruvni ilovangizda bajaring va natijani tarixga qaytaring.
Tuzilgan javoblarJavobni inson emas, dastur iste’mol qilsa JSON obyekt yoki JSON Schema so‘rang.
ReasoningMulohaza yuritish kuchini faqat bu imkoniyatni e’lon qilgan modellar uchun so‘rovda sozlang.
MarshrutlashBajarilish talablarini provider preferences da ifodalang va kuzatuvchanlik uchun haqiqiy natijani saqlang.
Kontekstni keshlashTakrorlanadigan kontekstni ajrating, shunda mijoz model qo‘llagan joyda mos keshlashdan foydalana oladi.
Veb qidiruvYangi manbalarni client-executed `web_search` funksiyasi orqali qidiring va havolalarni generatsiya qilingan matndan alohida saqlang.
Media va qidiruv
Faylni alohida operatsiyada yuklang, uning id sini saqlang va keyingi mos so‘rovda unga havolani uzating.
RasmlarRasmlarni yagona marshrut orqali yarating va parametrlarni tanlangan model imkoniyatlariga ko‘ra tanlang.
VideoVideoni asinxron vazifa sifatida boshlang, vazifa id sini saqlang va yaratishni natijani o‘qishdan ajrating.
AudioNutq sintezi, transkripsiya va modelga audio kiritish uchun alohida operatsiyalardan foydalaning.
EmbeddingsQidiruv, klasterlash va tavsiyalar uchun matn yoki qo‘llanadigan kirishlarni vektorlarga aylantiring.
RerankYakuniy natija aniqligini oshirish uchun so‘rovga nisbatan kichik nomzodlar to‘plamini qayta saralang.
Paketli bajarishSsenariy asinxron natijaga ruxsat bersa, mustaqil operatsiyalarni boshqariladigan guruhlarda qayta ishlang.