Langsung ke konten
POST AI agent ready /v1/avatar

Avatar API - Generator Identitas Gratis

Buat avatar yang deterministik dan berbeda secara visual dari input string apa pun. Berikan email, nama pengguna, atau ID pengguna, dan API akan mengembalikan pola identitas simetris. Seed yang sama selalu menghasilkan gambar yang sama, sehingga Anda dapat menggunakannya sebagai avatar default yang konsisten tanpa menyimpan file.

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

Gambar profil bawaan

Tetapkan avatar unik untuk setiap pengguna baru saat mendaftar dengan meneruskan email mereka ke API. Pengguna melihat ikon warna-warni, bukan siluet abu-abu umum, yang membuat rangkaian komentar dan daftar anggota terlihat berbeda.

Git melakukan ikon penulis

Tampilkan avatar identitas di sebelah pesan komit di dasbor Git khusus. Hash email penulis untuk menghasilkan ikon yang konsisten, cocok dengan pola yang digunakan GitHub dan GitLab untuk pengguna tanpa foto profil.

Peserta forum anonim

Hasilkan avatar dari ID sesi atau nama pengguna anonim sehingga setiap peserta dalam rangkaian diskusi memiliki identitas visual yang dapat dikenali, bahkan tanpa akun.

Frequently asked questions

Apakah benih yang sama selalu menghasilkan avatar yang sama?
Ya. Algoritma pembangkitan bersifat deterministik. Melewati "john@example.com" hari ini akan mengembalikan pola yang sama persis bulan depan. Anda dapat mengandalkan ini untuk tampilan yang konsisten tanpa menyimpan gambar dalam cache.
Apa bedanya dengan Gravatar?
Gravatar mengharuskan pengguna untuk mengunggah foto ke gravatar.com. API ini menghasilkan pola geometris dari string apa pun, tanpa memerlukan tindakan pengguna. Ini berfungsi sebagai avatar default yang berdiri sendiri atau cadangan Gravatar.
Bisakah saya menyesuaikan warnanya?
Warna berasal dari rangkaian biji untuk memastikan keunikan visual. API tidak menerima palet khusus. Jika Anda memerlukan warna khusus merek, ambil SVG dan ganti nilai isian.
Berapa ukuran terbesar yang bisa saya minta?
Anda dapat meminta hingga 512x512 piksel. Untuk keluaran SVG, gambar diskalakan ke ukuran tampilan apa pun, apa pun parameter ukurannya.
Apakah nilai benih disimpan atau dicatat?
Tidak. Benih tersebut di-hash dalam memori untuk menghasilkan pola dan dibuang. API tidak menyimpan, mencatat, atau mengirimkan masukan Anda ke pihak ketiga.

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