Bắt đầu nhanh

CLF AI Gateway là API chuẩn OpenAI cho DeepSeek V4 (context 1M), Kimi và GLM, trả trước và tính tiền theo token. Nếu code của bạn đã gọi API OpenAI, thứ duy nhất phải đổi là base URL và key.

1. Tạo tài khoản và API key

Đăng ký (không cần thẻ), rồi tạo key ở trang API keys trong dashboard. Key bắt đầu bằng sk-gw- và chỉ hiện đầy đủ đúng một lần — hệ thống chỉ lưu hash. Chi tiết: Xác thực.

2. Nạp credit

Gateway hoạt động trả trước: request trừ vào số dư credit. Nạp trong dashboard — chuyển khoản VietQR được xác nhận tự động (thường trong vài giây), thẻ quốc tế cũng dùng được. Cách tính tiền từng request: Billing.

3. Trỏ SDK vào gateway

Base URL cho mọi request:

base URL

https://api.clfaigateway.dev/v1

Xác thực bằng header chuẩn Authorization: Bearer sk-gw-... và dùng bất kỳ model id nào từ GET /v1/models (bảng giá trực tiếp ở trang models).

curl https://api.clfaigateway.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-gw-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.6",
    "messages": [{"role": "user", "content": "Hello!"}],
    "max_tokens": 256
  }'

Streaming, tool calling và JSON mode đều đi qua cùng endpoint này — xem Streaming để biết cách nhận SSE và bắt lỗi giữa stream.

Toàn bộ endpoint

Endpoint	Scope	Công dụng
`POST /v1/chat/completions`	`chat`	Inference chuẩn OpenAI — cả stream lẫn không stream.
`GET /v1/models`	key hợp lệ bất kỳ	Danh sách model key của bạn gọi được, kèm giá và khả năng.
`GET /v1/models/{id}`	key hợp lệ bất kỳ	Một model theo id — tên canonical hoặc alias đang bật.
`GET /v1/credits`	`usage:read`	Số dư hiện tại và các khoản credit còn hiệu lực.
`GET /v1/generation?id=`	`usage:read`	Chi phí + số token của một request sau khi chốt sổ.
`GET /v1/usage`	`usage:read`	Usage tổng hợp theo giờ/ngày, lọc được theo model.

Mọi response đều mang x-request-id — hãy giữ lại: nó là khóa tra GET /v1/generation và khóa làm việc với hỗ trợ. Lỗi của mọi endpoint dùng chung một envelope, liệt kê ở Mã lỗi.

Vòng đời model

Tên model bạn gọi (như kimi-k2.6) là định danh ỔN ĐỊNH của chúng tôi, tách khỏi ID upstream phía sau. Model upstream trong mảng này bị thay máu rất nhanh — có khi chỉ vài tháng. Chính sách của chúng tôi:

Tên luôn chạy tiếp: khi model upstream bị khai tử, chúng tôi TỰ tay remap tên sang bản kế nhiệm gần nhất — có cân nhắc, giá được rà lại trước, không bao giờ thừa hưởng âm thầm.
Bạn biết trước: thay đổi model và giá được công bố trên blog và trang models trước khi có hiệu lực. Giá không bao giờ áp hồi tố.
Thứ gì đang trả lời là công khai: ID upstream đang phục vụ từng tên nằm ở GET /v1/models trong trường cf_model_id, và trong log request của bạn theo từng cú gọi.

Trang sauXác thực