📡 Beeknoee API Documentation
Hướng dẫn sử dụng API của Beeknoee Platform để tích hợp AI vào ứng dụng của bạn.
🔑 Lấy API Key
- Đăng nhập tại platform.beeknoee.com
- Vào API Keys → Tạo API Key
- Nhập tên và click Tạo Key
- Copy và lưu API key (chỉ hiển thị 24 giờ!)
💡 API key dùng được với tất cả model. Chọn model khi gọi API bằng field
modeltrong request body.
🚀 Endpoint
Base URL:
https://platform.beeknoee.com/v1
Chat Completions:
POST https://platform.beeknoee.com/v1/chat/completions
💡 API tương thích với OpenAI SDK, bạn chỉ cần đổi
base_urlvàapi_key.
📊 Muốn ĐỌC usage và số dư ví bằng API? Trang này chỉ nói về việc gọi model. Phần truy vấn lịch sử sử dụng, thống kê theo ngày, số dư ví và quota nằm ở Management API — cùng API key, không cần key riêng.
📝 Ví dụ sử dụng
curl https://platform.beeknoee.com/v1/chat/completions \
-H "Authorization: Bearer sk-bee-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-v3.2",
"messages": [
{"role": "system", "content": "Bạn là trợ lý AI hữu ích."},
{"role": "user", "content": "Xin chào!"}
],
"max_tokens": 1000,
"temperature": 0.7
}'
$headers = @{
"Authorization" = "Bearer sk-bee-YOUR_API_KEY"
"Content-Type" = "application/json"
}
$body = @{
model = "deepseek/deepseek-v3.2"
messages = @(
@{ role = "system"; content = "Bạn là trợ lý AI hữu ích." }
@{ role = "user"; content = "Xin chào!" }
)
max_tokens = 1000
} | ConvertTo-Json -Depth 3
Invoke-RestMethod -Uri "https://platform.beeknoee.com/v1/chat/completions" -Method POST -Headers $headers -Body $body
import requests
response = requests.post(
"https://platform.beeknoee.com/v1/chat/completions",
headers={
"Authorization": "Bearer sk-bee-YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"model": "deepseek/deepseek-v3.2",
"messages": [
{"role": "system", "content": "Bạn là trợ lý AI hữu ích."},
{"role": "user", "content": "Xin chào!"}
],
"max_tokens": 1000
}
)
print(response.json())
from openai import OpenAI
client = OpenAI(
api_key="sk-bee-YOUR_API_KEY",
base_url="https://platform.beeknoee.com/v1"
)
response = client.chat.completions.create(
model="deepseek/deepseek-v3.2", # Chọn model bạn muốn sử dụng
messages=[
{"role": "system", "content": "Bạn là trợ lý AI hữu ích."},
{"role": "user", "content": "Xin chào!"}
],
max_tokens=1000
)
print(response.choices[0].message.content)
const response = await fetch('https://platform.beeknoee.com/v1/chat/completions', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-bee-YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'deepseek/deepseek-v3.2',
messages: [
{ role: 'system', content: 'Bạn là trợ lý AI hữu ích.' },
{ role: 'user', content: 'Xin chào!' }
],
max_tokens: 1000
})
});
const data = await response.json();
console.log(data.choices[0].message.content);
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-bee-YOUR_API_KEY',
baseURL: 'https://platform.beeknoee.com/v1'
});
const response = await client.chat.completions.create({
model: 'deepseek/deepseek-v3.2',
messages: [
{ role: 'system', content: 'Bạn là trợ lý AI hữu ích.' },
{ role: 'user', content: 'Xin chào!' }
],
max_tokens: 1000
});
console.log(response.choices[0].message.content);
📤 Request Format
| Field | Type | Required | Description |
|---|---|---|---|
model | string | ✅ | Model ID (VD: deepseek/deepseek-v3.2, gpt-5.5, claude-sonnet-4-6) |
messages | array | ✅ | Mảng các tin nhắn trong cuộc hội thoại |
max_tokens | number | ❌ | Số tokens tối đa cho response (default: 1000) |
temperature | number | ❌ | Độ sáng tạo 0-2. Không truyền thì model tự dùng mặc định. ⚠️ Claude Opus 4.7+ không hỗ trợ — xem Error Handling |
Message Object
| Field | Type | Description |
|---|---|---|
role | string | system, user, hoặc assistant |
content | string | Nội dung tin nhắn |
📥 Response Format
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1700000000,
"model": "deepseek/deepseek-v3.2",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Xin chào! Tôi có thể giúp gì cho bạn?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 15,
"total_tokens": 40,
"prompt_cache_hit_tokens": 0,
"prompt_cache_miss_tokens": 25
}
}
💰 Pricing
Chi phí được tính theo số tokens sử dụng (input / output), một số model có giá cache hit rẻ hơn. Mức giá khác nhau theo từng model và thay đổi liên tục:
- 💸 Rẻ nhất: nhóm DeepSeek, Qwen, GLM (GLM Flash có bản miễn phí)
- ⚖️ Tầm trung: GPT-5 series, Gemini Flash
- 🧠 Cao cấp: Claude Opus/Sonnet, GPT-5 flagship, Gemini Pro
📊 Xem giá chính xác (realtime) cho từng model tại trang Models trên Dashboard — mỗi card hiển thị giá input/output/cache và discount theo tier.
💡 Cache tokens: Khi bạn gửi các messages giống nhau nhiều lần, hệ thống tự động cache và tính giá rẻ hơn (tuỳ model hỗ trợ).
✨ BeeSynapse Integrations: Một số model (Gemini, Claude, GPT Codex) có thể dùng miễn phí nếu bạn đã kết nối email qua BeeSynapse. Hệ thống tự động ưu tiên free quota trước khi trừ VND.
❌ Error Codes
| Status | Error | Description |
|---|---|---|
| 401 | Unauthorized | API key không hợp lệ hoặc đã bị revoke |
| 400 | Insufficient balance | Tài khoản không đủ tiền (riêng chat/messages: trả 200 kèm cảnh báo ⚠️ trong nội dung) |
| 400 | Provider API error | Lỗi từ AI provider |
| 500 | Internal server error | Lỗi server |
🆘 Support
- Dashboard: platform.beeknoee.com
- Email: [email protected]