المطورون

المصادقة

أنشئ مفتاح API من الملف الشخصي ← المطوِّر وأرسله في ترويسة كل طلب. يعمل المفتاح باسم حسابك؛ لا تشاركه.

Authorization: Bearer sk_...

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://yapayzeka.my/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "ar", "thinking": false}'
# → {"id": "…"}  — اقرأ الإجابة بعد بضع ثوانٍ
curl https://yapayzeka.my/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

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

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