Tài liệu tích hợp

Tài liệu API XKey

API tương thích hoàn toàn với chuẩn OpenAI. Nếu bạn đã dùng OpenAI SDK, chỉ cần đổi base URL.

Thông tin kết nối

Base URL

https://xkey.click/v1

Xác thực

Authorization: Bearer sk-xkey-...

API key được tạo trong Bảng điều khiển → API Keys. Key chỉ hiển thị đầy đủ đúng một lần khi tạo, hãy lưu lại ngay.

Bắt đầu nhanh

curl https://xkey.click/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xkey-..." \
  -d '{
    "model": "gpt-5-mini",
    "messages": [{"role": "user", "content": "Xin chào!"}]
  }'

Danh sách endpoint

Method	Đường dẫn	Mô tả
POST	/v1/chat/completions	Hội thoại, hỗ trợ streaming, tools, vision
POST	/v1/completions	Sinh văn bản kiểu cũ (tương thích ngược)
POST	/v1/embeddings	Tạo vector embedding
POST	/v1/images/generations	Sinh ảnh từ mô tả
GET	/v1/models	Liệt kê toàn bộ model khả dụng và giá

Tính năng nâng cao

stream = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Kể một câu chuyện ngắn"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

Cấu hình cho công cụ phổ biến

Mọi công cụ hỗ trợ chuẩn OpenAI đều dùng được. Dưới đây là cấu hình cho các công cụ thông dụng nhất.

export ANTHROPIC_BASE_URL="https://xkey.click/v1"
export ANTHROPIC_AUTH_TOKEN="sk-xkey-..."
export ANTHROPIC_MODEL="claude-sonnet-4"
claude

Mã lỗi

HTTP	Mã lỗi	Ý nghĩa
401	invalid_api_key	API key sai, bị vô hiệu hoá hoặc đã hết hạn
402	insufficient_balance	Số dư không đủ — cần nạp thêm tiền
403	model_not_allowed	API key bị giới hạn không được dùng model này
404	model_not_found	Tên model không tồn tại trong danh mục
429	rate_limit_exceeded	Vượt giới hạn RPM đã đặt cho API key
502	upstream_error	Nhà cung cấp trả về lỗi — thử lại hoặc đổi model
504	timeout	Nhà cung cấp phản hồi quá lâu

Định dạng lỗi

{
  "error": {
    "message": "Số dư tài khoản không đủ...",
    "type": "upstream_error",
    "param": null,
    "code": "insufficient_balance"
  }
}

Header phản hồi hữu ích

x-request-id

Mã request, dùng để tra cứu trong nhật ký sử dụng

x-llmgw-cost

Chi phí của request này, tính bằng VND

content-type

text/event-stream khi bật streaming

Cần hỗ trợ tích hợp?

Đội ngũ kỹ thuật hỗ trợ tiếng Việt qua Telegram và Zalo, phản hồi trong giờ hành chính.

Liên hệ hỗ trợ