Bắt đầu nhanh
AI Station là một cổng mô hình thống nhất được xây dựng trên NewAPI. API tương thích với định dạng OpenAI, đồng thời hỗ trợ thêm Anthropic, Gemini, Midjourney cùng nhiều tác vụ plugin video/âm thanh.
Thông tin kết nối
| Mục | Giá trị |
|---|---|
| Base URL | https://test.kailin.com.cn |
| Xác thực | Authorization: Bearer sk-xxxx (trong request header) |
| Giao thức | HTTPS — REST, phát trực tuyến SSE và WebSocket (Realtime) |
Lấy API Key
- Đăng nhập vào Console.
- Tạo một token mới trên trang Tokens / API Keys. Token có dạng
sk-xxxxxxxx. - Hãy bảo quản token cẩn thận. Tuyệt đối không commit token vào kho mã nguồn hay để lộ nó trong mã phía client.
Yêu cầu đầu tiên
Mọi endpoint đều được xác thực bằng header Authorization: Bearer <your token>. Ví dụ về chat completion:
curl https://test.kailin.com.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-token" \
-d '{
"model": "deepseek-v4-1-flash-261017",
"messages": [
{ "role": "user", "content": "Hello, introduce yourself" }
]
}'
https://test.kailin.com.cn/v1/chat/completionsSDK chính thức
API tương thích với OpenAI nên các SDK chính thức dùng được ngay — chỉ cần trỏ base_url về site này:
from openai import OpenAI
client = OpenAI(
api_key="sk-your-token",
base_url="https://test.kailin.com.cn/v1",
)
resp = client.chat.completions.create(
model="deepseek-v4-1-flash-261017",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-token',
baseURL: 'https://test.kailin.com.cn/v1',
});
const resp = await client.chat.completions.create({
model: 'deepseek-v4-1-flash-261017',
messages: [{ role: 'user', content: 'Hello' }],
});
console.log(resp.choices[0].message.content);
SDK Anthropic cũng hoạt động được (trỏ base_url về site này). Xem Anthropic Messages.
Phát trực tuyến (Streaming)
Hầu hết các endpoint văn bản đều chấp nhận "stream": true và phản hồi bằng SSE (Server-Sent Events) — text/event-stream, mỗi sự kiện được bắt đầu bằng data: và kết thúc bằng data: [DONE]:
data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"Hi"},"index":0}]}
data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":" there"},"index":0}]}
data: [DONE]
Đặt stream=True (Python) hoặc stream: true (Node.js) trong SDK và nó sẽ tự xử lý việc phân tích giúp bạn.
Định dạng lỗi
Lỗi được trả về dưới dạng JSON. type thường là new_api_error (ở cấp gateway) hoặc là một lỗi từ phía upstream chẳng hạn như invalid_request_error:
{
"error": {
"message": "Invalid token (request id: 2026xxxx)",
"type": "new_api_error",
"code": ""
}
}
| Mã HTTP | Ý nghĩa | Nguyên nhân thường gặp |
|---|---|---|
| 401 | Xác thực thất bại | Token không hợp lệ, đã bị xóa, hoặc thiếu header Authorization |
| 403 | Bị từ chối truy cập | Token không có quyền truy cập mô hình, nhóm (group) không khớp, hoặc bị giới hạn IP |
| 404 | Không tìm thấy | Tên mô hình hoặc task ID sai |
| 429 | Bị giới hạn tốc độ | Đã chạm giới hạn RPM/TPM — hãy thử lại sau |
| 5xx | Lỗi máy chủ | Sự cố ở kênh upstream — thử lại hoặc đổi sang mô hình khác |
request id trong thông báo lỗi chính là chìa khóa để xử lý sự cố. Hãy kèm theo nó khi báo cáo vấn đề.
Truy vấn mô hình khả dụng
Gọi List Models để xem những mô hình mà token của bạn có thể truy cập:
curl https://test.kailin.com.cn/v1/models \
-H "Authorization: Bearer sk-your-token"
Tổng quan API
| Danh mục | Endpoint | Mô tả |
|---|---|---|
| Models | GET /v1/models | Liệt kê các mô hình khả dụng |
| Văn bản | POST /v1/chat/completions | Chat completion (đa phương thức / tools / reasoning) |
| Văn bản | POST /v1/completions | Hoàn thiện văn bản kiểu cũ |
| Văn bản | POST /v1/responses | Responses API |
| Văn bản | POST /v1/messages | Định dạng Anthropic |
| Embeddings | POST /v1/embeddings | Nhúng văn bản |
| Hình ảnh | POST /v1/images/generations | Tạo hình ảnh |
| Âm thanh | POST /v1/audio/transcriptions v.v. | Chuyển giọng nói thành văn bản / dịch / TTS |
| Realtime | WS /v1/realtime | Hội thoại giọng nói thời gian thực |
| Xếp hạng | POST /v1/rerank | Sắp xếp lại văn bản |
| An toàn | POST /v1/moderations | Kiểm duyệt nội dung |
| Video | POST /v1/video/generations | Tác vụ tạo video |
| Hình ảnh | /mj/* | Proxy Midjourney |
| Tasks | POST /v1/tasks | Tác vụ plugin chung (Suno/Kling v.v.) |