Xây dựng với FableAI API

Một API key dùng cho Claude Code, Cline, 9Router, Cursor, Anthropic SDK và OpenAI SDK. Sao chép Base URL bên dưới, dán key của bạn và chọn model.

Base URL · định dạng Anthropic
Base URL · định dạng OpenAI
API key
sk-ant-fai-…Tạo key
01 /

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.

  1. 1
    Bướ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.

    Biểu mẫu đăng ký
  2. 2
    Bước 2 / 6

    Xác minh email

    Chúng tôi gửi mã 6 chữ số đến email của bạn. Nhập mã vào các ô rồi bấm Verify email. Nếu sau một phút vẫn chưa thấy, hãy kiểm tra thư mục spam.

    Mã email 6 chữ số
  3. 3
    Bướ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ư.

    Trang số dư với mã coupon
  4. 4
    Bướ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.

    Cửa sổ tạo API key
  5. 5
    Bước 5 / 6

    Sao chép và lưu key

    Key chỉ hiển thị một lần. Bấm Copy, lưu key ở nơi an toàn, rồi bấm I've saved it. Vì lý do bảo mật, chúng tôi chỉ lưu dấu vân tay của key nên không thể hiển thị lại. Nếu bị mất, hãy xóa key đó và tạo key mới.

    Key mới chỉ hiển thị một lần
  6. 6
    Bướ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
02 /

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.

Định dạng Anthropic
Dán làm Base URL
Sau đó công cụ sẽ tự gọi https://api.fableaiapi.com/v1/messages.
Claude Code, Anthropic SDK, Cline và Roo Code (nhà cung cấp Anthropic), 9Router (Anthropic Compatible)
Định dạng OpenAI
Dán làm Base URL
Sau đó công cụ sẽ tự gọi https://api.fableaiapi.com/v1/chat/completions.
Cursor, OpenAI SDK, Cline và Roo Code (OpenAI Compatible), 9Router (OpenAI Compatible)
Quy tắc đơn giản: nếu công cụ yêu cầu URL Anthropic, dùng không có /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ụ

Claude CodeANTHROPIC_BASE_URLANTHROPIChttps://api.fableaiapi.com
Anthropic SDK (Python, Node)base_url / baseURLANTHROPIChttps://api.fableaiapi.com
Cline, Roo CodeNhà cung cấp: Anthropic, Base URL tùy chỉnhANTHROPIChttps://api.fableaiapi.com
9RouterAdd Anthropic CompatibleANTHROPIChttps://api.fableaiapi.com
Cline, Roo CodeNhà cung cấp: OpenAI CompatibleOPENAIhttps://api.fableaiapi.com/v1
9RouterAdd OpenAI CompatibleOPENAIhttps://api.fableaiapi.com/v1
CursorOverride OpenAI Base URLOPENAIhttps://api.fableaiapi.com/v1
OpenAI SDK, LiteLLM, LangChainbase_url (OpenAI)OPENAIhttps://api.fableaiapi.com/v1

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.

03 /

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.

~/.claude/settings.json
{
  "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:

macOS / Linux
export ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"
claude
Chọn model trong Claude Code bằng /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.
04 /

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)

Cách A · Anthropic (khuyên dùng)
API Provider
Anthropic
Base URL tùy chỉnh
https://api.fableaiapi.com
API Key
sk-ant-fai-…
Model
claude-sonnet-5-5
Cách B · OpenAI Compatible
API Provider
OpenAI Compatible
Base URL
https://api.fableaiapi.com/v1
API Key
sk-ant-fai-…
Model ID
claude-sonnet-5-5

9Router

  1. Mở Providers và chọn Add Anthropic Compatible với Base URL https://api.fableaiapi.com, hoặc Add OpenAI Compatible với https://api.fableaiapi.com/v1.
  2. Bấm Add API Key, dán key, đợi hiện Valid rồi lưu.
  3. Bấm Import Models. Tất cả model của key sẽ hiện ra.

Cursor

  1. Mở Settings → Models → API Keys.
  2. Dán key vào OpenAI API Key và bật Override OpenAI Base URL với https://api.fableaiapi.com/v1.
  3. 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

Python · openai
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.

05 /

Tham chiếu API

POST/v1/messagesTạo tin nhắn, có hoặc không streaming
POST/v1/chat/completionsChat định dạng OpenAI: streaming, công cụ, hình ảnh
POST/v1/messages/count_tokensĐếm token của yêu cầu (miễn phí)
GET/v1/modelsLiệt kê model (cả hai định dạng)

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.

Kiểu Anthropic
Kiểu OpenAI

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.

Yêu cầu
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"}]
  }'
Phản hồi
{
  "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 }
}
06 /

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ị.

Fable 5.2NEW$13.33 /1M
1M ngữ cảnh
Fable 5.1$13.33 /1M
1M ngữ cảnh
Opus 5.5$12.50 /1M
1M ngữ cảnh
Sonnet 5.5$12.90 /1M
1M ngữ cảnh
Haiku 5.5$13.33 /1M
200K ngữ cảnh
Fable 5$12.12 /1M
1M ngữ cảnh
Opus 5$11.43 /1M
1M ngữ cảnh
Sonnet 5$11.76 /1M
1M ngữ cảnh
Opus 4.8$11.11 /1M
1M ngữ cảnh
Opus 4.7$11.11 /1M
1M ngữ cảnh
Opus 4.6$11.11 /1M
1M ngữ cảnh
Sonnet 4.6$11.11 /1M
1M ngữ cảnh
Opus 4.5$11.11 /1M
200K ngữ cảnh
Sonnet 4.5$11.11 /1M
200K ngữ cảnh
Haiku 4.5$11.11 /1M
200K ngữ cảnh
Opus 4.1$11.11 /1M
200K ngữ cảnh

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.

07 /

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.

Python · anthropic
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)
08 /

Giới hạn tốc độ

60
yêu cầu / phút

Mỗi key, đã bao gồm.

180
yêu cầu / phút

Tối đa mỗi key. Key nhanh hơn có giá cao hơn 5% đến 20%.

300
yêu cầu / phút

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.

Khi số dư nhỏ mà nhiều yêu cầu chạy cùng lúc, yêu cầu mới sẽ nhận 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.
09 /

Lỗi

Lỗi có cùng định dạng JSON với Anthropic API: {"type":"error","error":{"type":"…","message":"…"}}

400invalid_request_errorNội dung yêu cầu không phải JSON hợp lệ hoặc thiếu trường.
401authentication_errorAPI key bị thiếu hoặc sai.
402billing_errorSố dư đã hết. Hãy nạp coupon trên trang Số dư.
403permission_errorKey bị tắt, hết hạn, vượt hạn mức chi tiêu hoặc không được phép dùng model này.
404not_found_errorModel ID này không khả dụng. Kiểm tra chính tả theo danh sách model.
429rate_limit_errorQuá nhiều yêu cầu mỗi phút, hoặc số dư đang bị giữ bởi các yêu cầu đang chạy. Thử lại sau số giây được báo.
502api_errorMáy chủ nguồn tạm thời không kết nối được. Hãy thử lại.
10 /

Sự cố thường gặp

401 hoặc "invalid API key"

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.

404 hoặc "model not found"

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.

Công cụ không kết nối đượ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áo 429 ngay lập tức

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.

402 hết số dư

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.

11 /

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.

Cần thêm số dư hoặc giới hạn cao hơn? Hãy liên hệ quản trị viên của bạn.