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

واجهة برمجة تطبيقات صورة العنصر النائب - أحجام مخصصة مجانية

أنشئ صورًا نائبة للإطارات السلكية والنماذج الأولية والتطوير. حدد الأبعاد الدقيقة، وتراكب النص، واختر ألوان الخلفية والمقدمة، واختر إخراج SVG أو PNG. يكون مفيدًا أثناء تطوير الواجهة الأمامية عندما لا تكون الأصول النهائية متاحة.

Parameters

numberrequired

Image width in pixels.

numberrequired

Image height in pixels.

string

Text overlay centered on the image. Defaults to the dimensions (e.g. "600x400").

string

Background color as a hex code.

string

Text color as a hex code.

Code examples

curl -X POST https://api.botoi.com/v1/placeholder \
  -H "Content-Type: application/json" \
  -d '{"width":600,"height":400,"text":"Hero Banner","bg_color":"#f1f5f9","text_color":"#0f172a"}'

When to use this API

النماذج الأولية للإطار السلكي

قم بإسقاط صور العناصر النائبة في صادرات Figma أو نماذج HTML الأولية حتى يتمكن أصحاب المصلحة من مراجعة التخطيط والتباعد قبل أن يصبح التصوير الفوتوغرافي أو الرسم التوضيحي جاهزًا.

التدريج المحتوى CMS

قم بملء نظام إدارة المحتوى المرحلي بعناصر نائبة ذات حجم صحيح لكل حقل صورة. يرى محررو المحتوى المساحة الدقيقة التي ستشغلها كل صورة قبل تحميل الأصول النهائية.

تركيبات الاختبار الآلي

قم بإنشاء صور عناصر نائبة يمكن التنبؤ بها في اختبارات التكامل لتدفقات تحميل الصور. تأكيد الأبعاد ونوع الملف دون الاعتماد على ملفات التثبيت الثابتة.

Frequently asked questions

ما هو الحد الأقصى لحجم الصورة؟
يمكنك طلب صور يصل حجمها إلى 4000 × 4000 بكسل. بالنسبة للأحجام الأكبر، فكر في إنشاء ملف SVG وتنقيطه على الخادم الخاص بك لتجنب الحمولات الكبيرة.
هل يمكنني استخدام خطوط مخصصة لتراكب النص؟
تعرض واجهة برمجة التطبيقات النص بخط sans-serif الافتراضي. دعم الخط المخصص غير متوفر. إذا كنت بحاجة إلى محرف معين، فاجلب SVG وقم بتحديث سمة عائلة الخط في العلامات.
ما النص الذي يظهر إذا تركت معلمة النص فارغة؟
تعرض الصورة أبعادها، على سبيل المثال "600x400". وهذا يجعل من السهل التحقق من الحجم بنظرة سريعة أثناء التطوير.
هل يجب أن أختار SVG أم PNG؟
SVG أصغر حجمًا في حجم الملف ويمكن تغيير حجمه إلى أي دقة بدون تشويش. يكون PNG أفضل عندما تحتاج إلى ملف نقطي للتحميل إلى الأنظمة التي لا تقبل SVG، مثل بعض عملاء البريد الإلكتروني.
هل يمكنني وضع خلفية شفافة؟
الشفافية غير مدعومة. حدد لون bg الذي يطابق خلفية صفحتك للحصول على تأثير مماثل.

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