Câu hỏi thường gặp

Câu hỏi chung

TokenCode khác gì so với việc gọi trực tiếp OpenAI/Claude API?

TokenCode là một cổng tổng hợp AI API. Thông qua TokenCode, bạn có thể:

  • Truy cập tất cả mô hình của hơn 40 nhà cung cấp với một API Key
  • Tự động chuyển đổi giao thức, không cần thích nghi SDK khác nhau cho các mô hình khác nhau
  • Hưởng lợi từ định tuyến thông minh, chuyển đổi dự phòng và cân bằng tải
  • Bảng điều khiển thanh toán và quản lý thống nhất

Việc gọi trực tiếp từng nhà cung cấp đòi hỏi đăng ký tài khoản riêng, quản lý nhiều API Key, thích nghi các giao thức khác nhau.

Tự động chuyển đổi giao thức hoạt động như thế nào?

Khi bạn gọi mô hình Claude qua giao thức OpenAI, TokenCode sẽ:

  1. Nhận yêu cầu định dạng OpenAI
  2. Chuyển đổi sang định dạng gốc Anthropic và gửi lên thượng-stream
  3. Chuyển đổi phản hồi gốc Anthropic sang định dạng OpenAI trả về cho bạn

Ngược lại cũng vậy — gọi mô hình OpenAI qua giao thức Anthropic cũng tự động chuyển đổi. Toàn bộ quá trình hoàn toàn minh bạch đối với client.

Hỗ trợ những mô hình nào?

Hỗ trợ mô hình của hơn 40 nhà cung cấp như OpenAI, Anthropic, Google, AWS Bedrock, Azure, DeepSeek, Mistral, Meta v.v. Danh sách mô hình đầy đủ vui lòng xem trang chủ hoặc truy vấn qua API GET /v1/models.

Tài khoản và thanh toán

Làm thế nào để nạp tiền?

Đăng nhập Portal, chọn số tiền nạp trong trang tài khoản. Hỗ trợ mô hình trả trước, Token tiêu thụ được khấu trừ từ số dư theo thời gian thực.

Số dư không đủ thì sao?

Khi số dư hết, yêu cầu API sẽ trả về lỗi 429 Too Many Requests. Vui lòng nạp tiền kịp thời để khôi phục dịch vụ.

Làm thế nào để xem mức sử dụng?

Đăng nhập Portal, trong trang mức sử dụng có thể xem chi tiết tiêu thụ Token và chi phí theo ngày và theo mô hình.

Kết nối và cấu hình

API Base URL là gì?

  • Giao thức OpenAI: https://tokencode.dev/v1
  • Giao thức Anthropic: https://tokencode.dev
  • Giao thức Gemini: https://tokencode.dev

Tại sao Base URL của giao thức OpenAI có /v1 mà Anthropic thì không?

Đây là quy ước của từng giao thức:

  • OpenAI SDK mặc định nối đường dẫn như /chat/completions sau base URL, nên base URL cần chứa /v1
  • Anthropic SDK mặc định nối /v1/messages sau base URL, nên base URL không nên chứa /v1

Có hỗ trợ phản hồi luồng không?

Có. Endpoint của tất cả các giao thức đều hỗ trợ đầu ra luồng, chỉ cần đặt stream: true.

Mô hình và tính năng

Có thể gọi mô hình OpenAI qua giao thức Anthropic không?

Có. Tính năng tự động chuyển đổi giao thức của TokenCode hỗ trợ gọi xuyên giao thức bất kỳ mô hình nào. Khi gọi GPT-4o qua giao thức Anthropic, yêu cầu và phản hồi sẽ tự động thích nghi.

Có hỗ trợ Function Calling không?

Có. Function Calling / Tool Use được ánh xạ chính xác trong chuyển đổi giao thức.

Có hỗ trợ đầu vào hình ảnh không?

Có. Các giao thức OpenAI, Anthropic, Gemini đều hỗ trợ đầu vào hình ảnh (Vision), định dạng cụ thể vui lòng tham khảo tài liệu API tham khảo của từng giao thức.

Có hỗ trợ Extended Thinking không?

Extended Thinking là tính năng đặc thù của mô hình Claude, chỉ khả dụng khi gọi mô hình Claude qua giao thức Anthropic. Không hỗ trợ tính năng này khi gọi mô hình không phải Claude thông qua chuyển đổi giao thức.

Khắc phục lỗi

Trả về lỗi 401

  • Kiểm tra API Key có chính xác không
  • Xác nhận định dạng Header: Authorization: Bearer sk-xxx hoặc x-api-key: sk-xxx
  • Xác nhận API Key chưa hết hạn

Trả về lỗi 429

  • Số dư không đủ: Nạp tiền trong Portal
  • Giới hạn tốc độ: Đợi một thời gian rồi thử lại

Trả về lỗi 404

  • Kiểm tra đường dẫn yêu cầu có chính xác không
  • Xác nhận chính tả tên mô hình chính xác
  • Xác nhận cấu hình Base URL chính xác (giao thức OpenAI cần chứa /v1)

Định dạng phản hồi bất thường

  • Xác nhận endpoint giao thức bạn sử dụng phù hợp với client
  • Kiểm tra mô hình có hỗ trợ tính năng bạn sử dụng không
  • Thử yêu cầu trực tiếp bằng curl để xác minh

Kết nối quá thời gian

  • Kiểm tra mạng có thể truy cập tokencode.dev không
  • Xác nhận chính tả Base URL chính xác
  • Nếu sử dụng proxy, kiểm tra cấu hình proxy