تخطي إلى المحتوى
POST AI agent ready /v1/og/generate

OG Image API - مولد رسم بياني مفتوح مجاني

قم بإنشاء صور Open Graph ذات العلامة التجارية للمشاركة الاجتماعية. قم بتمرير عنوان ووصف اختياري، واختر سمة فاتحة أو داكنة، وقم بتعيين لون مميز، وقم بتضمين عنوان URL لشعارك. تقوم واجهة برمجة التطبيقات (API) بإرجاع صورة PNG جاهزة للاستخدام يمكنك استخدامها كعلامة تعريف og:image.

Parameters

stringrequired

Primary text rendered on the image. Keep it under 60 characters for best results.

string

Secondary text rendered below the title. Optional but recommended for context.

string

Background theme for the generated image.

string

Accent color as a hex code (include the #). Applied to highlights and borders.

string

URL to a logo image displayed on the card. PNG or SVG recommended.

Code examples

curl -X POST https://api.botoi.com/v1/og/generate \
  -H "Content-Type: application/json" \
  -d '{"title":"Ship faster with the Botoi API","description":"150+ developer endpoints, zero infrastructure to manage.","theme":"dark","color":"#3b82f6","logo":"https://botoi.com/logo.png"}'

When to use this API

معاينات منشورات المدونة الديناميكية

قم بإنشاء صورة OG فريدة لكل منشور مدونة في وقت النشر. قم بتمرير عنوان المنشور ومقتطفه إلى واجهة برمجة التطبيقات (API)، وقم بتخزين ملف PNG الناتج مؤقتًا على CDN الخاص بك، وستحصل كل مشاركة على وسائل التواصل الاجتماعي على معاينة للعلامة التجارية دون الحاجة إلى عمل تصميم يدوي.

بطاقات مشاركة لوحة المعلومات SaaS

عندما يشارك المستخدمون تقريرًا أو رابط لوحة المعلومات، أنشئ صورة OG بشكل سريع تتضمن عنوان التقرير وإحصائيات ملخصة. يرى المستلمون معاينة غنية بدلاً من خيار احتياطي عام.

بطاقات منتجات التجارة الإلكترونية

قم بإنشاء صور معاينة اجتماعية لصفحات المنتج عن طريق تمرير اسم المنتج وسعره ولون العلامة التجارية. يعرض كل رابط منتج تتم مشاركته على Twitter أو Slack أو LinkedIn بطاقة مصقولة.

Frequently asked questions

ما الأبعاد التي تستخدمها صورة OG التي تم إنشاؤها؟
تُرجع واجهة برمجة التطبيقات ملف PNG بحجم 1200 × 630، وهو الحجم الموصى به لصور Open Graph وTwitter Card. يتم عرض هذا القرار جيدًا عبر Facebook وLinkedIn وTwitter وSlack وDiscord.
هل يمكنني استخدام خط مخصص؟
تأتي واجهة برمجة التطبيقات (API) بخط sans-serif نظيفًا مُحسّنًا لسهولة القراءة في أحجام معاينة الوسائط الاجتماعية. تحميلات الخطوط المخصصة غير مدعومة في الوقت الحالي.
كيف يمكنني أن أخدم هذا كعلامة og:image الخاصة بي؟
يمكنك إما استدعاء واجهة برمجة التطبيقات (API) في وقت الإنشاء، وحفظ ملف PNG على CDN الخاص بك، والإشارة إلى عنوان URL هذا في العلامة الوصفية الخاصة بك؛ أو قم بتوجيه عنوان URL لـ og:image مباشرةً إلى نقطة نهاية واجهة برمجة التطبيقات (API) إذا كنت تفضل الإنشاء عند الطلب.
هل تم تخزين الاستجابة مؤقتًا؟
لا تقوم واجهة برمجة التطبيقات بتخزين الاستجابات مؤقتًا. إذا قمت بإرسال نفس المعلمات مرتين، فسيتم إنشاء صورة جديدة في كل مرة. لاستخدام الإنتاج، قم بتخزين النتيجة على CDN الخاص بك أو تخزين الكائنات.
ماذا يحدث إذا حذفت الوصف؟
يتم عرض الصورة مع العنوان فقط، في المنتصف عموديًا. يعمل هذا بشكل جيد مع العناوين القصيرة والمثيرة.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs