Ả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.
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ên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
size | path | string | khô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. | |
width | query | number | không | 600 | Chiều rộng (1–4000 px), khi không ghi trên đường dẫn. |
height | query | number | không | 400 | Chiều cao (1–4000 px). |
format | query | string | không | svg | svg hoặc png (PNG một màu, tối đa 4 megapixel). |
text | query | string | không | WIDTH×HEIGHT | Dòng chữ hiển thị trên ảnh SVG (tối đa 60 ký tự). |
background | query | string | không | dde1e7 | Màu nền, mã hex (tên khác bg). |
color | query | string | không | 5a6270 | Màu chữ, mã hex. |
Ví dụ
curl "https://apibox.io.vn/v1/placeholder/600x400?text=Hello" \
-H "Authorization: Bearer YOUR_API_KEY" \
-o outputconst res = await fetch('https://apibox.io.vn/v1/placeholder/600x400?text=Hello', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const blob = await res.blob();import requests
res = requests.get(
"https://apibox.io.vn/v1/placeholder/600x400?text=Hello",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
open("output", "wb").write(res.content)<?php
$ch = curl_init('https://apibox.io.vn/v1/placeholder/600x400?text=Hello');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
file_put_contents('output', $response);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
Tạo mã QR
Tạo mã QR dạng PNG hoặc SVG chỉ với một request GET: link, văn bản, WiFi, danh thiếp vCard, e-mail, SMS, số điện thoại, toạ độ. Tuỳ chỉnh màu, kích thước.
|||Tạo mã vạch
Tạo mã vạch Code 128 cho tem nhãn, mã SKU, vận đơn chỉ với một request. Xuất SVG kèm dòng chữ hoặc PNG, tuỳ chỉnh chiều cao, độ rộng và màu sắc.
VQRTạo mã VietQR
Tạo mã QR chuyển khoản VietQR / NAPAS 247 với ngân hàng, số tài khoản, số tiền và nội dung chuyển khoản dạng PNG, SVG hoặc payload JSON. Giải mã VietQR có sẵn.