7labx Brandkit

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_id

GET/v1/kits/{id}Đọc kết quả theo schema

POST/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

Kết nối MCP

Dành cho Claude Desktop, Cursor và các agent hỗ trợ Model Context Protocol.

claude_desktop_config.json

{
  "mcpServers": {
    "brandkit": {
      "command": "npx",
      "args": ["-y", "@7labx/brandkit-mcp"],
      "env": {
        "BRANDKIT_API_KEY": "bk_live_...",
        "BRANDKIT_API_URL": "https://brandkit.7labx.com"
      }
    }
  }
}

Công cụ (tools)

Tool	Tác dụng
`brandkit_tao`	Tạo bộ nhận diện từ mô tả doanh nghiệp
`brandkit_lay`	Đọc kit đã tạo theo `kit_id`
`brandkit_tai`	Lấy link tải gói zip

chạy thử

npx -y @7labx/brandkit-mcp --help

Tài liệu

Hướng dẫn bắt đầuLuồng xác thực, tạo kit đầu tiên, xử lý lỗi.

Tham chiếu RESTToàn bộ endpoint, tham số và schema phản hồi.

Hướng dẫn MCPCấu hình cho Claude Desktop, Cursor, agent tự viết.

Schema kitdocs/brand-kit.schema.json — cấu trúc JSON đầy đủ.

Giới hạn & lỗiQuota theo gói, mã lỗi và cách retry.

ChangelogThay đổi theo phiên bản API.