Bắt đầu nhanh
Từ con số không đến câu trả lời đầu tiên trong ba bước: đặt base URL, tạo API key, rồi gửi request.
Base URL
Client định dạng OpenAI dùng base URL kết thúc bằng /v1. Client định dạng Anthropic dùng root không có /v1, vì SDK của chúng tự thêm /v1/messages.
| Cài đặt | Giá trị | Dùng bởi |
|---|---|---|
| base_url | https://ai.geraikita.com/v1 | SDK OpenAI, Cline/Roo (OpenAI Compatible), OpenCode, n8n, Continue |
| base_url | https://ai.geraikita.com | SDK Anthropic, Claude Code CLI, Cline (Anthropic) |
| api_key | gk-… | Mọi client — key được tạo trong Dashboard |
Tạo API key
- Đăng nhập vào Geraikita AI.
- Nạp GeraiPoints ở trang Nạp tiền (hoặc nhận key miễn phí ở Bansos).
- Mở Dashboard → Tạo API key. Sao chép key
gk-…— key gốc chỉ hiển thị một lần.
Lưu key trong biến môi trường, ví dụ
export GERAIKITA_API_KEY=gk-…, thay vì ghi thẳng vào mã.Request đầu tiên
Chọn ngôn ngữ hoặc SDK bạn dùng. Mọi ví dụ đều gọi model claude-sonnet-5; thay bằng id model khác trong danh sách model.
bash
curl https://ai.geraikita.com/v1/chat/completions \
-H "Authorization: Bearer gk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Xin chào!"}]
}'Phản hồi là JSON có cấu trúc giống API OpenAI (hoặc Anthropic khi dùng /v1/messages), bao gồm đối tượng usage chứa số token bị tính phí.
Stream câu trả lời
Với câu trả lời dài và công cụ agentic, hãy bật stream để từng phần câu trả lời được gửi về ngay. Máy chủ gửi header tức thì và tín hiệu keepalive trong lúc chờ token đầu tiên. Đặt timeout của ứng dụng tối thiểu 300 giây.
bash
curl https://ai.geraikita.com/v1/chat/completions -N \
-H "Authorization: Bearer gk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"stream": true,
"messages": [{"role": "user", "content": "Xin chào!"}]
}'Bước tiếp theo
- Cài đặt trong Claude Code, Cline, OpenCode và các công cụ khác: Tích hợp công cụ.
- Dùng công cụ agentic? Đọc Cài đặt công cụ agentic trước khi gửi prompt lớn.
- Xem các id model có sẵn: Model.
- Xử lý lỗi đúng cách: Giới hạn & mã lỗi.