Chat AI

Một khóa dùng được cho mọi API trong danh sách Tích hợp API; token luôn trừ vào gói cước của tài khoản này.

Bắt đầu nhanh

1. Tạo khóa ở trên và lưu vào biến môi trường PENTAKAI_API_KEY trên máy chủ của bạn.
2. Gửi POST /api/public/v1/chat kèm header Authorization: Bearer <khóa>.
3. Đọc từng sự kiện delta để hiện chữ dần; sự kiện usage cho biết token đã trừ.

curl -N -X POST https://api.example.com/api/public/v1/chat \
  -H "Authorization: Bearer $PENTAKAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Giải thích thuật toán quicksort"}]}'

Chỉ gọi API từ máy chủ của bạn. Đừng nhúng khóa vào mã chạy trên trình duyệt hay ứng dụng di động: ai có khóa sẽ dùng được token của bạn. Lộ khóa thì thu hồi ngay và tạo khóa mới.

POST /api/public/v1/chat

Thân yêu cầu (JSON):

Dạng stream: mỗi sự kiện có dòng event: và dòng data: (JSON có trường type trùng tên sự kiện). Thứ tự: start → (có thể có queue khi hệ thống đông) → nhiều delta → usage → done. Lỗi giữa chừng là sự kiện error { code, message } và luồng kết thúc.

event: start
data: {"type":"start","id":"req_8f3a1c2b9d0e4f51"}

event: delta
data: {"type":"delta","text":"Quicksort là thuật toán sắp xếp "}

event: delta
data: {"type":"delta","text":"theo kiểu chia để trị..."}

event: usage
data: {"type":"usage","prompt_tokens":96,"output_tokens":512,"total_tokens":608,
       "quota":{"plan_name":"Kim Cương","daily":{"percent":12.4,...},"weekly":{...},"period":{...}}}

event: done
data: {"type":"done","finish_reason":"stop"}

Khi stream = false:

{
  "id": "req_8f3a1c2b9d0e4f51",
  "text": "Quicksort là thuật toán sắp xếp theo kiểu chia để trị...",
  "finish_reason": "stop",
  "usage": { "prompt_tokens": 96, "output_tokens": 512, "total_tokens": 608, "quota": { ... } }
}

Token tính theo con số của mô hình AI: gồm phần đọc vào (system + lịch sử + câu hỏi), câu trả lời và phần “suy nghĩ” của mô hình. Câu hỏi về kèo, tỷ lệ cược được từ chối ngay (finish_reason: "policy") và không tốn token.

GET /api/public/v1/me

Kiểm tra khóa: trả về tên khóa, lượt gọi hôm nay, giới hạn hiện hành và phần trăm hạn mức token đã dùng của gói (giống sự kiện usage).

curl /api/public/v1/me -H "Authorization: Bearer $PENTAKAI_API_KEY"

Lỗi và giới hạn

Lỗi trước khi bắt đầu trả lời có dạng {"error": {"code": "...", "message": "..."}} kèm mã HTTP: