المحتوى والفيديو

الأدوات الأربع تعمل كمهام: الرد 202، والنتيجة عبر الاستعلام أو webhook (المهام والنتائج). الصوت والموسيقى والعبارة الختامية والأفاتار تُختار من القوائم المرجعية (البيانات المرجعية).

حزمة المحتوى

POST /content/generate: النطاق tools:contentgen. من بيانات العقار وصوره يصنع GREM أوصافا ومنشورات للشبكات الاجتماعية وفيديو بتعليق صوتي وصفحة هبوط وملف PDF، في مهمة واحدة. تُنشأ للحزمة مسودة عقار.

يلزم 4 صور على الأقل، كعناوين عامة في form.media.photos. ارفع ملفاتك أولا عبر POST /uploads ومرر قيم url المعادة (الملفات).

لا حاجة إلى الحقل user: تُنشأ الحزمة باسم حساب المفتاح.

curl -X POST https://developers.grem.capital/api/v1/content/generate \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0c0e3a5b-7d1e-4b8a-9b2f-1e6d4c3a2b10" \
  -d '{
    "form": {
      "language": "arb",
      "propertyCategory": "apartment", "dealType": "sale",
      "title": "شقة مضيئة من غرفتين قرب الحديقة",
      "totalArea": 64, "rooms": 2, "price": 320000, "priceCurrency": "EUR",
      "addressCountry": "Germany", "addressCity": "Berlin",
      "media": { "photos": ["https://example.com/1.jpg", "https://example.com/2.jpg",
                             "https://example.com/3.jpg", "https://example.com/4.jpg"] }
    }
  }'

الرد 202: jobId (معرّف المهمة) وpropertyId (مسودة العقار). المهمة المنتهية (GET /content/generate/jobs/{id}) تحتوي على:

الملف: GET /artifacts/v1/ai/assistant/announcement/jobs/{jobId}/artifacts/{artifactId}/download. الأحداث: content.completed، content.partial (فشلت بعض الملفات)، content.failed. أقل من 4 صور: 400.

نصوص الإعلان

POST /text/generate: النطاق tools:text. وصف، وعرض تقديمي، ومنشور للشبكات الاجتماعية. يلزم إما objectId أو واحد على الأقل من description وcity وtotalArea، وإلا فالرد 422 مع code: not_enough_input.

curl -X POST https://developers.grem.capital/api/v1/text/generate \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"city":"Berlin","totalArea":64,"rooms":2,"propertyCategory":"apartment","language":"ar","description":"مجددة، فناء هادئ، 5 دقائق إلى المترو."}'

202 مع jobId. النصوص في ملفات المهمة كما في حزمة المحتوى؛ وتحمل المهمة أيضا progress وmasterProfile وerror. الأحداث: text.completed / text.failed.

فيديو من الصور

POST /video/create: النطاق tools:video. فيديو قصير بتعليق صوتي من صورك أو من صور عقار.

الجسم: multipart/form-data، كل خيار حقل نموذج مستقل (لا JSON في حقل data):

curl -X POST https://developers.grem.capital/api/v1/video/create \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "[email protected]" -F "[email protected]" -F "[email protected]" \
  -F "prompt=شقة مشمسة من غرفتين في Berlin Mitte، فناء هادئ" \
  -F "length=short" -F "aspect=9:16" -F "language=ar"

202 مع jobId؛ والفيديو في ملفات المهمة. وتحمل المهمة أيضا progress وmasterProfile وerror كما في حزمة المحتوى. السعر يعتمد على length. الأحداث: video.completed / video.failed.

فيديو الأفاتار

POST /avatar/video: النطاق tools:avatar. مقدم يتحدث عن عقارك.

curl -X POST https://developers.grem.capital/api/v1/avatar/video \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"avatarId":"AVATAR_ID","objectId":"OBJECT_ID","voiceId":"VOICE_ID","scriptText":"..."}'

202 مع jobId. الفيديو: GET /artifacts/v1/ai/assistant/avatar/jobs/{jobId}/artifacts/{artifactId}/download، وartifactId من artifacts في المهمة المكتملة. الأحداث: avatar.completed / avatar.failed. غياب avatarId أو objectId أو قِصر النص: 400 مع الحقول في errors.

مقالات ذات صلة

• البيانات المرجعية: الأصوات، والأفاتارات، والموسيقى، والعبارات الختامية.
• المهام والنتائج: الحالات والملفات.
• الملفات: رفع الصور.