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

Avatar API - مولد Identicon مجاني

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

Parameters

stringrequired

Input string used to generate the avatar pattern. Typically an email address or username.

number

Width and height of the output image in pixels.

string

Background color as a CSS color value. Defaults to #f0f0f0 if omitted.

Code examples

curl -X POST https://api.botoi.com/v1/avatar \
  -H "Content-Type: application/json" \
  -d '{"seed":"john@example.com","size":256,"bg_color":"#f0f0f0"}'

When to use this API

الصور الشخصية الافتراضية

قم بتعيين صورة رمزية فريدة لكل مستخدم جديد عند التسجيل عن طريق تمرير بريده الإلكتروني إلى واجهة برمجة التطبيقات. يرى المستخدمون رمزًا ملونًا بدلاً من الصورة الظلية الرمادية العامة، مما يجعل سلاسل التعليقات وقوائم الأعضاء مميزة بصريًا.

جيت ارتكاب أيقونات المؤلف

عرض الصور الرمزية المتطابقة بجوار رسائل الالتزام في لوحة معلومات Git المخصصة. قم بتجزئة البريد الإلكتروني للمؤلف لإنشاء رمز ثابت، يتوافق مع النمط الذي يستخدمه GitHub وGitLab للمستخدمين الذين ليس لديهم صور للملف الشخصي.

المشاركون المجهولون في المنتدى

قم بإنشاء صور رمزية من معرفات الجلسة أو المقابض المجهولة بحيث يتمتع كل مشارك في سلسلة المناقشة بهوية مرئية يمكن التعرف عليها، حتى بدون حساب.

Frequently asked questions

هل تنتج نفس البذرة دائمًا نفس الصورة الرمزية؟
نعم. خوارزمية التوليد حتمية. يؤدي تمرير "john@example.com" اليوم إلى إرجاع نفس النمط بالضبط الشهر المقبل. يمكنك الاعتماد على هذا للحصول على عرض متسق دون تخزين الصورة مؤقتًا.
كيف يختلف هذا عن Gravatar؟
يتطلب موقع Gravatar من المستخدمين تحميل صورة على موقع gravatar.com. تنشئ واجهة برمجة التطبيقات هذه نمطًا هندسيًا من أي سلسلة، دون الحاجة إلى إجراء من جانب المستخدم. إنه يعمل كصورة رمزية افتراضية مستقلة أو كنسخة احتياطية من Gravatar.
هل يمكنني تخصيص الألوان؟
الألوان مشتقة من سلسلة البذور لضمان التفرد البصري. لا تقبل واجهة برمجة التطبيقات (API) لوحة الألوان المخصصة. إذا كنت بحاجة إلى ألوان خاصة بعلامة تجارية معينة، فاجلب ملف SVG واستبدل قيم التعبئة.
ما هو أكبر حجم يمكنني طلبه؟
يمكنك طلب ما يصل إلى 512 × 512 بكسل. بالنسبة لمخرجات SVG، يتم تغيير حجم الصورة إلى أي حجم عرض بغض النظر عن معلمة الحجم.
هل يتم تخزين قيمة البذور أو تسجيلها؟
لا، يتم تجزئة البذرة في الذاكرة لإنتاج النموذج ثم يتم التخلص منها. لا تقوم واجهة برمجة التطبيقات (API) بتخزين مدخلاتك أو تسجيلها أو نقلها إلى أطراف ثالثة.

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