Câu hỏi thường gặp
Tài khoản, bảo mật, tính phí, tương thích, xử lý sự cố. Xem đây trước — 90% vấn đề giải quyết trong chưa đầy một phút.
Cập nhật 2026-04-17
Tài khoản & key
Mất API key có lấy lại được không?
Không. Key chỉ hiển thị dạng văn bản một lần khi tạo; sau đó cơ sở dữ liệu chỉ lưu hash. Nếu mất, chỉ cần thu hồi key cũ → tạo key mới trong bảng điều khiển, hai bước.
Một tài khoản tạo được bao nhiêu key?
Mặc định 20, có thể xin nâng. Nên tách theo mục đích: cursor-mac, claude-code-work, ci-prod, v.v. để dễ kiểm toán và thu hồi.
Làm sao giới hạn chi tiêu của một key?
Trong bảng điều khiển, API Keys → Sửa cho phép đặt riêng cho mỗi key:
- Hạn mức ngày (USD)
- Hạn mức tháng (USD)
- Danh sách mô hình được phép gọi
Khi vượt, key đó tự tạm dừng, không ảnh hưởng các key khác.
Có xóa được tài khoản không?
Có. Cài đặt → Bảo mật tài khoản → Xóa tài khoản trong bảng điều khiển; xóa mềm có thể hoàn tác trong 30 ngày, sau đó xóa vật lý theo quy trình GDPR. Xem Chính sách quyền riêng tư.
Tính phí
Chi phí tính thế nào?
Trả theo dùng = (token vào × giá vào + token ra × giá ra) × hệ số mô hình. Hệ số nằm trong 0,3×–0,4×, thấp hơn giá chính thức. Xem trang bảng giá.
Lần nạp đầu nên bao nhiêu?
Từ $1. Nên nạp $2–10 để thử tích hợp trước, khi chuỗi công cụ chạy thông thì nạp nhiều hơn.
Có xuất hóa đơn được không?
Chúng tôi không xuất hóa đơn VAT của Trung Quốc (cả hóa đơn thường lẫn chuyên dụng). Nếu thực sự cần, chúng tôi có thể cung cấp hóa đơn chiếu lệ (proforma invoice) ở nước ngoài theo yêu cầu; hóa đơn chiếu lệ không phải hóa đơn thuế Trung Quốc và không dùng để khấu trừ VAT hay quyết toán trong nước.
Quy tắc hoàn tiền là gì?
- Số dư nạp: không hoàn lại theo kiểu vô điều kiện (kể cả phần chưa dùng)
- Phần đã dùng: không hoàn
- Hoàn tiền thụ động: chỉ khi pháp luật yêu cầu hoặc nền tảng gặp sự cố lớn (xem Chính sách hoàn tiền)
- Thiệt hại do lỗi nền tảng: được bù vào số dư sau khi yêu cầu được duyệt (quy tắc công khai)
Xem Chính sách hoàn tiền và Quy tắc bồi thường như một sản phẩm.
Tương thích
Có hỗ trợ OpenAI SDK không?
Có. Mọi endpoint OpenAI — /v1/chat/completions, /v1/embeddings, v.v. — đều tương thích hoàn toàn; chỉ cần đặt base_url = "https://api.staging.cosmos-router.com/v1".
Có hỗ trợ SDK chính thức của Anthropic không?
Có. SDK anthropic cho Python / Node chạy được sau khi đổi hai biến môi trường:
export ANTHROPIC_BASE_URL="https://api.staging.cosmos-router.com"
export ANTHROPIC_API_KEY="sk-xxxxx"
Có hỗ trợ function calling / tool use không?
Có. Tham số tools của OpenAI và tools của Anthropic đều được chuyển tiếp nguyên trạng lên thượng nguồn.
Có hỗ trợ streaming / SSE không?
Có. stream: true hành xử y hệt API chính thức.
Có hỗ trợ prompt cache không?
Có. Cache tự động của OpenAI và cache_control tường minh của Anthropic đều tính theo giá chính thức (cache hit = 10%–50% giá đầu vào).
Xử lý sự cố
Gọi trả về 401 Unauthorized
- Kiểm tra key bắt đầu bằng
sk-(không phải key chính thứcsk-ant-) - Kiểm tra key chưa bị thu hồi (xem trạng thái ở trang API Keys của bảng điều khiển)
- Kiểm tra định dạng header:
Authorization: Bearer sk-xxxxx(có dấu cách sauBearer)
Gọi trả về 402 Insufficient Quota
Không đủ số dư, hoặc key đã chạm hạn mức ngày/tháng. Nạp tiền trong bảng điều khiển hoặc nâng hạn mức.
Gọi trả về 429 Rate Limit
- Giới hạn mặc định 600 RPM / 300k TPM
- Client nên thử lại với backoff lũy thừa (header
Retry-Aftercho số giây) - Trường hợp tần suất cao, xin nâng hạn mức trong bảng điều khiển
Gọi rất chậm hoặc quá hạn
- Kiểm tra trang trạng thái (/vi/status) xem có đang chuyển kênh không
- Mô hình lớn Claude / GPT mất 1–3 giây cho token đầu là bình thường
- Nếu kéo dài > 10 giây, xem thời gian phản hồi thượng nguồn của yêu cầu đó trong lần gọi gần đây ở bảng điều khiển — có thể thượng nguồn đang xếp hàng
Nội dung phản hồi khác với chính thức
ZetaAPI chuyển tiếp yêu cầu và phản hồi nguyên trạng, không viết lại prompt, không lọc kết quả. Nếu thấy khác biệt, hầu hết là do:
- Lệch phiên bản mô hình (
gpt-4ocó nhiều snapshot) - Khác temperature / top_p, v.v.
- Tính ngẫu nhiên (cố định
seedđể tái lập)
Nếu vẫn nghi ngờ lỗi trung chuyển, mở ticket kèm request ID (header phản hồi x-request-id).
Bảo mật
Prompt và phản hồi của tôi có bị ghi lại không?
- Metadata (tên mô hình, số token, thời gian, mã trạng thái) được giữ cho việc tính phí và giám sát trong 90 ngày
- Nội dung prompt và phản hồi mặc định không được ghi; chỉ khi bạn tự bật “nhật ký gỡ lỗi” mới ghi trong 7 ngày
- Nhân viên không truy cập được nội dung người dùng, nhật ký kiểm toán công khai
Truyền tải có mã hóa không?
TLS 1.3 toàn tuyến — bắt buộc HTTPS cả phía client lẫn phía thượng nguồn.
Nếu key của tôi bị lộ?
Lập tức thu hồi key đó ở trang API Keys của bảng điều khiển (hiệu lực ngay, vô hiệu toàn cục trong 10 giây). Nền tảng cũng tự giám sát key bị lộ trên GitHub và chủ động thông báo cho bạn.
Vẫn chưa có câu trả lời?
- Xem Tham chiếu API để biết chi tiết kỹ thuật
- Xem Changelog xem có phải thay đổi gần đây không
- Mở ticket ở góc dưới phải bảng điều khiển; phản hồi trong 2 giờ làm việc