المطورون

REST API

JSON للإدخال والإخراج. تُكتب الإجابات في الخلفية: أرسل الرسالة ثم اقرأ المحادثة حتى تصبح `pending` قيمة false.

• POST/api/v1/conversationsبدء محادثة: { text, locale?, model?, tools? } — أنشئ بـ tools صورًا أو فيديو أو موسيقى أو صوتًا.
• POST/api/v1/conversations/{id}إضافة رسالة: { text, locale?, model?, tools? }
• GET/api/v1/conversations/{id}أحدث الرسائل وحالة `pending`
• GET/api/v1/conversationsمحادثاتك الأخيرة
• GET/api/v1/creditsأرصدتك المتبقية
• GET/api/v1/toolsالأدوات المتاحة وتكلفتها

curl -X POST https://bilgisam.com/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "ar"}'
# → {"id": "…"}  — اقرأ الإجابة بعد بضع ثوانٍ
curl https://bilgisam.com/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

حقول اختيارية: instructions (تعليمات النظام لهذه الجولة، حتى 20,000 حرف؛ أرسلها مع كل طلب)، private (true ← 402 needs-private إذا كانت خطتك لا تسمح بالمحادثات الخاصة). لا تستخدم إجابات الواجهة البرمجية استدلال النموذج (thinking): سريعة وبتكلفة ثابتة.

الأخطاء: 401 مفتاح غير صالح · 402 رصيد غير كافٍ أو يلزم Pro · 409 إجابة سابقة قيد التنفيذ أو تلزم الموافقة · 429 تجاوز الحد.