API & MCP
Cho lập trình viên và agent tích hợp. Người dùng phổ thông không cần phần này.
Điểm cuối
POST
/v1/kitsTạo bộ nhận diện — trả 202 + kit_idGET
/v1/kits/{id}Đọc kết quả theo schemaPOST
/v1/kits/{id}/regenerateSinh lại kit (variant mới)GET
/v1/kits/{id}/downloadTải gói zip đầy đủVí dụ
curl — tạo kit
curl -X POST https://brandkit.7labx.com/v1/kits \
-H "Authorization: Bearer bk_live_..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "Quán cà phê specialty ở Đà Lạt, phong cách mộc, khách trẻ",
"lang": "vi"
}'phản hồi 202
{
"kit_id": "bk_8f3kQ2vX7nP1",
"status": "processing",
"poll": "GET /v1/kits/bk_8f3kQ2vX7nP1"
}Mã lỗi
| Mã | Ý nghĩa | Cách xử lý |
|---|---|---|
400 | Mô tả không hợp lệ (quá ngắn/dài, bị chặn) | Sửa mô tả theo nội dung lỗi |
401 | Khoá sai hoặc đã thu hồi | Kiểm tra header Authorization |
409 | Kit chưa xong | Poll lại sau vài giây |
429 | Vượt quota 20 kit/ngày | Chờ tới 00:00 UTC |