لهجتيلهجتي
دليل API

صور الحملات

أنشئ صور حملات مستضافة مع التحكم في التنسيق والأسلوب والعناصر البصرية وسياق العلامة والنص الاختياري داخل الصورة.

POST/image-generations

صورة منتج بلا أي نص

include_text=false يطلب صورة بلا ملصقات أو شعارات أو أرقام أو نص وهمي.

curl --request POST \
  --url https://www.lahjty.com/api/v1/image-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: image-coffee-1846" \
  --data '{
  "prompt": "Premium Saudi specialty coffee campaign on a warm stone counter",
  "type": "product_showcase",
  "output_language": "ar",
  "market": "SA",
  "dialect": "saudi",
  "platform": "instagram",
  "style": "photorealistic",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "visual_keywords": [
    "Saudi coffee cup",
    "coffee beans",
    "warm morning light"
  ],
  "excluded_visuals": [
    "people",
    "logos",
    "text"
  ],
  "include_text": false,
  "external_customer_id": "merchant-91"
}'

Example response

response.json
{
  "id": "img_01jexample",
  "object": "image_generation",
  "request_id": "req_01jexample",
  "status": "completed",
  "image": {
    "url": "https://example.convex.cloud/api/storage/example",
    "mime_type": "image/png",
    "width": 1024,
    "height": 1024,
    "bytes": 842331
  },
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "text_policy": {
    "mode": "none",
    "deterministic": false,
    "renderer": null
  },
  "usage": {
    "credits_used": 5,
    "balance_after": 493
  }
}
POST/image-generations

إعلان مع نص عربي داخل الصورة

النص يُكتب بواسطة نموذج الصورة وقد لا تكون تهجئته حتمية؛ راجعه قبل النشر.

curl --request POST \
  --url https://www.lahjty.com/api/v1/image-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: image-offer-1847" \
  --data '{
  "prompt": "Premium weekend specialty coffee promotion",
  "type": "offer_announcement",
  "output_language": "ar",
  "market": "SA",
  "dialect": "saudi",
  "platform": "whatsapp",
  "style": "photorealistic",
  "aspect_ratio": "4:5",
  "resolution": "2K",
  "include_text": true,
  "overlay_text": "خصم 20٪ هذا الأسبوع",
  "overlay_text_language": "ar"
}'

عناصر التحكم المهمة

  • type يحدد صورة حملة أو عرض منتج أو أسلوب حياة أو إعلان عرض أو وعي بالعلامة.
  • visual_keywords / excluded_visuals يحافظان على العناصر المطلوبة ويستبعدان العناصر غير المرغوبة.
  • brand_profile_id يضيف ملف علامة يملكه الحساب دون اختراع شعار.

مسودات قوالب واتساب

أنشئ مسودات بهيكل Meta وفحوص مسبقة، ثم سجّل نتيجة الموافقة الحقيقية للقياس والاسترداد المستحق.

الصوت العربي

حوّل نصوص الحملات العربية كما هي إلى ملفات MP3 مستضافة مع التحكم في اللهجة والأداء والصوت.