API Access Platform

Quickstart

Bạn cần: một API key sk_live_… (nhận khi mua dịch vụ) và domain của nền tảng. Không cần đăng ký tài khoản.

1. Lưu key an toàn

Biến môi trường
# Đặt key vào biến môi trường, đừng viết trực tiếp vào code
export PLATFORM_API_KEY="sk_live_YOUR_KEY"     # macOS/Linux
$env:PLATFORM_API_KEY="sk_live_YOUR_KEY"       # Windows PowerShell

2. Chọn một trong hai chuẩn

Nếu bạn đang dùng SDK OpenAI, chỉ cần đổi baseURL. Nếu đang dùng SDK Anthropic, đổi baseURL và giữ nguyên phần còn lại.

OpenAI-compatible

curl
curl https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [
      {"role": "user", "content": "Viết một câu về Hà Nội"}
    ],
    "max_tokens": 200
  }'

Anthropic-compatible

curl
curl https://YOUR_DOMAIN/v1/messages \
  -H "x-api-key: sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "max_tokens": 200,
    "messages": [
      {"role": "user", "content": "Viết một câu về Hà Nội"}
    ]
  }'

3. Streaming

Thêm "stream": true. Phản hồi là SSE: bề mặt OpenAI kết thúc bằng data: [DONE], bề mặt Anthropic kết thúc bằng event message_stop.

curl (streaming)
curl -N https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [{"role": "user", "content": "Đếm từ 1 đến 5"}],
    "max_tokens": 100,
    "stream": true
  }'

4. Kiểm tra key và hạn mức

Vào /check-key để xem trạng thái key, hoặc /usage để xem mức đã dùng. Bằng API:

curl
# Key nằm trong BODY, không nằm trong URL
curl https://YOUR_DOMAIN/api/usage \
  -H "Content-Type: application/json" \
  -d '{"key": "sk_live_YOUR_KEY"}'
Gặp lỗi?

Xem bảng mã lỗi. Mọi response đều có header x-request-id — gửi mã đó cho hỗ trợ khi cần tra cứu.