صورة بروفايل فارغة

واجهة صور رمزية نائبة

صور رمزية نائبة مجانية وبلا مفتاح، لكل من بيئات التطوير والإنتاج. وجّه وسم صورة إلى رابط واحصل على SVG نظيف وحتمي بحجم بضعة مئات من البايتات. لا تسجيل ولا تثبيت.

https://blankpfp.com/api/avatar

أمثلة مباشرة

كل الصور أدناه تُقدَّم مباشرة من الواجهة الموصوفة في هذه الصفحة.

بدء سريع

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

<img src="https://blankpfp.com/api/avatar/seed/alice/200" alt="Alice" width="200" height="200">

أو استخدمه كخلفية في CSS:

.avatar {
  width: 96px;
  height: 96px;
  border-radius: 50%;
  background-image: url("https://blankpfp.com/api/avatar/seed/alice/96");
  background-size: cover;
}

في JavaScript، ابنِ الرابط من أي معرّف للمستخدم:

avatar.src = 'https://blankpfp.com/api/avatar/seed/' + encodeURIComponent(user.email) + '/200';

بنية الرابط

الصيغ الأربع كلها تقبل ارتفاعًا اختياريًا. أضف ‎.json‎ إلى أي منها للحصول على البيانات الوصفية الموضحة أدناه بدل الصورة.

الرابط ما تحصل عليه
/api/avatar/{width} صورة رمزية مربعة. الرابط نفسه يعيد الصورة نفسها دائمًا.
/api/avatar/{width}/{height} مساحة غير مربعة، مناسبة لللافتات العريضة أو صور القصص القصيرة.
/api/avatar/seed/{seed}/{width} صورة رمزية حتمية مشتقة من أي نص بذرة.
/api/avatar/id/{id}/{width} صورة رمزية حتمية مشتقة من رقم معرّف، مثل صف في قاعدة بيانات.

بذور حتمية

تُجزَّأ البذرة إلى لون واحد من لوحة من 48 درجة، لذلك تعيد البذرة نفسها الصورة نفسها دائمًا، بلا قاعدة بيانات وبلا حفظ على القرص. استخدم اسم مستخدم أو بريدًا إلكترونيًا أو معرّف سجل. البذور التي تحتوي مسافات أو رموز يجب ترميزها بنسبة مئوية، و‎/api/avatar/id/‎ اختصار للمعرّفات الرقمية.

<img src="https://blankpfp.com/api/avatar/seed/alice/200" alt="alice">\n<img src="https://blankpfp.com/api/avatar/seed/bob/200" alt="bob">\n<img src="https://blankpfp.com/api/avatar/id/237/200" alt="record 237">

معاملات الاستعلام

كل المعاملات اختيارية ويمكن دمجها. القيمة غير المعروفة تُرجع خطأ 400 مع شرح بصيغة JSON بدل صورة معطوبة.

المعامل القيم المقبولة الافتراضي ما تحصل عليه
shape circle | rounded | square circle شكل الصورة الرمزية. الدائرة هي الافتراضي لأن معظم المنصات تقصّ صور الحساب على هذا النحو.
pattern solid | grid | dots | diagonal | checker solid نقش يُرسم فوق الخلفية، مفيد للتمييز بين أنواع العناصر النائبة بنظرة واحدة.
bg #1E3A5F seed لون الخلفية، ويتجاوز اللون الذي كانت سختاره البذرة.
fg #1E3A5F auto لون الحروف الأولى أو خطوط النقش أو الصورة الظلّية، ويُختار تلقائيًا للتباين عند حذفه.
initials 1-2 - حرفان أو رقمان أو رمزان كحد أقصى، يُرسمان في المنتصف، ويُختصر الاسم الكامل إلى حروفه الأولى.
figure 1-15 - معرّف الصورة الظلّية (1-15) أو اسمها، تُرسم بلون fg فوق bg. لها الأولوية على الحروف الأولى، و?figure وحده يزيلها.
outline 0 | 1 0
grayscale 0 | 1 0 يزيل كل الألوان، وهو مفيد لحالات الواجهة الباهتة أو المعطّلة.
blur 0-10 0 نصف قطر تمويه غاوسي. يبقى التمويه داخل الشكل فتبقى الحواف حادة.
random ?random=* - أي قيمة. تعيد صورة مختلفة لكل قيمة بدل صورة ثابتة.

يمكن كتابة الألوان السداسية مع علامة # أو بدونها، وتُوسَّع الصيغة المختصرة مثل ‎#abc‎. بدون bg يأتي الخلفية من البذرة، وبدون fg يُختار لون الحبر تلقائيًا ليبقى مقروءًا. قيمة التمويه التي تتجاوز الحد تُقصّ إلى الحد بدل رفضها، ولا تتجاوز الحروف الأولى حرفين أبدًا.

الصور الظلّية

خمس عشرة صورة ظليّة بجذع، هي نفسها الصور التي يعرضها المولّد، ويُشار إليها بالمعرّف أو بالاسم. يرسم fg الصورة الظلّية و bg الخلفية، لذا يبدو المعرّف نفسه مختلفًا من لوحة إلى أخرى.

Solid fill

Hollow outline (outline=1)

جرّبه

اختر أي صورة رمزية في هذه الصفحة، ثم غيّر المعاملات أدناه. تتحدث المعاينة والكود في آنٍ واحد، وما تنسخه هو بالضبط ما يعيده نقطة النهاية.

معاينة

الخلفية
المقدمة

الرابط

صيغ الاستجابة

تُعاد الصور بصيغة SVG، مما يُبقي الصورة الرمزية المعتادة بين 200 و1000 بايت ويبقيها حادة عند أي كثافة بكسل. أضف ‎.json‎ إلى الرابط نفسه لقراءة الألوان المحسوبة بدلًا من ذلك، وهو أمر مفيد لمطابقة واجهة المستخدم مع الصورة الرمزية.

{
  "ok": true,
  "mode": "seed",
  "seed": "alice",
  "width": 200,
  "height": 200,
  "shape": "circle",
  "pattern": "solid",
  "figure": null,
  "background": "#9CA3AF",
  "foreground": "#111827",
  "initials": null,
  "outline": false,
  "grayscale": false,
  "blur": 0,
  "format": "svg",
  "bytes": 266,
  "url": "https://blankpfp.com/api/avatar/seed/alice/200/200.svg",
  "info": "https://blankpfp.com/api/avatar/seed/alice/200/200.json"
}

ترد الطلبات غير الصالحة بالرمز 400 ومعه جسم بصيغة JSON:

{
  "ok": false,
  "error": "invalid_parameters",
  "errors": ["pattern: expected one of solid, grid, dots, diagonal, checker"],
  "docs": "https://blankpfp.com/docs"
}

التخزين المؤقت والحدود

الروابط ذات البذرة دالة خالصة على العنوان، لذا تُقدَّم بترويسة تخزين غير قابلة للتغيير لمدة سنة وبترويسة ETag. ضع شبكة توصيل محتوى أمام تطبيقك ولن تكلّفك الصور شيئًا بعد الطلب الأول. يمكن أن يكون العرض والارتفاع بين 16 و2048 بكسل، وأي قيمة أكبر تُقصّ إلى الحد بدل رفضها، ويظهر الحجم الناتج في JSON. لعرض صورة مختلفة في كل طلب، أضف ‎?random=‎ متبوعًا بأي قيمة.

أسئلة شائعة

هل أحتاج مفتاح واجهة برمجية أو حسابًا؟

لا. لا تسجيل ولا مفتاح ولا حصة. كل الروابط في هذه الصفحة تعمل كما هي طالما كان الموقع متصلًا.

هل يعيد الرابط نفسه الصورة نفسها دائمًا؟

نعم. الرابط ذو البذرة دالة خالصة على العنوان، لذا من الآمن تثبيته في ترميزك أو قاعدة بياناتك أو اختباراتك. الروابط بلا بذرة ثابتة لكل عنوان أيضًا، و‎?random=‎ هو الخيار الصريح للتخلص من ذلك السلوك.

هل يمكنني ربط هذه الصور واستخدامها تجاريًا؟

نعم. تُولَّد الصور على خادمنا نحن من أشكال متجهية، فلا توجد صور لجهات خارجية ولا أسئلة حول الترخيص ولا حاجة إلى ذكر المصدر. اربطها مباشرة أو نزّلها.

لماذا SVG، وما حدود الحجم؟

الصورة الرمزية بصيغة SVG يبلغ حجمها عادةً بضعة مئات من البايتات، وتتكيف مع أي كثافة عرض، ويمكن إعادة تلوينها عبر CSS. يمكن أن يكون العرض والارتفاع بين 16 و2048 بكسل، وأي شيء أكبر يُقصّ إلى 2048.

أدوات ذات صلة

الرئيسية مقارنة التركيبات