توثيق واجهات Runexa API

المقدمة

بنية Runexa للذكاء الاصطناعي

تمكّن واجهات Runexa المطورين والمؤسسات من دمج تدفقات متقدمة لتحليل الذكاء الاصطناعي داخل التطبيقات ولوحات التحكم والأدوات الداخلية وأنظمة المؤسسات.

المصادقة

تتطلب جميع طلبات API مفتاح Bearer صالحاً.

Authorization: Bearer rk_live_xxxxxxxxx

curl -X GET "https://api.runexa.ai/v1/test-api-key" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx"

البنية غير المتزامنة

تستخدم واجهات Runexa معالجة غير متزامنة تعتمد على عمّال معالجة موزعين وقوائم انتظار للمهام.

Frontend
→ Runexa API
→ Job Queue
→ AI Workers
→ Persistent Storage
→ Async Result Retrieval

curl -X POST "https://api.runexa.ai/v1/finance/analyze" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx" \
  -F "file=@statement.pdf" \
  -F "output_language=en"

{
  "job_id": 9,
  "status": "pending",
  "progress": 0,
  "status_message": "Finance API analysis queued...",
  "credits_used": 7,
  "remaining_api_credits": 88
}

curl -X POST "https://api.runexa.ai/v1/legal/analyze" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx" \
  -F "file=@contract.pdf" \
  -F "output_language=en"

{
  "job_id": 10,
  "status": "pending",
  "credits_used": 12,
  "remaining_api_credits": 76
}

curl -X POST "https://api.runexa.ai/v1/business/analyze" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx" \
  -F "file=@business.xlsx" \
  -F "output_language=en"

{
  "job_id": 13,
  "status": "pending",
  "credits_used": 30,
  "remaining_api_credits": 22
}

curl -X POST "https://api.runexa.ai/v1/study/analyze" \
  -H "Authorization: Bearer rk_live_xxxxxxxxx" \
  -F "file=@study.pdf" \
  -F "output_language=en" \
  -F "education_level=university"

{
  "job_id": 14,
  "status": "pending",
  "credits_used": 5,
  "remaining_api_credits": 17
}

واجهة Jobs API

استرجع حالة ونتائج مهام الذكاء الاصطناعي غير المتزامنة.

GET /v1/jobs/{job_id}

{
  "id": 15,
  "status": "completed",
  "progress": 100,
  "result": {}
}

الأخطاء

حدود المعدل