FAQ

TokSpan là một cổng API AI hợp nhất cung cấp cho bạn một endpoint tương thích OpenAI duy nhất để truy cập hơn 200 mô hình từ hơn 50 nhà cung cấp — bao gồm OpenAI, Anthropic, Google, Meta, DeepSeek và nhiều hơn nữa.

Đây là cách nó hoạt động: bạn gửi request đến API của TokSpan theo định dạng OpenAI chuẩn. TokSpan định tuyến request của bạn đến nhà cung cấp ngược dòng phù hợp, chuyển đổi định dạng nếu cần, xử lý phản hồi và trả về cho bạn. Từ góc nhìn của bạn, bạn gọi một API duy nhất — TokSpan quản lý định tuyến mô hình, cân bằng tải, giới hạn tốc độ, failover tự động và theo dõi chi phí phía sau hậu trường.

Bạn chỉ cần một tài khoản TokSpan. Chúng tôi xử lý mọi quan hệ với nhà cung cấp ngược dòng thay bạn — không cần tài khoản riêng với OpenAI, Anthropic hay Google.

• Một khóa, mọi mô hình — Truy cập GPT, Claude Opus, Gemini Pro và DeepSeek chỉ với một khóa API duy nhất. Không cần quản lý nhiều tài khoản thanh toán trên các nhà cung cấp khác nhau.
• Không phụ thuộc nhà cung cấp — Chuyển đổi mô hình chỉ bằng một tham số. Mã của bạn giữ nguyên bất kể nhà cung cấp nào phục vụ request.
• Failover tự động — Nếu một nhà cung cấp gặp sự cố, lưu lượng tự động định tuyến đến nhà cung cấp dự phòng phục vụ cùng mô hình. Không cần can thiệp thủ công.
• Phạm vi toàn cầu — Mạng biên toàn cầu phục vụ nhà phát triển trên toàn thế giới.
• Minh bạch chi phí — Thanh toán hợp nhất và theo dõi mức sử dụng thời gian thực trên mọi mô hình và nhà cung cấp trong một bảng điều khiển duy nhất.

Bắt đầu chỉ mất khoảng 5 phút:

1. Đăng ký tại api.tokspan.com/register
2. Thêm credit vào tài khoản qua thẻ tín dụng/ghi nợ, Apple Pay / Google Pay hoặc ví điện tử địa phương
3. Tạo khóa API từ trang Dashboard → API Keys
4. Thực hiện cuộc gọi đầu tiên — chỉ cần đổi base_url thành https://api.tokspan.com/v1 và dùng khóa mới của bạn

Nếu bạn đã dùng OpenAI SDK, bạn chỉ mất 30 giây. Xem hướng dẫn Quickstart để có ví dụ mã bằng Python, TypeScript và curl.

Chúng tôi không cung cấp bản dùng thử miễn phí vĩnh viễn — đây là lý do điều đó thực sự tốt cho bạn:

• Không suy giảm chất lượng do trợ giá — Bản dùng thử miễn phí ở quy mô lớn đòi hỏi cắt giảm chất lượng cơ sở hạ tầng, hỗ trợ hoặc truy cập mô hình. Chúng tôi đầu tư mọi thứ vào độ tin cậy và phạm vi mô hình.
• Chỉ trả cho những gì bạn dùng — Không cam kết tối thiểu. Nạp ít tùy nhu cầu. Hầu hết nhà phát triển chi dưới $5 trong tháng thử nghiệm đầu tiên.
• Mọi mô hình, không giới hạn — Số dư đã thanh toán cho bạn quyền truy cập ngay lập tức vào mọi mô hình tiên tiến trên nền tảng — không giới hạn mô hình kiểu "chỉ dành cho bản miễn phí".

Tài khoản mới đôi khi có thể nhận được credit khởi đầu khuyến mãi. Kiểm tra Dashboard sau khi đăng ký.

Chúng tôi cung cấp quyền truy cập vào hơn 200 mô hình trên tất cả danh mục chính: LLM (GPT, Claude Opus, Gemini Pro, DeepSeek, Llama, Mistral), Vision & Multimodal, Embeddings & Reranking, và Speech & Audio (TTS + STT).

Duyệt toàn bộ danh mục trực tiếp với giá mỗi token hiện tại tại api.tokspan.com/pricing. Xem tài liệu Models để có tổng quan danh mục và so sánh khả năng.

Giá của TokSpan hoàn toàn minh bạch. Bạn trả cho token bạn tiêu thụ và giá mỗi token của mọi mô hình được hiển thị trước.

Giá mỗi token của mọi mô hình được hiển thị theo thời gian thực trên Model Hub trước khi bạn thực hiện cuộc gọi. Giá bạn thấy là giá bạn trả — không chi phí ẩn, không hóa đơn bất ngờ.

Không có phí đăng ký hàng tháng và không cam kết tối thiểu. Nạp bất kỳ số tiền nào và bắt đầu gọi mô hình ngay lập tức.

Chúng tôi chấp nhận thẻ tín dụng và thẻ ghi nợ (Visa, Mastercard, American Express) thanh toán an toàn qua Stripe, cùng với Apple Pay và Google Pay. Chúng tôi cũng hỗ trợ thanh toán qua ví điện tử địa phương (ví dụ: Alipay và WeChat Pay) tại các khu vực có hỗ trợ — phương thức thanh toán hiển thị khi thanh toán phụ thuộc vào vị trí của bạn.

Tất cả thanh toán được tính bằng USD. Số dư của bạn cập nhật ngay lập tức sau khi thanh toán được xác nhận.

Có, với chính sách sau:

• Thanh toán thẻ & ví điện tử — Credit chưa sử dụng đủ điều kiện hoàn tiền trong 7 ngày kể từ khi mua. Phí dịch vụ nền tảng (biên lợi nhuận chúng tôi thêm vào giá nhà cung cấp) không được hoàn lại cho token đã tiêu thụ.

Để yêu cầu hoàn tiền, liên hệ support@tokspan.com với email tài khoản và chi tiết thanh toán của bạn.

Có. Credit chưa sử dụng hết hạn sau 12 tháng kể từ khi mua. Chính sách này cho phép chúng tôi quản lý trách nhiệm phía nhà cung cấp trong khi giữ phí dịch vụ ở mức thấp nhất có thể. Bạn sẽ nhận được email nhắc nhở 30 ngày và 7 ngày trước khi credit hết hạn. Ngày hết hạn hiển thị trong Dashboard tại mục Billing → Credits.

TokSpan thông báo cho bạn trước khi số dư cạn kiệt để bạn kịp nạp tiền:

1. Đặt ngưỡng cảnh báo số dư thấp trong Dashboard → Billing
2. Khi số dư xuống dưới ngưỡng này, bạn sẽ nhận được cảnh báo qua email và chúng tôi khuyến nghị bật webhook / thông báo trong ứng dụng để nhận cảnh báo theo thời gian thực cho các sự kiện quan trọng
3. Khi chạm ngưỡng, chỉ cần nạp tiền qua thẻ, Apple Pay / Google Pay hoặc ví điện tử địa phương trên trang Billing

Để workload production không bị gián đoạn, hãy giữ số dư lành mạnh và đặt cảnh báo để được thông báo trước khi tiền cạn. Bạn không cần lo về các khoản phí bất ngờ — yêu cầu dừng sạch sẽ với lỗi rõ ràng insufficient_user_quota khi số dư về 0 và bạn có thể nạp tiền bất cứ khi nào sẵn sàng.

Bạn có nhiều lớp kiểm soát chi phí:

• Giới hạn chi tiêu cho từng key — Đặt giới hạn chi tiêu cứng cho mỗi khóa API. Khi khóa dùng hết hạn mức, request bị từ chối cho đến khi bạn nâng giới hạn hoặc nạp tiền.
• Rate limit của nền tảng — Giới hạn RPM (request mỗi phút) và TPM (token mỗi phút) áp dụng cho tài khoản và nhóm gói của bạn; giới hạn cao hơn có sẵn theo yêu cầu.
• Whitelist mô hình — Giới hạn khóa chỉ cho các mô hình cụ thể (ví dụ: chỉ cho phép mô hình rẻ hơn cho khóa phát triển).
• IP whitelisting — Giới hạn sử dụng khóa cho các địa chỉ IP hoặc dải cụ thể.
• bảng điều khiển mức sử dụng thời gian thực — Theo dõi chi tiêu theo khóa, mô hình và khoảng thời gian trong Bảng điều khiển.

Giới hạn theo khóa (hạn mức chi tiêu, truy cập mô hình, IP whitelist) được cấu hình từ Dashboard → API Keys khi tạo hoặc chỉnh sửa khóa. Xem Key Scoping để biết chi tiết.

Token được tính chính xác như cách nhà cung cấp ngược dòng tính: prompt token + completion token = tổng token tính phí. Chúng tôi chuyển tiếp qua tokenizer của từng nhà cung cấp để số lượng khớp với những gì bạn thấy khi gọi trực tiếp nhà cung cấp.

Với đầu vào đa phương thức (hình ảnh, âm thanh, video): mỗi nhà cung cấp có công thức riêng để chuyển đổi media sang token tương đương. Chúng tôi chuyển tiếp qua cách tính của nhà cung cấp — bảng điều khiển của bạn hiển thị số token và chi phí cuối cùng. Nhìn chung: hình ảnh độ phân giải cao khoảng ~85–170 token mỗi ảnh (GPT), âm thanh khoảng ~50 token mỗi giây (nhận dạng giọng nói).

Với mô hình có prompt caching (Claude, GPT), prompt token đã cache được tính phí theo mức chiết khấu cache của nhà cung cấp. bảng điều khiển mức sử dụng của bạn phân tách chi tiêu token thường và token đã cache.

Không — chúng tôi không lưu trữ prompt hay completion của bạn. Dữ liệu của bạn đi qua cơ sở hạ tầng của chúng tôi theo thời gian thực và không được lưu lại. Chúng tôi chỉ ghi nhật ký metadata của request (mô hình, số token, timestamp, ID khóa API) để đảm bảo độ chính xác của hóa đơn và ngăn chặn lạm dụng. Điều này là cần thiết để tính toán mức sử dụng của bạn và bảo vệ nền tảng.

Chúng tôi không bao giờ dùng prompt hay completion của bạn để đào tạo mô hình, và không bao giờ bán hoặc chia sẻ dữ liệu của bạn với bên thứ ba.

Điều này phụ thuộc vào nhà cung cấp và cài đặt của bạn:

• OpenAI — Không đào tạo trên lệnh gọi API (kể từ tháng 3/2023). Dữ liệu gửi qua API không được dùng để đào tạo mô hình theo mặc định.
• Anthropic — Không đào tạo trên dữ liệu API. Dữ liệu Claude API không được dùng để cải thiện mô hình trừ khi bạn chủ động đồng ý.
• Google (Gemini) — Không đào tạo trên mức sử dụng API trả phí. Mức sử dụng bản miễn phí có thể chịu điều khoản khác.
• Nhà cung cấp khác — Chính sách khác nhau. Kiểm tra điều khoản của từng nhà cung cấp. Chúng tôi khuyến nghị xem lại chính sách sử dụng dữ liệu của nhà cung cấp nếu đây là mối quan tâm.

Nếu đây là ưu tiên của bạn, đội ngũ của chúng tôi có thể giúp bạn chọn nhà cung cấp có chính sách không đào tạo rõ ràng cho khối lượng công việc của bạn — liên hệ support@tokspan.com.

Tất cả khóa API đều được mã hóa khi lưu trữ (AES-256). Bạn có thể xem lại khóa bất kỳ lúc nào trong Bảng điều khiển — nếu khóa bị mất hoặc nghi ngờ lộ, hãy thu hồi và tạo khóa mới. Tất cả lưu lượng API được mã hóa bằng TLS 1.3 khi truyền tải. Chúng tôi khuyến nghị sử dụng khóa API với giới hạn IP, phạm vi mô hình và giới hạn chi tiêu hàng tháng để bảo vệ theo chiều sâu. Xoay vòng khóa mỗi 90 ngày như một thực hành bảo mật tốt nhất.

Bảo mật là nền tảng của TokSpan. Cơ sở hạ tầng của chúng tôi được xây dựng xoay quanh các biện pháp kiểm soát sau:

• TLS 1.3 — tất cả dữ liệu khi truyền đều được mã hóa đầu cuối.
• AES-256 — khóa API và thông tin xác thực được mã hóa khi lưu trữ.
• MFA — xác thực đa yếu tố được hỗ trợ trên mọi tài khoản.
• Thực hành tuân thủ GDPR — tối thiểu hóa dữ liệu và công khai quyền riêng tư được mô tả trong Chính sách Bảo mật của chúng tôi.

Khách hàng enterprise có thể yêu cầu thêm chi tiết về tình hình bảo mật của chúng tôi tại support@tokspan.com.

Có. Dịch vụ lưu trữ của chúng tôi triển khai các yêu cầu của GDPR và CCPA: tối thiểu hóa dữ liệu (chúng tôi không lưu trữ prompt/kết quả của bạn), giới hạn mục đích (metadata chỉ được sử dụng cho thanh toán và ngăn chặn lạm dụng), xóa dữ liệu người dùng theo yêu cầu và công khai minh bạch về xử lý dữ liệu.

Đối với yêu cầu nghiêm ngặt về cư trú dữ liệu hoặc tuân thủ, hãy liên hệ đội ngũ của chúng tôi — chúng tôi có thể cung cấp DPA (Thỏa thuận Xử lý Dữ liệu) và trao đổi nhu cầu của bạn. Gửi email tới support@tokspan.com.

Bạn có thể xóa tài khoản và tất cả dữ liệu liên quan từ Bảng Điều Khiển → Cài Đặt → Tài Khoản → Xóa Tài Khoản. Việc xóa tài khoản là vĩnh viễn và không thể hoàn tác.

Về số dư của bạn:

• Mọi credit còn lại tại thời điểm xóa sẽ bị mất. Chúng tôi khuyến nghị sử dụng hết số dư hoặc yêu cầu hoàn tiền trước khi bắt đầu xóa.
• Hồ sơ thanh toán theo yêu cầu pháp lý (biên lai thanh toán, hóa đơn) được lưu giữ trong thời gian luật định — thường là 7 năm.
• Tất cả dữ liệu tài khoản khác (khóa API, nhật ký sử dụng, email, cài đặt) sẽ bị xóa vĩnh viễn trong vòng 30 ngày.

Có. DPA khả dụng cho tài khoản enterprise và team. Chúng tôi cung cấp DPA tiêu chuẩn bao gồm nghĩa vụ của bên xử lý dữ liệu theo GDPR, công khai nhà xử lý phụ, biện pháp bảo vệ chuyển giao xuyên biên giới (SCC) và cam kết thông báo vi phạm. Liên hệ support@tokspan.com với yêu cầu của đội ngũ pháp lý của bạn — thời gian phản hồi thông thường là 2–3 ngày làm việc.

Có, 100%. Thay đổi base_url thành https://api.tokspan.com/v1 và mã OpenAI SDK hiện tại của bạn hoạt động ngay lập tức — Python, Node.js, Go, curl hoặc bất kỳ thư viện tương thích OpenAI nào.

Các tính năng được hỗ trợ:

• Chat Completions — Hỗ trợ đầy đủ bao gồm tin nhắn system/user/assistant
• Streaming — SSE (Server-Sent Events) với stream: true
• Function / Tool Calling — Gọi công cụ song song, chế độ strict
• JSON Mode — Đầu ra có cấu trúc với response_format
• Vision / Image Input — Hình ảnh URL và base64
• Embeddings — Hỗ trợ đầy đủ trên nhiều nhà cung cấp
• Audio — TTS (text-to-speech) và STT (speech-to-text)
• Images — Tạo hình ảnh qua các mô hình hình ảnh hàng đầu
• Rerank — Hỗ trợ đầy đủ
• Reasoning Effort — Kiểm soát độ sâu suy luận qua tham số reasoning_effort trên các mô hình hỗ trợ

Một số mô hình suy luận chấp nhận tham số tiêu chuẩn reasoning_effort để kiểm soát độ sâu suy luận. TokSpan chuyển tiếp tham số này đến nhà cung cấp ngược dòng — khả năng hỗ trợ tùy thuộc vào chính mô hình đó:

Chỉ cần đưa nó vào phần thân yêu cầu — ví dụ: "reasoning_effort": "high". Nếu mô hình không chấp nhận tham số này, hãy bỏ qua và mô hình sẽ dùng giá trị mặc định. Xem danh mục mô hình để biết hỗ trợ theo từng mô hình.

Chuyển đổi mô hình chỉ là thay đổi một dòng — chỉ cần đặt trường model trong yêu cầu của bạn thành bất kỳ ID mô hình nào trong danh mục:

• Tương thích OpenAI: model: "MODEL_NAME" trong phần thân yêu cầu
• Gốc Anthropic: model: "MODEL_NAME" trong phần thân yêu cầu
• Tương thích Gemini: model="MODEL_NAME" trong generateContent

Mã của bạn vẫn giữ nguyên — chỉ tên mô hình thay đổi, và mọi định dạng dùng chung một khóa API và số dư. Xem danh mục đầy đủ với giá trực tiếp tại api.tokspan.com/pricing.

Có. Prompt caching được tự động áp dụng khi nhà cung cấp ngược dòng hỗ trợ (Claude, GPT, Gemini). Khi bạn gửi cùng một tiền tố prompt qua nhiều yêu cầu, nhà cung cấp sẽ lưu vào bộ nhớ đệm phần tính toán và tính phí cho bạn mức giá chiết khấu cho phần được lưu đệm — thường là giảm 90% so với giá token prompt đầy đủ.

Bạn không cần thay đổi mã của mình. TokSpan chuyển tiếp trạng thái cache từ nhà cung cấp và bảng điều khiển của bạn hiển thị mức sử dụng token đã lưu đệm so với chưa lưu đệm. Để tối đa hóa tỷ lệ trúng cache:

• Giữ nội dung tĩnh (system prompt, tài liệu ngữ cảnh) ở đầu prompt của bạn
• Đặt nội dung động (tin nhắn người dùng, truy vấn mới nhất) ở cuối
• Sử dụng lại cùng system prompt trên nhiều yêu cầu

Đọc hướng dẫn tối ưu hóa đầy đủ: Prompt Caching.

TokSpan trả về mã trạng thái HTTP tiêu chuẩn:

Chúng tôi khuyến nghị triển khai exponential backoff với jitter cho lỗi 429 và 5xx. Xem Mã Lỗi để tham khảo đầy đủ với nội dung phản hồi lỗi.

Chúng tôi nhắm đến thời gian hoạt động 99.99% cho API lưu trữ của mình. Cơ sở hạ tầng của chúng tôi được mở rộng theo chiều ngang trên nhiều vùng khả dụng, không có điểm lỗi duy nhất.

Các gói enterprise bao gồm SLA chính thức với cam kết thời gian hoạt động, phạt credit và phản hồi sự cố ưu tiên. Liên hệ support@tokspan.com để biết điều khoản SLA.

TokSpan tự động chuyển đổi dự phòng sang mô hình khỏe mạnh tiếp theo. Hệ thống của chúng tôi:

1. Phát hiện nhà cung cấp không khả dụng (lỗi 5xx, timeout) trong vài giây
2. Bỏ qua nhà cung cấp có sự cố gần đây (cửa sổ cooldown tạm thời)
3. Định tuyến đến nhà cung cấp tiếp theo trong chuỗi failover (được TokSpan tự động quản lý)

Chuỗi được xây dựng qua các nhà cung cấp phục vụ cùng một mô hình (ví dụ: nhiều nhà cung cấp phục vụ dòng GPT), đảm bảo không có yêu cầu nào bị rớt. Bạn chỉ trả tiền cho nhà cung cấp cuối cùng phục vụ yêu cầu — các lần thử thất bại không bị tính phí. Xem Auto Failover để hiểu cách hoạt động.

TokSpan thêm chi phí định tuyến tối thiểu — thường dưới 100ms cho các yêu cầu API. Yếu tố độ trễ chính là tốc độ tạo của mô hình ngược dòng (time-to-first-token và tokens-per-second), không bị ảnh hưởng bởi việc định tuyến qua TokSpan.

Đối với ứng dụng nhạy cảm với độ trễ:

• Bật streaming (stream: true) để người dùng thấy token khi chúng được tạo
• Chọn một mô hình nhanh hơn hoặc nhẹ hơn cho nhu cầu tương tác — xem hồ sơ độ trễ trong danh mục mô hình
• Định tuyến qua mạng edge toàn cầu của TokSpan — yêu cầu được phục vụ từ khu vực gần người dùng nhất

Có. Kiểm tra Trang Trạng Thái API để biết tình trạng dịch vụ thời gian thực, lịch sử sự cố và lịch bảo trì định kỳ. Đăng ký nhận thông báo sự cố qua email, webhook, Bark hoặc Gotify — xem Webhooks để thiết lập.

Đăng nhập vào bảng điều khiển, vào Khóa API và nhấp + Khóa Mới. Đặt cho mỗi khóa một tên mô tả (ví dụ: "production-backend", "mobile-app-dev", "staging-test"). Bạn có thể tạo không giới hạn số lượng khóa.

Chúng tôi đặc biệt khuyến nghị tạo khóa riêng cho từng môi trường (development, staging, production). Mỗi khóa có theo dõi sử dụng, giới hạn chi tiêu và phạm vi mô hình độc lập — giúp dễ dàng giám sát chi phí theo từng môi trường hoặc từng khách hàng. Nếu khóa development bị xâm phạm, khóa production của bạn không bị ảnh hưởng.

Thu hồi ngay lập tức từ Bảng điều khiển — việc thu hồi có hiệu lực tức thì (trong vòng 60 giây). Tạo khóa mới và cập nhật ứng dụng của bạn. Giám sát nhật ký sử dụng để phát hiện hoạt động đáng ngờ trên khóa cũ trước khi xóa.

Các thực hành phòng ngừa tốt nhất:

• Sử dụng giới hạn IP để hạn chế nơi khóa có thể được sử dụng
• Đặt giới hạn chi tiêu hàng tháng để giới hạn phạm vi thiệt hại nếu khóa bị lộ
• Xoay vòng khóa mỗi 90 ngày
• Không bao giờ commit khóa vào version control — sử dụng biến môi trường hoặc trình quản lý secrets

Tạo khóa API riêng cho từng môi trường từ Bảng điều khiển:

• Development — Giới hạn chi tiêu chặt (ví dụ: $10), giới hạn ở mô hình rẻ hơn, không giới hạn IP (cho dev cục bộ)
• Staging — Giới hạn vừa phải (ví dụ: $50), cùng mô hình như production, giới hạn IP đến máy chủ staging của bạn
• Production — Giới hạn cao hơn tùy nhu cầu, tất cả mô hình, giới hạn IP đến máy chủ production của bạn

Mỗi khóa có bảng điều khiển sử dụng, cảnh báo và nhật ký hoạt động riêng. Thiết lập này mang lại khả năng hiển thị chi phí theo từng môi trường và ngăn lỗi giai đoạn dev làm tiêu hao ngân sách production của bạn. Xem Phạm Vi Khóa để tham khảo cấu hình đầy đủ.

Có. Các gói enterprise bao gồm:

• Quản lý tài khoản riêng — Đầu mối liên hệ duy nhất cho mọi câu hỏi
• Hỗ trợ ưu tiên — Thời gian phản hồi được đảm bảo (thường dưới 2 giờ cho vấn đề nghiêm trọng)
• SLA tùy chỉnh — Cam kết thời gian hoạt động với phạt credit được điều chỉnh theo nhu cầu của bạn
• Hóa đơn tổng hợp — Điều khoản Net-30/60, đơn đặt hàng, thanh toán đa tiền tệ
• Giới hạn tốc độ tùy chỉnh — Giới hạn RPM/TPM được mở rộng theo khối lượng công việc của bạn
• Hỗ trợ triển khai — Đánh giá kiến trúc và hướng dẫn tích hợp cho khối lượng công việc của bạn

Liên hệ support@tokspan.com với yêu cầu của bạn — chúng tôi sẽ chuẩn bị đề xuất trong vòng 1 ngày làm việc.

Chúng tôi cung cấp nhiều kênh hỗ trợ:

• Email — support@tokspan.com cho câu hỏi về thanh toán, tài khoản và kỹ thuật. Chúng tôi phản hồi trong vòng 24 giờ; hầu hết câu hỏi được giải quyết trong một lần trao đổi.
• Trang Trạng Thái — Trạng Thái API để cập nhật sự cố thời gian thực. Đăng ký nhận thông báo khi có gián đoạn.

Khách hàng enterprise nhận kênh Slack chia sẻ với đội ngũ kỹ thuật của chúng tôi để cộng tác thời gian thực.