> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mibyanai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# البداية مع API

> أرسل أول طلب من مشروعك إلى واجهة Mibyan المتوافقة مع OpenAI

تحتاج إلى حساب، ومشروع في [Mibyan Platform](https://platform.mibyanai.com)، ومفتاح API للمشروع. أنشئ المفتاح من الخادم، واحفظه في مدير أسرار؛ لا تضعه في المتصفح أو تطبيق الهاتف.

## إرسال أول طلب

```bash theme={null}
export MIBYAN_API_KEY="mbn_test_..."

curl https://api.mibyanai.com/v1/chat/completions \
  -H "Authorization: Bearer $MIBYAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mibyan-4.1",
    "messages": [{"role": "user", "content": "اكتب ملخصاً تنفيذياً عن إطلاق منتج."}]
  }'
```

## قبل الإنتاج

* تأكد أن `model` في الاستجابة هو `mibyan-4.1`.
* راجع ظهور الطلب في Usage وLogs للمشروع.
* اختبر مفتاحاً غير صالح وتأكد من التعامل مع `401`.
* أضف مهلة وإعادة محاولة تدريجية لأخطاء `429` و`5xx`.
* لا تسجل المفتاح كاملاً أو محتوى المستخدم الحساس في سجلات تطبيقك.