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

# البدء السريع

> شغّل أول نموذج من Marketplace وPlayground والـ API.

# شغّل أول نموذج

استخدم هذا المسار إذا كنت مطوراً أو مستهلكاً تريد استخدام نموذج منشور موجود.

## قبل أن تبدأ

* يمكنك تسجيل الدخول إلى تطبيق المنتج.
* مساحة العمل النشطة لديها وصول إلى Marketplace وPlayground وAPI Keys والفوترة.
* إذا كنت ستستدعي API من خدمة خلفية، لديك صلاحية إنشاء API keys.

## مسار خمس دقائق

1. سجّل الدخول واختر مساحة العمل التي ستملك الاستخدام والفوترة.
2. افتح Marketplace واختر نموذجاً منشوراً يناسب حالتك.
3. جرّب النموذج في Playground بمدخل صغير وآمن.
4. أنشئ API key من صفحة API Keys.
5. شغّل النموذج عبر `POST /api/runs`.

```bash theme={null}
curl -X POST "$AIMP_GATEWAY_URL/api/runs" \
  -H "X-API-Key: $AIMP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "demo-model",
    "mode": "execute",
    "scope": "playground",
    "input": {
      "text": "Summarize this message in one sentence."
    },
    "params": {}
  }'
```

## الاستجابة المتوقعة

الطلبات الناجحة ترجع JSON envelope من Runtime مع بيانات تشغيل يضيفها Gateway.
حقول `output` تختلف حسب عقد النموذج المختار.

```json theme={null}
{
  "success": true,
  "output": {
    "result": {
      "kind": "text",
      "content": "A short summary."
    }
  },
  "run": {
    "status": "completed"
  }
}
```

## الخطوات التالية

* تعلّم كيف [تختار نموذجاً](./browse-marketplace).
* راجع [شكل REST API](./api-overview).
* انسخ أمثلة [Python](./python-sdk) أو [JavaScript](./javascript-examples).
* راجع [الأخطاء وحدود المعدل](./errors-rate-limits) قبل الاستخدام الإنتاجي.