المطوّرون
عنوان URL أساسي واحد، ومفتاح واحد، وثلاثة أحجام نماذج خلفه. واجهة API متوافقة مع OpenAI للمحادثة، ومسارات Cruxy الخاصة عندما تريد الذاكرة والخزنات والملفات والتقييمات، و CLI يعمل في مستودعك.
import OpenAI from 'openai';
const cruxy = new OpenAI({
baseURL: 'https://api.cruxy.ai/v1',
apiKey: process.env.CRUXY_API_KEY,
});
const res = await cruxy.chat.completions.create({
model: 'auto',
messages: [{ role: 'user', content: 'Summarize this ticket' }],
});{
"id": "chatcmpl-8f3a1c2d",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Checkout fails on UPI when the cart
holds a gift card. Steps to reproduce and
a fix are below."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 212,
"completion_tokens": 96,
"total_tokens": 308
}
}الطلب حقيقي. والرد توضيحي ومختصر إلى شكله فقط.
المنصة
المحادثة
POST /v1/chat/completionsوجّه أي عميل OpenAI أو إطار تقييم إلى https://api.cruxy.ai/v1 بمفتاح Cruxy الخاص بك. كائنات chat.completion قياسية، و SSE بصيغة OpenAI، وغلاف أخطاء OpenAI، مع كود Cruxy ثابت داخله.
POST /api/v1/chatالنماذج نفسها مع كل ما في تطبيق Cruxy: استحضار الذاكرة والتقاطها، والخزنات والقواعد الدائمة، والملفات بالمعرّف، و usage.cost في كل رد.
const stream = await cruxy.chat.completions.create({
model: 'auto',
stream: true,
messages: [{ role: 'user', content: 'Draft the release note' }],
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}البث
اضبط stream على true فيصل الرد كأحداث خادم (SSE) بصيغة OpenAI: إطارات chat.completion.chunk تحمل أجزاء المحتوى أو أجزاء استدعاءات الأدوات، ثم [DONE].
إذا فشل المصدر في منتصف البث، ينتهي البث بإطار خطأ بدلًا من [DONE]، فيستطيع عميلك التمييز بين الانقطاع والانتهاء. ويعمل استدعاء الأدوات على المسارَين: أرسل الدوال التي يجوز للنموذج استدعاؤها، وشغّل ما يعيده منها، وأعد النتائج إليه.
دليل استدعاء الأدواتواجهة API
التشغيل
يعيد GET /api/v1/limits حدودك القصوى لطلبات المحادثة لكل مفتاح ولكل مؤسسة في كل نافذة من 60 ثانية، وترسل البوابة ترويسات X-RateLimit. ولا يوجد حد للرموز في الدقيقة.
يعني rate_limited أن الطلبات تصل بسرعة كبيرة؛ ويزول عندما تخفّف الوتيرة. أما budget_exhausted فهو حد أقصى للإنفاق لا تزيله إعادة المحاولة وحدها.
يُسجَّل كل طلب مع النموذج وأعداد الرموز والتكلفة والتوقيت والحالة، ولا شيء من الموجّه أو الرد. اقرأ أحدها من GET /api/v1/logs/{request_id}.
احصل على مفتاح عبر مسار تسجيل دخول الجهاز. يُعرض مرة واحدة بالضبط ويُخزَّن كتجزئة فقط. وتُشفَّر الأسرار المخزّنة حقلًا بحقل بـ AES-256-GCM.
متاح
Cruxy Code
npm i -g @cruxy/cliاستكشف Cruxy Code$cruxy run "fix the failing tests in the auth module"cruxy › fix the failing tests in the auth module! cruxy wants to run tests: pnpm test (destructive) $ pnpm test in /home/dev/web [y] once · [a] always allow test runs of exactly `pnpm test` this session · [t] reject & instruct · [n] no: a✗ tests failed · 2 of 42 failed · 3.1s · pnpm test ✗ signs a session token src/auth/session.test.ts:18 expected "ok" received undefined ✗ rejects an expired token src/auth/session.test.ts:41 why (inferred) TOKEN_SECRET is not set in the test environment✓ read_file 8ms src/test/setup.ts? cruxy wants to edit: src/test/setup.ts (mutate)جلسة حقيقية، مختصرة. ناتج CLI حقيقي؛ وردود النموذج توضيحية.
أسعار API
Fast· Mira
الاستدعاءات القصيرة عالية الحجم التي يهم فيها زمن الاستجابة والتكلفة أكثر من غيرهما.
Balanced· Vaani
الاستدعاءات اليومية: جودة قوية بزمن استجابة وتكلفة أقل.
Deep· Kavi
أصعب المهام: استدلال عميق وأكبر ميزانية إخراج.
بالدولار الأمريكي لكل 1M رمز، تُحسب لكل طلب. أسعار API غير شاملة GST. تُضاف 18% GST للحسابات المفوترة في الهند (مع إمكانية خصم ضريبة المدخلات). ومع auto، تدفع سعر النموذج الذي خدم الاستدعاء.
أسئلة
نعم، للمحادثة وقائمة النماذج. يخدم https://api.cruxy.ai/v1 المسارَين /v1/chat/completions و /v1/models بأشكال OpenAI، فتعمل العملاء وأطر التقييم الحالية بمجرد تغيير عنوان URL الأساسي والمفتاح. أما بقية واجهة API، من الملفات إلى التقييمات، فهي خاصة بـ Cruxy وتقع تحت /api/v1.
ابدأ مجانًا، وادفع لكل رمز، واقرأ كل حد قبل أن تصل إليه.