الأدوات نفسها الموجودة في لوحة التحكم متاحة برمجيا. تكلف الأداة ما تكلفه في لوحة التحكم، مع استدعاء API واحد (الحدود والفوترة). العنوان الأساسي: https://developers.grem.capital/api/v1.
القائمة
| الأداة | الطلب | النطاق | طريقة العمل |
|---|---|---|---|
| التقييم السريع | POST /valuation/express | tools:valuation | فوري |
| تقرير التقييم الكامل | POST /valuation/report | tools:valuation | مهمة |
| تقدير الإيجار | POST /valuation/rent | tools:rent | فوري |
| مراجعة التقرير | POST /valuation/review | tools:review | مهمة، مع ملف، تنتظر التأكيد |
| حزمة المحتوى | POST /content/generate | tools:contentgen | مهمة |
| نصوص الإعلان | POST /text/generate | tools:text | مهمة |
| فيديو من الصور | POST /video/create | tools:video | مهمة، مع ملفات |
| فيديو الأفاتار | POST /avatar/video | tools:avatar | مهمة |
| تحسين الصور | POST /photo/enhance | tools:photo | مهمة، مع ملف |
| تنظيف المخطط | POST /floorplan/create | tools:floorplan | فوري (رد 202 يحمل النتيجة)، مع ملف |
| صفحة هبوط العقار | POST /site/create | tools:sitegen | فوري |
| عرض PDF | POST /pdf/create | tools:pdf | مهمة |
| نشرة شخصية | POST /flyer/create | tools:flyer | فوري |
| مسودة من مستندات | POST /draft/extract | tools:draft | فوري، مع ملفات |
حقول كل أداة وأمثلتها وأخطاؤها:
- التقييم: السريع، والتقرير الكامل، والإيجار، ومراجعة التقرير.
- المحتوى والفيديو: حزمة المحتوى، والنصوص، والفيديو، والأفاتار.
- الصور والمخططات: تحسين الصور، والمخطط.
- مواد الإعلان: صفحة الهبوط، وPDF، والنشرة، والمسودة.
المعرّفات التي تأخذها الأدوات مدخلا (الصوت، والأفاتار، والموسيقى، والعبارة الختامية) والإتاحة الحالية: البيانات المرجعية.
إرسال البيانات
- JSON: معظم الأدوات،
Content-Type: application/json. - multipart/form-data: الأدوات التي تأخذ ملفات. تختلف بنية حقولها، وهذا مهم:
- تحسين الصور والمسودة: الخيارات سلسلة JSON واحدة في الحقل
data، والملفات أجزاء منفصلة؛ - الفيديو: كل خيار حقل نموذج مستقل (
prompt،length،musicTrackId...)، والصور أجزاءphotos؛ - مراجعة التقرير والمخطط: الملف في الجزء
file، والخيارات حقول مستقلة.
- تحسين الصور والمسودة: الخيارات سلسلة JSON واحدة في الحقل
إرسال JSON إلى أداة تنتظر ملفا يعطي 400.
الردود
- الأداة المتزامنة تجيب بـ
200مع النتيجة. - الأداة غير المتزامنة تجيب بـ
202مع مهمة؛ والنتيجة عبر الاستعلام أو webhook (المهام والنتائج). - الملفات المُنشأة تُنزَّل عبر
GET /artifacts/{path}.
أرسل كل طلب يشغّل أداة مع Idempotency-Key (عدم التكرار).
غير متاح عبر API
الجولة ثلاثية الأبعاد وتقرير السوق لحي ما متاحان حاليا في لوحة التحكم فقط.