Bỏ qua, đến nội dung chính
NapKey

Compatibility Center

Dùng gateway mà không bị trói vào gateway

Bản đồ có thể cập nhật phiên bản về catalog model công khai, bề mặt giao thức và đường chuyển đổi của NapKey. Trang này tách rõ request shape được hỗ trợ với hành vi chuyển đổi để bạn đánh giá tính di động trước khi đưa traffic production vào.

Tạo API keyGET /v1/models

01 / Catalog model

Data plane đang công bố những gì

Catalog trực tiếp từ gateway

Danh sách được đọc từ models endpoint công khai khi truy cập được. Nó mô tả model ID được chấp nhận, không đảm bảo mọi tài khoản upstream đang có sức chứa tại thời điểm này.

  • auto
    auto
  • claude-haiku-4.5
    haiku
  • claude-haiku-4.5-thinking
    haikuthinking
  • claude-opus-4.5
    opus
  • claude-opus-4.5-thinking
    opusthinking
  • claude-opus-4.6
    opus
  • claude-opus-4.6-thinking
    opusthinking
  • claude-opus-4.7
    opus
  • claude-opus-4.7-thinking
    opusthinking
  • claude-sonnet-4
    sonnet
  • claude-sonnet-4-thinking
    sonnetthinking
  • claude-sonnet-4.5
    sonnet
  • claude-sonnet-4.5-thinking
    sonnetthinking
  • claude-sonnet-4.6
    sonnet
  • claude-sonnet-4.6-thinking
    sonnetthinking
  • gpt-4
    openai-alias
  • gpt-4o
    openai-alias

02 / Ma trận giao thức

Biết rõ phần trực tiếp, chuyển đổi và giới hạn

Hỗ trợ nghĩa là NapKey nhận bề mặt request đó. Quá trình chuyển đổi có thể tạo khác biệt hành vi; không mặc định hỗ trợ beta field riêng của upstream nếu chưa được liệt kê.

Khả năng tương thích giao thức và tính năng NapKey
Tính năngAnthropicOpenAICam kết
Messages APIHỗ trợ—Nhận tại /v1/messages và các alias đã công bố.
Chat Completions—Chuyển đổiRequest dạng OpenAI Chat được chuyển đổi sang data plane của gateway.
Responses API—Chuyển đổiHỗ trợ tại /v1/responses; thời hạn lưu response được công bố trong chính sách dữ liệu.
SSE streamingHỗ trợHỗ trợStreaming được proxy; chi tiết event tuân theo bề mặt giao thức đã chọn.
Tool useHỗ trợChuyển đổiKhai báo và kết quả tool đi qua ranh giới chuyển đổi khi dùng request shape OpenAI.
Vision inputHỗ trợChuyển đổiMedia được nhận vẫn phụ thuộc model đã chọn và khả năng upstream.
Biến thể thinkingHỗ trợModel aliasDùng ID -thinking được catalog công bố; hành vi reasoning vẫn phụ thuộc model.
Đếm tokenHỗ trợ—Có tại /v1/messages/count_tokens cho input dạng Anthropic.

03 / Playbook chuyển đổi

Thay đổi nhỏ nhất và đảo ngược được

Giữ SDK nhà cung cấp và code ứng dụng khi có thể. Đặt endpoint cùng credential trong biến môi trường để rollback chỉ là đổi cấu hình.

01

Claude Code

Trỏ Claude Code vào NapKey và dùng credential NapKey. Xóa các override này để quay về nhà cung cấp ban đầu.

ANTHROPIC_BASE_URL=https://api.napkey.io.vn
ANTHROPIC_AUTH_TOKEN=napkey_your_key

02

Anthropic SDK

Giữ SDK chính thức và schema request. Chỉ đổi base URL và credential.

base_url="https://api.napkey.io.vn"
api_key="napkey_your_key"

03

OpenAI SDK

Giữ lời gọi dạng Chat Completions hoặc Responses trong khi NapKey chuyển đổi chúng trên data plane.

base_url="https://api.napkey.io.vn/v1"
api_key="napkey_your_key"