Ảnh placeholder API

Lấy ảnh giữ chỗ đúng kích thước cho mockup và test: /v1/placeholder/600x400.png. Xuất SVG với chữ và màu tuỳ chỉnh, hoặc PNG một màu.

GEThttps://apibox.io.vn/v1/placeholder

API ảnh placeholder trả về ảnh giữ chỗ đúng kích thước bạn cần cho wireframe, prototype giao diện, dữ liệu mẫu và kiểm thử tự động. Ghi kích thước ngay trên đường dẫn – /v1/placeholder/600x400, /v1/placeholder/600x400.png hoặc /v1/placeholder/300 cho ảnh vuông – hoặc dùng tham số width và height (mặc định 600×400).

Mặc định API trả về ảnh SVG có dòng chữ ở giữa (kích thước ảnh, hoặc nội dung text của bạn, tối đa 60 ký tự) trên nền xám trung tính; background (hoặc bg) và color nhận mã màu hex. File SVG rất nhẹ và co giãn không vỡ nét. Với đuôi .png hoặc format=png, bạn nhận file PNG một màu đúng kích thước, không có chữ – tiện khi cần file ảnh raster thật (test upload, xử lý ảnh).

Chiều rộng và chiều cao từ 1 đến 4000 pixel; ảnh PNG giới hạn 4 megapixel. Phản hồi được phép cache trong 7 ngày.

Tham số

TênVị tríKiểuBắt buộcMặc định
sizepathstringkhôngĐoạn đường dẫn tuỳ chọn RỘNGxCAO[.png|.svg], ví dụ /v1/placeholder/600x400.png; chỉ một số thì ảnh vuông.
widthquerynumberkhông600Chiều rộng (1–4000 px), khi không ghi trên đường dẫn.
heightquerynumberkhông400Chiều cao (1–4000 px).
formatquerystringkhôngsvgsvg hoặc png (PNG một màu, tối đa 4 megapixel).
textquerystringkhôngWIDTH×HEIGHTDòng chữ hiển thị trên ảnh SVG (tối đa 60 ký tự).
backgroundquerystringkhôngdde1e7Màu nền, mã hex (tên khác bg).
colorquerystringkhông5a6270Màu chữ, mã hex.

Ví dụ

curl "https://apibox.io.vn/v1/placeholder/600x400?text=Hello" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o output

Kết quả trả về

binary image/svg+xml (600×400 grey placeholder with the text "Hello")

Ứng dụng

  • Lấp ảnh đúng kích thước vào wireframe, prototype giao diện
  • Tạo dữ liệu mẫu cho dự án thương mại điện tử, CMS
  • Kiểm thử luồng upload, resize ảnh và CDN bằng file PNG thật
  • Hiển thị ảnh thay thế trong lúc ảnh thật đang tải

Hỏi đáp

Lấy ảnh placeholder 1200×630 cho Open Graph thế nào?

Gọi /v1/placeholder/1200x630 để nhận SVG có ghi kích thước, hoặc /v1/placeholder/1200x630.png để nhận file PNG.

Có đổi được chữ và màu không?

Được, với ảnh SVG: text=Xin chao&background=1e293b&color=ffffff. Chữ tối đa 60 ký tự, cỡ chữ tự co theo ảnh. Ảnh PNG chỉ là một màu nền.

Kích thước tối đa là bao nhiêu?

4000 pixel mỗi chiều. Ảnh PNG còn bị giới hạn 4 megapixel (ví dụ 2000×2000); yêu cầu lớn hơn sẽ nhận lỗi too_large.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →