دليل المستأجر

إعداد المستأجر

1. سجّل من `/renter/register` واحفظ مفتاح `dcp-renter-...`.
2. اشحن المحفظة من `/renter/billing`.
3. اختر مزودًا متاحًا من `/renter/marketplace`.
4. أرسل مهمة من `/renter/playground` أو عبر API.
5. راقب الحالة واسترجع المخرجات.

مسار سريع عبر API

1) التحقق من مفتاح المستأجر

curl -s "https://dcp.sa/api/dc1/renters/me?key=<RENTER_KEY>"

2) استعراض وحدات GPU المتاحة

curl -s "https://dcp.sa/api/dc1/renters/available-providers"

3) إرسال مهمة

curl -s -X POST "https://dcp.sa/api/dc1/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": "اكتب  نقاط عن سوق GPU في السعودية"
    }
  }&#;

4) جلب المخرجات

curl -s "https://dcp.sa/api/dc1/jobs/<JOB_ID>/output?key=<RENTER_KEY>"

سلوك الفوترة

• DCP يستخدم الهللة داخليًا (`100 هللة = 1 ريال`).
• يتم حجز التكلفة التقديرية عند الإرسال.
• التسوية النهائية تعتمد على زمن التشغيل الفعلي.
• أي رصيد غير مستخدم يُعاد بعد التسوية.

نموذج الحالات

التسلسل المعتاد:

`pending -> queued -> running -> completed` (أو حالات نهائية `failed` / `cancelled`)

وثائق مرتبطة

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