Trợ Giúp & Hỗ Trợ

FAQ

Câu hỏi thường gặp về TokSpan: bắt đầu, giá cả, sử dụng API, quyền riêng tư dữ liệu, thanh toán, bảo mật và tự lưu trữ.

Chung

TokSpan là gì? Nó hoạt động như thế nào?

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.

Tại sao nên dùng TokSpan thay vì dùng trực tiếp OpenAI hoặc Anthropic?
  • Một khóa, mọi mô hình — Truy cập GPT-4o, Claude Opus, Gemini Pro và DeepSeek V3 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 mô hình dự phòng của bạn. 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.
Làm thế nào để bắt đầu? Làm sao để thực hiện cuộc gọi API đầu tiên?

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, PayPal hoặc chuyển khoản ngân hà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.

Có bản dùng thử miễn phí hoặc mô hình miễn phí không?

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

Những mô hình nào có sẵn?

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-4o, Claude Opus 4.8, Gemini 2.5 Pro, DeepSeek V3, Llama 4, Mistral Large 3), 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á & Thanh toán

Giá cả hoạt động như thế nào?

TokSpan tính một phí dịch vụ nhỏ, minh bạch trên mức giá cơ bản của mỗi nhà cung cấp. Bạn trả cho token bạn tiêu thụ cộng với biên lợi nhuận trang trải cơ sở hạ tầng, định tuyến, mạng edge toàn cầu và hỗ trợ của chúng tôi.

Giá mỗi token của mọi mô hình (đã bao gồm phí dịch vụ) đượ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ángkhô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.

Bạn chấp nhận phương thức thanh toán nào? Có phí không?

Chúng tôi hỗ trợ nhiều tùy chọn thanh toán cho khách hàng toàn cầu:

  • Thẻ tín dụng / Thẻ ghi nợ — Visa, Mastercard, American Express qua Stripe. Áp dụng phí xử lý thẻ tiêu chuẩn.
  • PayPal — Có sẵn tại hơn 200 quốc gia và khu vực.
  • Chuyển khoản ngân hàng (Wire) — Có sẵn cho tài khoản doanh nghiệp (hóa đơn tối thiểu: $500). Thời gian xử lý: 1–3 ngày làm việc.

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 với thanh toán thẻ/PayPal; chuyển khoản hiển thị sau khi được xác nhận.

Bạn có hoàn tiền không?

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

  • Thanh toán thẻ tín dụng / PayPal — 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ụ.
  • Chuyển khoản ngân hàng — Hoàn tiền được xử lý trong 5–10 ngày làm việc, trừ mọi phí chuyển khoản.

Để 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.

Credit có hết hạn không?

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.

Tự động nạp tiền hoạt động như thế nào?

Tự động nạp tiền đảm bảo số dư của bạn không bao giờ về 0:

  1. Vào Dashboard → Billing → Auto Top-Up
  2. Đặt một ngưỡng (ví dụ: $5 — khi số dư xuống dưới mức này, chúng tôi kích hoạt nạp lại)
  3. Đặt một số tiền (ví dụ: $20 — số tiền nạp mỗi lần)
  4. Chọn phương thức thanh toán của bạn

Bạn sẽ nhận được email biên lai cho mỗi lần tự động nạp tiền. Bạn có thể tắt hoặc điều chỉnh bất kỳ lúc nào. Chúng tôi khuyến nghị bật tính năng này cho workload production để tránh gián đoạn 402.

Làm thế nào để kiểm soát chi phí và đặt giới hạn chi tiêu?

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

  • Ngân sách hàng tháng cho từng key — Đặt giới hạn chi tiêu cứng cho mỗi khóa API. Khi khóa chạm giới hạn, request bị từ chối cho đến khi bạn nâng giới hạn hoặc chu kỳ được reset.
  • Rate limit theo mô hình — Đặt giới hạn RPM (request mỗi phút) và TPM (token mỗi phút) tùy chỉnh cho từng khóa API.
  • 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.

Tất cả giới hạn đượ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 và thanh toán như thế nào?

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-4o), âm thanh khoảng ~50 token mỗi giây (Whisper).

Với mô hình có prompt caching (Claude, GPT-4o), 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.

Quyền riêng tư & Bảo mật Dữ liệu

TokSpan có ghi nhật ký hoặc lưu trữ prompt và completion của tôi không?

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.

Nếu bạn yêu cầu không hiển thị dữ liệu (tức là bạn không muốn chúng tôi nhìn thấy cả metadata), TokSpan hoàn toàn có thể tự lưu trữ — triển khai sau tường lửa của bạn với toàn quyền chủ quyền dữ liệu. Xem Tôi có thể tự lưu trữ không? bên dưới.

Nhà cung cấp có dùng dữ liệu của tôi để đào tạo không? Làm sao để ngăn chặn?

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

  • OpenAIKhô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.
  • AnthropicKhô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.

Để kiểm soát tối đa, tự lưu trữ TokSpan và cấu hình khóa API ngược dòng của bạn với các nhà cung cấp có chính sách không đào tạo rõ ràng. Bạn duy trì toàn quyền kiểm soát dữ liệu của mình qua những nhà cung cấp nào.

Khóa API của tôi được bảo vệ như thế nào?

Tất cả khóa API đều được mã hóa khi lưu trữ (AES-256). Khóa chỉ hiển thị một lần khi tạo — chúng tôi không thể khôi phục khóa bị mất (bạn tạo khóa mới và thu hồi khóa cũ). 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ìnhgiớ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ạn có những chứng nhận bảo mật và tiêu chuẩn tuân thủ nào?

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.

TokSpan có tuân thủ GDPR / CCPA không?

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 các yêu cầu nghiêm ngặt về cư trú dữ liệu và tuân thủ, tự lưu trữ mang lại cho bạn toàn quyền kiểm soát — triển khai TokSpan trên cơ sở hạ tầng của riêng bạn ở bất kỳ khu vực nào, phía sau tường lửa của bạn. Liên hệ support@tokspan.com để nhận DPA (Thỏa thuận Xử lý Dữ liệu).

Làm thế nào để xóa tài khoản? Số dư của tôi sẽ ra sao?

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.
Tôi có thể ký DPA (Thỏa thuận Xử lý Dữ liệu) không?

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.

API & Tính năng

API có tương thích hoàn toàn với OpenAI SDK không? Những tính năng nào được hỗ trợ?

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 / Whisper)
  • Images — Tạo hình ảnh qua DALL·E và các mô hình tương thích
  • Rerank — Hỗ trợ đầy đủ
  • Reasoning Effort — Kiểm soát độ sâu suy luận qua hậu tố mô hình (xem bên dưới)
Làm thế nào để kiểm soát độ sâu suy luận cho các mô hình như GPT-5 hoặc DeepSeek R1?

Thêm hậu tố vào tên mô hình để kiểm soát độ sâu suy luận:

Hậu tốTác dụngVí dụ
-highĐộ sâu suy luận tối đa — chất lượng tốt nhất, chậm hơn, chi phí cao hơngpt-5-high
-mediumSuy luận cân bằng (mặc định cho hầu hết mô hình)gpt-5-medium
-lowNhanh, suy luận tối thiểu — tốt nhất cho tác vụ đơn giản, chi phí thấp nhấtgpt-5-low
-thinkingTrả về token suy luận trong phản hồi — hữu ích cho việc gỡ lỗi chuỗi suy nghĩclaude-opus-4-8-thinking

Nếu không cung cấp hậu tố, mức suy luận mặc định của mô hình sẽ được sử dụng. Điều này cho phép bạn đánh đổi tốc độ và chi phí với chất lượng câu trả lời theo từng yêu cầu mà không cần thay đổi mã tích hợp. Xem Mô Hình → Reasoning Effort để biết chi tiết.

Có những biến thể mô hình và hậu tố định tuyến nào?

Ngoài hậu tố suy luận, TokSpan hỗ trợ các biến thể định tuyến kiểm soát cách yêu cầu của bạn được điều phối:

Hậu tốHành viPhù hợp nhất cho
-fastĐịnh tuyến đến nhà cung cấp có độ trễ thấp nhất hiện tại cho mô hình nàyChat thời gian thực, ứng dụng tương tác
-cheapĐịnh tuyến đến nhà cung cấp rẻ nhất hiện có cho mô hình nàyCông việc hàng loạt, dev/testing
-extendedSử dụng nhà cung cấp có cửa sổ ngữ cảnh lớn nhấtTài liệu dài, codebase lớn

Kết hợp hậu tố khi được hỗ trợ: ví dụ: gpt-5-high-fast để suy luận tối đa với định tuyến độ trễ thấp nhất. Xem tài liệu Mô Hình để biết khả năng tương thích hậu tố theo từng mô hình.

TokSpan có hỗ trợ prompt caching không? Tôi có thể tiết kiệm được bao nhiêu?

Có. Prompt caching được tự động áp dụng khi nhà cung cấp ngược dòng hỗ trợ (Claude, GPT-4o, 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.

Tôi có thể dùng khóa API nhà cung cấp của riêng mình (BYOK) không?

Có. TokSpan hỗ trợ Bring Your Own Key — bạn có thể thêm khóa API OpenAI, Anthropic, Google hoặc nhà cung cấp khác của riêng bạn trong bảng điều khiển. Khi bạn cấu hình BYOK:

  • Yêu cầu cho nhà cung cấp đó được định tuyến qua khóa của bạn, không phải qua pool của TokSpan
  • Bạn thanh toán trực tiếp cho nhà cung cấp — TokSpan không thêm phí dịch vụ cho yêu cầu BYOK
  • Bạn vẫn có thể sử dụng endpoint hợp nhất, chuyển đổi dự phòng và theo dõi chi phí của TokSpan
  • Kết hợp khóa BYOK với pool của TokSpan: dùng khóa của bạn cho nhà cung cấp chính và dự phòng sang pool của chúng tôi cho các nhà cung cấp khác

BYOK lý tưởng cho các team có quan hệ hiện có với nhà cung cấp, chiết khấu enterprise hoặc yêu cầu tách biệt thanh toán nghiêm ngặt. Cấu hình từ Bảng Điều Khiển → Cài Đặt → Khóa Nhà Cung Cấp.

Tôi nên xử lý lỗi API như thế nào?

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

Ý nghĩaHành động
400Yêu cầu không hợp lệ — payload sai định dạng hoặc tham số không hợp lệKiểm tra nội dung yêu cầu của bạn với tham khảo API
401Khóa API không hợp lệ hoặc bị thiếuXác minh header Authorization của bạn; kiểm tra khóa chưa bị thu hồi
402Số dư không đủThêm credit hoặc bật tự động nạp tiền
429Vượt quá giới hạn tốc độTriển khai exponential backoff với jitter; kiểm tra giới hạn RPM/TPM của bạn
5xxLỗi nhà cung cấp ngược dòng hoặc timeoutThử lại với backoff; nếu kéo dài, auto-failover sẽ định tuyến đến mô hình dự phòng của bạ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.

Độ tin cậy & Hiệu suất

Thời gian hoạt động và SLA của bạn là gì?

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. Đối với khối lượng công việc quan trọng, triển khai tự lưu trữ mang lại cho bạn toàn quyền kiểm soát các mục tiêu khả dụng của mình.

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.

Điều gì xảy ra khi nhà cung cấp gặp sự cố?

TokSpan tự động chuyển đổi dự phòng sang mô hình ưu tiên tiếp theo của bạn. 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 30 giây)
  3. Định tuyến đến mô hình tiếp theo của bạn trong chuỗi failover (có thể cấu hình trong Bảng Điều Khiển → Kênh)

Một chuỗi được thiết kế tốt (ví dụ: GPT-4o → Claude Opus → Gemini Pro) đảm bảo không có yêu cầu nào bị rớt. Bạn chỉ trả tiền cho mô hình 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 để biết hướng dẫn thiết lập.

Tôi nên mong đợi độ trễ bao nhiêu so với gọi trực tiếp nhà cung cấp?

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
  • Sử dụng hậu tố mô hình -fast để tự động định tuyến đến nhà cung cấp có độ trễ thấp nhất
  • Triển khai một phiên bản tự lưu trữ trong khu vực ứng dụng của bạn để không có chi phí mạng
Bạn có trang trạng thái công khai không?

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, Slack hoặc webhook — xem Webhooks để thiết lập.

Tài khoản & Khóa API

Làm thế nào để tạo và quản lý khóa API?

Đă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.

Nếu khóa API của tôi bị lộ thì sao?

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
Làm thế nào để thiết lập môi trường dev, staging và production?

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 ($10/tháng), 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 ($50/tháng), 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 đủ.

Doanh nghiệp & Tự lưu trữ

Tôi có thể tự lưu trữ TokSpan trên cơ sở hạ tầng của mình không?

Có. TokSpan có thể được triển khai trên cơ sở hạ tầng của riêng bạn qua Docker, Docker Compose hoặc Kubernetes. Tự lưu trữ mang lại cho bạn:

  • Chủ quyền dữ liệu hoàn toàn — không dữ liệu nào rời khỏi cơ sở hạ tầng của bạn
  • Kiểm soát nhật ký đầy đủ — bạn quyết định những gì được ghi lại và nơi lưu trữ
  • Không có chi phí độ trễ — triển khai trong khu vực ứng dụng của bạn
  • Tùy chỉnh không giới hạn — điều chỉnh nền tảng để phù hợp với nhu cầu của bạn

Xem hướng dẫn triển khai của chúng tôi hoặc liên hệ support@tokspan.com để được hỗ trợ.

Bạn có hỗ trợ không gian làm việc nhóm và triển khai riêng không?

Có. TokSpan hỗ trợ triển khai cho nhóm và doanh nghiệp với các biện pháp quản lý riêng:

  • Không gian làm việc nhóm — sub-key, vai trò và giới hạn sử dụng theo khóa
  • Thanh toán hợp nhất — một hóa đơn cho mọi mô hình và nhóm
  • Giới hạn tốc độ tùy chỉnh — mở rộng theo khối lượng công việc của bạn

Liên hệ support@tokspan.com để biết các tùy chọn triển khai riêng.

Bạn có cung cấp hỗ trợ riêng, SLA hoặc triển khai tùy chỉnh không?

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, tùy chỉnh Helm chart, thiết lập on-premise

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.

Tôi có thể chọn khu vực xử lý dữ liệu của mình không?

Cơ sở hạ tầng lưu trữ của chúng tôi hiện xử lý dữ liệu trên các điểm biên toàn cầu để có độ trễ tối ưu. Đối với yêu cầu nghiêm ngặt về cư trú dữ liệu (ví dụ: dữ liệu GDPR phải ở trong EU hoặc các quy định quốc gia cụ thể), TokSpan có thể tự lưu trữ hoàn toàn — triển khai trên máy chủ của riêng bạn ở bất kỳ khu vực nào, phía sau tường lửa của bạn, với chủ quyền dữ liệu hoàn toàn.

Khách hàng enterprise cũng có thể thảo luận về triển khai khu vực riêng do đội ngũ chúng tôi quản lý. Liên hệ support@tokspan.com để biết khả năng khả dụng trong khu vực mục tiêu của bạn.

Làm thế nào để liên hệ hỗ trợ? Có những kênh nào?

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

  • Emailsupport@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áiTrạ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.