Jadi penyumbang
Dokumentasi

Satu URL. Itu sahaja.

Tiada daftar, tiada kunci. Semua parameter adalah pilihan dan boleh digabungkan.

Secara ringkas

Apa itu AvatarMelayu?

AvatarMelayu ialah perkhidmatan avatar placeholder percuma berwajah Melayu dan Malaysia yang dijana AI. Developer dan pereka menampal satu URL, contohnya https://avatarmelayu.com/i/150?img=3, ke dalam tag img untuk mendapatkan gambar profil contoh, tanpa daftar dan tanpa API key.

Dokumentasi API → llms.txt OpenAPI

Harga Percuma, tanpa daftar dan tanpa API key
Sumber imej Dijana AI; tiada individu sebenar
Lesen imej CC0 (domain awam), tertakluk kepada Terma
URL asas https://avatarmelayu.com/i/{saiz}
Saiz 16 hingga 1000 piksel, segi empat sama (lalai 150)
Format JPG, WebP, PNG; bulat lutsinar dengan ?shape=circle
Parameter img, u, g, cat, fmt, shape
Kategori bertudung, bersongkok, profesional, pelajar, kanak-kanak, warga-emas, baju-melayu
Bilangan avatar 89
Had kadar 120 permintaan seminit per IP
API JSON https://avatarmelayu.com/api/avatars
Dikemas kini 30 Oktober 2026
Cuba sekarang

Bina URL avatar anda

Pilih tetapan, salin URL, dan tampal ke dalam tag <img>. Pratonton dikemas kini serta-merta.

Pilihan
Pratonton avatar
URL https://avatarmelayu.com/i/150
HTML <img src="https://avatarmelayu.com/i/150" width="150" height="150" alt="">

Asas

Avatar rawak, 150px (saiz lalai):

https://avatarmelayu.com/i

Tentukan saiz dalam piksel (16 hingga 1000, sentiasa segi empat sama):

https://avatarmelayu.com/i/300

Parameter

ParameterNilaiKesan
img1, 2, …Avatar tertentu ikut ID awamnya (lihat galeri).
usebarang teksTeks yang sama sentiasa memberi avatar yang sama.
glelaki, perempuan, gabunganTapis ikut jantina.
catbertudung, bersongkok, profesional, pelajar, kanak-kanak, warga-emas, baju-melayu Tapis ikut kategori.
fmtjpg, webp, pngFormat imej. Lalai: WebP untuk pelayar yang menyokongnya, JPG untuk yang lain.
shapecircleAvatar bulat dengan latar lutsinar (PNG atau WebP).

Contoh gabungan:

https://avatarmelayu.com/i/200?g=perempuan&cat=tudung&fmt=webp&shape=circle

Jika tiada avatar sepadan dengan penapis, avatar rawak dipulangkan supaya reka bentuk anda tidak rosak.

Avatar konsisten

Untuk senarai pengguna dalam mockup, gunakan emel atau ID pengguna sebagai u. Setiap orang mendapat wajah sendiri, dan wajah itu kekal sama setiap kali halaman dimuat.

https://avatarmelayu.com/i/64?u=aina@contoh.my
https://avatarmelayu.com/i/64?u=user-42

Avatar inisial

Perlukan avatar tanpa gambar? Jana avatar inisial SVG daripada nama:

https://avatarmelayu.com/i/initials/Ali%20Bakar?size=150&bg=2563eb&color=ffffff&shape=circle

AB

Contoh kod

HTML

<img src="https://avatarmelayu.com/i/150?img=3" width="150" height="150" alt="Avatar">

Laravel Blade

<img src="https://avatarmelayu.com/i/64?u={{ urlencode($user->email) }}" alt="{{ $user->name }}">

React

const Avatar = ({ user }) => (
  <img src={`https://avatarmelayu.com/i/64?u=${encodeURIComponent(user.email)}`} alt={user.name} />
);

Vue

<img :src="`https://avatarmelayu.com/i/64?u=${user.id}`" :alt="user.name" />

CSS

.hero { background-image: url("https://avatarmelayu.com/i/600?img=4"); }

API JSON

Senarai avatar yang diterbitkan, dengan pagination. Menyokong g, cat dan per_page (maksimum 100).

GET https://avatarmelayu.com/api/avatars?g=lelaki&per_page=10
GET https://avatarmelayu.com/api/avatars/3
{
  "data": [
    { "id": 3, "name": "…", "gender": "lelaki", "category": "songkok",
      "url": "https://avatarmelayu.com/i/300?img=3", "license": "CC0-1.0" }
  ],
  "meta": { "current_page": 1, "last_page": 3, "per_page": 10, "total": 26 }
}

Had & cache

  • Had kadar dikenakan per IP. Jika melebihi, anda menerima HTTP 429 seketika.
  • URL dengan img atau u di-cache selama sehari dan disemak semula dengan ETag, jadi gambar yang dikemas kini muncul dalam masa sehari. URL rawak tidak di-cache supaya setiap tag img mendapat wajah berbeza. Nombor ID tidak pernah diguna semula.
  • Rakan kongsi boleh memohon kunci API untuk had lebih tinggi; hantar sebagai header X-Api-Key atau ?key=.

Lesen & etika

Semua avatar dijana AI dan tidak menggambarkan individu sebenar. Avatar dilesenkan CC0 untuk kegunaan sebagai placeholder dalam mockup, prototaip dan demo. Jangan gunakannya untuk menyamar sebagai seseorang atau dalam konteks yang mengelirukan. Jika sesuatu avatar mirip orang sebenar, ia boleh dilaporkan untuk dibuang.

Baca terma penuh