Bắt đầu trong 6 bước
Từ lúc đăng ký đến yêu cầu đầu tiên chỉ mất khoảng hai phút.
- 1Bước 1 / 6
Tạo tài khoản
Mở trang Đăng ký, nhập tên, email và mật khẩu, đánh dấu đồng ý điều khoản rồi bấm Create account.

- 3Bước 3 / 6
Nạp mã coupon
Mở trang Số dư, dán mã coupon và bấm Add to balance. Số dư được cộng ngay lập tức. Bạn có thể nạp thêm coupon vào cùng một tài khoản bất cứ lúc nào; tất cả đều cộng vào một số dư.

- 4Bước 4 / 6
Tạo API key
Mở trang API Keys và bấm Create key. Đặt tên cho key. Spend limit (hạn mức chi tiêu) là tùy chọn: để trống nếu không giới hạn, hoặc đặt hạn mức và key sẽ tạm dừng khi đạt mức đó. Expires (ngày hết hạn) cũng là tùy chọn. Speed (tốc độ): 60 yêu cầu mỗi phút đã bao gồm; tốc độ cao hơn sẽ có giá mỗi token cao hơn một chút.

- 6Bước 6 / 6
Kết nối công cụ
Dán Base URL và key vào Claude Code, Cline, 9Router, Cursor hoặc bất kỳ SDK nào. Xem nên dùng Base URL nào, sau đó xem hướng dẫn cho Claude Code và các công cụ khác.
Thử gửi yêu cầu đầu tiên:
# ~/.zshrc export ANTHROPIC_BASE_URL="https://api.fableaiapi.com" export ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key" claude # that's it
Tôi nên dùng Base URL nào?
Chỉ có một máy chủ nhưng có hai cách gọi. Mỗi công cụ dùng một trong hai cách. Điểm khác nhau duy nhất là có thêm /v1 ở cuối hay không.
/v1. Nếu yêu cầu URL OpenAI, thêm /v1. Không bao giờ dán /messages hoặc /chat/completions vào ô Base URL; công cụ sẽ tự thêm phần đó.Tổng quan các công cụ
Tự gọi API bằng curl hoặc fetch? Dùng địa chỉ đầy đủ: https://api.fableaiapi.com/v1/messages hoặc https://api.fableaiapi.com/v1/chat/completions.
Một số lỗi được tự động sửa: /v1/v1 bị lặp và thiếu /v1 trước /chat/completions vẫn hoạt động. Không thêm dấu gạch chéo ở cuối Base URL.
Claude Code
Đặt Base URL và key vào file cài đặt của Claude Code, rồi chạy claude. Hoạt động trên macOS, Windows, Linux và trong tiện ích VS Code, JetBrains.
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.fableaiapi.com",
"ANTHROPIC_AUTH_TOKEN": "sk-ant-fai-your-key"
}
}Trên Windows, file này nằm tại C:\Users\TÊN-CỦA-BẠN\.claude\settings.json. Bạn cũng có thể đặt hai giá trị này chỉ cho một phiên terminal:
export ANTHROPIC_BASE_URL="https://api.fableaiapi.com" export ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key" claude
$env:ANTHROPIC_BASE_URL="https://api.fableaiapi.com" $env:ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key" claude
/model, hoặc khởi động với claude --model claude-sonnet-5-5. Chạy /status để kiểm tra Base URL hiển thị https://api.fableaiapi.com.Cline, 9Router, Cursor
Dùng cùng một key cho mọi công cụ. Nếu công cụ có tùy chọn Anthropic, hãy chọn nó.
Cline / Roo Code (VS Code)
- API Provider
- Anthropic
- Base URL tùy chỉnh
https://api.fableaiapi.com- API Key
sk-ant-fai-…- Model
claude-sonnet-5-5
- API Provider
- OpenAI Compatible
- Base URL
https://api.fableaiapi.com/v1- API Key
sk-ant-fai-…- Model ID
claude-sonnet-5-5
9Router
- Mở Providers và chọn Add Anthropic Compatible với Base URL
https://api.fableaiapi.com, hoặc Add OpenAI Compatible vớihttps://api.fableaiapi.com/v1. - Bấm Add API Key, dán key, đợi hiện Valid rồi lưu.
- Bấm Import Models. Tất cả model của key sẽ hiện ra.
Cursor
- Mở Settings → Models → API Keys.
- Dán key vào OpenAI API Key và bật Override OpenAI Base URL với
https://api.fableaiapi.com/v1. - Thêm model tùy chỉnh bằng một ID trong danh sách rồi chọn nó trong khung chat.
OpenAI SDK
from openai import OpenAI
client = OpenAI(base_url="https://api.fableaiapi.com/v1", api_key="sk-ant-fai-your-key")
r = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(r.choices[0].message.content)Hỗ trợ streaming, gọi công cụ và hàm, hình ảnh và stream_options.include_usage. Cách tính phí giống định dạng Anthropic.
Tham chiếu API
Xác thực
Gửi key qua một trong hai header. Cả hai đều dùng được ở mọi endpoint, nên công cụ của bạn gửi kiểu nào cũng được.
Không cần header nào khác. Nếu SDK gửi anthropic-version hoặc anthropic-beta, chúng sẽ được chuyển tiếp nguyên vẹn.
curl https://api.fableaiapi.com/v1/messages \
-H "x-api-key: $FABLEAI_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'{
"id": "msg_01...",
"type": "message",
"role": "assistant",
"content": [{ "type": "text", "text": "Hello! How can I help?" }],
"model": "claude-sonnet-5-5",
"stop_reason": "end_turn",
"usage": { "input_tokens": 12, "output_tokens": 9 }
}Model
Mỗi model có một mức giá cho mỗi triệu token. Dùng ID chính xác như hiển thị.
| Model | Model ID | Ngữ cảnh | Giá / 1M |
|---|---|---|---|
| Fable 5.2NEW | 1M | $13.33$20.00 | |
| Fable 5.1 | 1M | $13.33$20.00 | |
| Opus 5.5 | 1M | $12.50 | |
| Sonnet 5.5 | 1M | $12.90 | |
| Haiku 5.5 | 200K | $13.33 | |
| Fable 5 | 1M | $12.12$18.18 | |
| Opus 5 | 1M | $11.43 | |
| Sonnet 5 | 1M | $11.76 | |
| Opus 4.8 | 1M | $11.11 | |
| Opus 4.7 | 1M | $11.11 | |
| Opus 4.6 | 1M | $11.11 | |
| Sonnet 4.6 | 1M | $11.11 | |
| Opus 4.5 | 200K | $11.11 | |
| Sonnet 4.5 | 200K | $11.11 | |
| Haiku 4.5 | 200K | $11.11 | |
| Opus 4.1 | 200K | $11.11 |
Danh sách tương tự được trả về từ GET /v1/models, nên các công cụ như 9Router có thể nhập trực tiếp.
Streaming
Gửi "stream": true. Các sự kiện được chuyển tiếp ngay khi đến. Phí được tính khi stream kết thúc, kể cả khi bạn ngắt kết nối sớm.
import anthropic
client = anthropic.Anthropic(base_url="https://api.fableaiapi.com", api_key="sk-ant-fai-your-key")
with client.messages.stream(
model="claude-sonnet-5-5", max_tokens=1024,
messages=[{"role": "user", "content": "Write a haiku about APIs"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)Giới hạn tốc độ
Mỗi key, đã bao gồm.
Tối đa mỗi key. Key nhanh hơn có giá cao hơn 5% đến 20%.
Tổng tất cả key của một tài khoản.
Đặt tốc độ cho key khi tạo hoặc chỉnh sửa trên trang API Keys. Vượt giới hạn sẽ trả về 429 rate_limit_error kèm header retry-after. SDK chính thức và Claude Code sẽ tự chờ và thử lại.
429 với retry-after: 5 cho đến khi một yêu cầu đang chạy hoàn tất. Điều này giúp số dư không bị âm. Không có gì bị mất; yêu cầu sẽ thành công khi thử lại.Lỗi
Lỗi có cùng định dạng JSON với Anthropic API: {"type":"error","error":{"type":"…","message":"…"}}
Sự cố thường gặp
Sao chép lại toàn bộ key, bắt đầu bằng sk-ant-fai-, không có khoảng trắng ở cuối. Kiểm tra key đang được bật trong bảng điều khiển.
Dùng model ID chính xác như trong danh sách model, ví dụ claude-sonnet-5-5. Không thêm tên nhà cung cấp phía trước.
Kiểm tra công cụ dùng định dạng nào. Định dạng Anthropic cần https://api.fableaiapi.com không có /v1. Định dạng OpenAI cần https://api.fableaiapi.com/v1. Không đặt /messages hoặc /chat/completions vào ô Base URL.
Bạn đã gửi nhiều yêu cầu mỗi phút hơn mức key cho phép, hoặc số dư nhỏ trong khi các yêu cầu khác đang chạy. Đợi vài giây; công cụ sẽ tự thử lại.
Nạp thêm bằng mã coupon trên trang Số dư. Key sẽ hoạt động lại ngay khi số dư được cộng.
Thanh toán
Số dư của bạn đến từ mã coupon. Mỗi model có một mức giá cho mỗi triệu token. Token đầu vào, đầu ra và cache đều tính như nhau, cộng thêm một khoản phí cố định nhỏ cho mỗi yêu cầu từ máy chủ nguồn.
Số token trong phản hồi API là ước tính. Trang Mức sử dụng hiển thị chính xác số token và chi phí của từng yêu cầu (chốt trong khoảng một phút) và có thể xuất ra CSV.

