بعض الأدوات تأخذ معرّفات مدخلا: صوتا، أو أفاتار، أو مقطوعة. تحصل عليها بالطلبات الموجودة في هذه الصفحة. كلها طلبات GET مجانية.
الأصوات
GET /voices: أي مفتاح. أصوات التعليق لـ POST /video/create وPOST /avatar/video وحزمة المحتوى (form.voiceId).
curl "https://developers.grem.capital/api/v1/voices?language=ar" \
-H "Authorization: Bearer gsk_live_xxx"
language (اختياري): رمز ISO 639-1، يُبقي الأصوات التي تتحدث هذه اللغة.
| الحقل | الوصف |
|---|---|
items[].voiceId | معرّف للحقل voiceId |
items[].name | اسم الصوت |
items[].gender | male أو female |
items[].description | طابع الصوت |
items[].languages | اللغات التي يتحدثها الصوت جيدا |
items[].isDefault | الصوت الافتراضي |
الأفاتارات
GET /avatar/avatars: النطاق tools:avatar. كل الأفاتارات التي يستطيع حسابك استخدامها في POST /avatar/video: الخاصة بك، والمصنوعة من صورة، والمقدمون القياسيون.
| الحقل | الوصف |
|---|---|
items[].avatarId | معرّف للحقل avatarId |
items[].name | الاسم |
items[].kind | custom (مدرَّب)، photo (من صورة) أو standard |
items[].status | يمكن استخدام ready فقط |
items[].gender | للمقدمين القياسيين |
items[].thumbnailUrl | الصورة المصغرة |
تُنشئ أفاتارك الخاص في لوحة التحكم، في أداة أفاتار الذكاء الاصطناعي؛ وعبر API تستخدم الجاهزة فقط.
موسيقى للفيديو
GET /video/music: النطاق tools:video. مقطوعات خالية من حقوق الملكية للحقل musicTrackId.
| الحقل | الوصف |
|---|---|
items[].trackId | معرّف المقطوعة |
items[].title، items[].artist | العنوان والفنان |
items[].license | الترخيص |
items[].genre | النوع |
items[].durationSec | المدة |
items[].previewPath | الاستماع: https://developers.grem.capital/api/v1 + previewPath (يحتاج إلى النطاق tools:artifacts) |
عبارات ختامية للفيديو
GET /video/endings?language=ar: النطاق tools:video. عبارات ختامية جاهزة بلغة الفيديو لـ POST /video/create، والطول الأقصى لعبارتك الخاصة (ctaText).
| الحقل | الوصف |
|---|---|
language | لغة العبارات |
maxCustomChars | الطول الأقصى لعبارتك الخاصة |
options | العبارات الجاهزة |
options[].intent | معرّف العبارة: مرّره في ctaIntent |
options[].text | العبارة باللغة المطلوبة |
إتاحة الأدوات
GET /tools/status: أي مفتاح.
{ "tools": { "video/create": { "available": true }, "avatar/video": { "available": false } }, "requestId": "req_..." }
الأداة ذات available: false تجيب حاليا بـ 503 service_unavailable ولا تخصم شيئا. تحقق من ذلك قبل تشغيل جماعي. الأدوات غير الموجودة في القائمة ليس لها قيد إتاحة.
سجل الأعمال
GET /works: أي مفتاح. نتائج حسابك في كل الأدوات، سواء عبر API أو من لوحة التحكم، الأحدث أولا.
| المعامل | الوصف |
|---|---|
tool | مسار الأداة: valuation/report، valuation/rent، valuation/review، content/generate، video/create، text/generate، pdf/create، floorplan/create، avatar/video، flyer/create، tour. نتائج الصور والمواقع والمسودات لا تُحفظ في السجل |
status | تصفية حسب الحالة |
limit | العناصر في الصفحة، من 1 إلى 50 (الافتراضي 20) |
cursor | قيمة nextCursor من الصفحة السابقة؛ وأي قيمة أخرى تعطي 400 |
from، to | المنشأة في هذا التاريخ أو بعده / في هذا التاريخ أو قبله |
المعامل المعروف بقيمة غير صالحة يُرفض بـ 400 validation مع اسم الحقل.
| الحقل | الوصف |
|---|---|
items[].id | معرّف العمل |
items[].tool | مسار الأداة |
items[].status، items[].title، items[].language | الحالة، والعنوان، واللغة |
items[].city، items[].country | عنوان العقار إن وُجد |
items[].street، items[].streetNumber | الشارع ورقم المبنى إن وُجدا |
items[].previewUrl، items[].link | صورة المعاينة وملف PDF الجاهز إن وُجدا (التنزيل عبر GET /artifacts/{path})؛ ومعاينة المنشور هي الصورة نفسها (data:image/...) |
items[].object | العقار الذي صُنعت له النتيجة: id، kind، name، isDraft، photoUrl |
items[].repeatIndex، items[].error | عدد مرات إعادة التوليد؛ ونص عام إذا فشلت المهمة |
items[].createdAt | تاريخ الإنشاء |
nextCursor | للصفحة التالية؛ null يعني لا مزيد من الصفحات |