البدء السريع

الهدف

اختر مسارًا واحدًا ونفّذ أول نقطة نجاح واضحة خلال أقل من 5 دقائق.

تريد أول طلب OpenAI-compatible عبر `/v1`؟

استخدم المسار المخصص خلال 60 ثانية:

• مسار أول طلب خلال 60 ثانية

لماذا تختار الفرق DCP

• **ميزة تكلفة الطاقة السعودية**: تشغيل الحوسبة في سوق كهرباء منخفض التكلفة بشكل هيكلي.
• **دعم نماذج عربية**: مسارات تشغيل لـ **ALLaM 7B** و**Falcon H1** و**JAIS 13B** و**BGE-M3**.
• **تنفيذ بالحاويات**: تشغيل المهام داخل قوالب Docker مع دعم NVIDIA runtime.

قواعد المصادقة المشتركة

• العنوان الأساسي: `https://dcp.sa/api/dc1`
• يفضّل استخدام الترويسات: `x-renter-key` و`x-provider-key` و`x-admin-token`
• استخدم `?key=` فقط مع نقاط GET المتوافقة مثل `/renters/me` و`/providers/me`
• جميع الأخطاء ترجع JSON: `{ "error": "descriptive message" }`

المسار A: المستأجر (API-first)

1) ضبط متغيرات البيئة

export DCP_API="https://dcp.sa/api/dc1"
export RENTER_KEY="dc1-renter-your-key"

2) نقطة النجاح الأولى: التحقق من هوية المستأجر

curl -s "$DCP_API/renters/me?key=$RENTER_KEY"

شكل الاستجابة المتوقع:

{
  "renter": {
    "id": ,
    "name": "Renter Name",
    "email": "team@example.com",
    "balance_halala": ,
    "total_jobs": 
  },
  "recent_jobs": []
}

3) المتابعة لأول مهمة

curl -s "$DCP_API/renters/available-providers"

curl -s -X POST "$DCP_API/jobs/submit" \
  -H "Content-Type: application/json" \
  -H "x-renter-key: $RENTER_KEY" \
  -d &#;{
    "provider_id": ,
    "job_type": "llm_inference",
    "duration_minutes": ,
    "container_spec": { "image_type": "vllm-serve" },
    "params": {
      "model": "TinyLlama/TinyLlama-.1B-Chat-v1.",
      "prompt": "اكتب  نقاط عن الذكاء الاصطناعي في الرياض"
    }
  }&#;

المسار B: المزود (daemon-first)

1) ضبط متغيرات البيئة

export DCP_API="https://dcp.sa/api/dc1"
export PROVIDER_KEY="dc1-provider-your-key"

2) تثبيت وتشغيل الـ daemon

curl -fsSL "$DCP_API/providers/download/setup?key=$PROVIDER_KEY&os=linux" | bash

3) نقطة النجاح الأولى: ملف المزود متاح

curl -s "$DCP_API/providers/me?key=$PROVIDER_KEY"

شكل الاستجابة المتوقع:

{
  "provider": {
    "id": ,
    "name": "Provider Name",
    "status": "online",
    "daemon_version": ".3.",
    "last_heartbeat": "--22T19::.000Z",
    "total_jobs": ,
    "total_earnings_halala": 
  },
  "recent_jobs": []
}

المسار C: المدير (التحقق)

1) ضبط متغيرات البيئة

export DCP_API="https://dcp.sa/api/dc1"
export ADMIN_TOKEN="your-admin-token"

2) نقطة النجاح الأولى: إحصاءات لوحة الإدارة

curl -s "$DCP_API/admin/dashboard" \
  -H "x-admin-token: $ADMIN_TOKEN"

شكل الاستجابة المتوقع:

{
  "stats": {
    "total_providers": ,
    "online_now": ,
    "total_renters": ,
    "total_jobs": ,
    "total_revenue_halala": 
  },
  "gpu_breakdown": [],
  "recent_signups": [],
  "recent_heartbeats": []
}

التالي

• مرجع API
• دليل المستأجر
• دليل المزود
• نظرة معمارية