API Reference

Tổng quan về BizCity API — gateway AI thống nhất cho WordPress.

BizCity API tương thích với chuẩn OpenAI Chat Completions. Nếu bạn đã quen với OpenAI API hoặc OpenRouter, bạn chỉ cần thay đổi base_url và api_key là dùng được ngay.

💡 Tương thích OpenAI SDK BizCity API sử dụng cùng request/response schema với OpenAI. Bạn có thể dùng OpenAI SDK (Python, Node.js, PHP) chỉ cần trỏ base_url về BizCity.

Base URL

Tất cả API requests gửi tới:

text

https://bizgpt.vn/wp-json/bizcity/v1/llm

Quick Start

Ví dụ gọi Chat Completion bằng curl:

bash

curl https://bizgpt.vn/wp-json/bizcity/v1/llm/chat \
  -H "Authorization: Bearer biz-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-chat-v3-0324:free",
    "messages": [
      { "role": "user", "content": "Xin chào!" }
    ]
  }'

Danh sách Endpoints

Method	Endpoint	Mô tả	Auth
POST	`/chat`	Chat completion (blocking)	Bearer
POST	`/chat/stream`	Chat completion (SSE streaming)	Bearer
POST	`/embeddings`	Tạo vector embeddings	Bearer
GET	`/models`	Danh sách models khả dụng	Bearer
GET	`/models/purposes`	Purpose → model mapping	Bearer
GET	`/usage`	Thống kê sử dụng	Bearer
GET	`/balance`	Số dư credits	Bearer
GET	`/health`	Health check	Public
GET	`/public/models`	Public model browser	Public

Response Format

Tất cả responses trả về JSON. Thành công sẽ có HTTP status 200. Lỗi trả về object error:

json

{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}

SDK & Libraries

BizCity API hoạt động với mọi OpenAI-compatible SDK:

Ngôn ngữ	SDK	Ghi chú
Python	`openai`	Đổi `base_url` + `api_key`
Node.js	`openai`	Tương tự Python
PHP	`wp_remote_post()`	WordPress HTTP API
cURL	CLI	Ví dụ ở trên

Tiếp → Xác thực