Dùng Wokey API với Z Code

1. 1

   Mở cài đặt mô hình

   Nhấp tên mô hình trong ô chat → Manage Models, hoặc vào Settings → Model Settings.

2. 2

   Thêm provider

   Nhấp Add Provider và đặt tên là Wokey. Với định dạng Anthropic, đặt Base URL là https://api.wokey.ai; với định dạng OpenAI, đặt là https://api.wokey.ai/v1. Dán khóa API Wokey của bạn vào API Key.

3. 3

   Thêm và bật mô hình

   Dưới provider, nhấp Add Model, nhập mã mô hình như claude-opus-5-5 và bật công tắc kích hoạt của nó.

4. 4

   Chuyển mô hình

   Quay lại ô chat, chọn mô hình vừa thêm trong danh sách mô hình và gửi một tin nhắn ngắn để xác nhận.

Provider name: Wokey
API format: Anthropic
Base URL: https://api.wokey.ai
API Key: YOUR_API_KEY
Model ID: claude-opus-5-5

Nơi cấu hình: Settings → Model Settings (tệp ~/.zcode/v2/config.json)

Z Code mặc định dùng định dạng Anthropic Messages. Nếu yêu cầu này trả về 200 thì khóa API và base URL đều đúng. Hãy thay YOUR_API_KEY bằng khóa của bạn trước khi gửi.

curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Base URL của Z Code có cần kết thúc bằng /v1 không?

Tùy vào định dạng API bạn dùng để kết nối. Với Anthropic, dùng https://api.wokey.ai không có /v1; với OpenAI, dùng https://api.wokey.ai/v1.

Vì sao các biến môi trường tôi export trong terminal bị bỏ qua?

Biến môi trường của terminal và cấu hình mô hình của ứng dụng desktop Z Code là riêng biệt và không được đồng bộ. Hãy nhập base URL và khóa API vào provider trong Settings → Model Settings.

Đã thêm provider. Vì sao tôi không chọn được mô hình?

Mỗi provider còn cần Add Model với một ID mô hình, và bật công tắc kích hoạt của mô hình đó, thì mô hình mới hiện trong danh sách mô hình của ô chat.

Nếu đầu ra bị cắt hoặc ngữ cảnh quá nhỏ thì sao?

Mở Advanced của mô hình và chỉnh Max output tokens cùng cửa sổ ngữ cảnh theo giá trị trên trang mô hình. Mô hình mới thêm có cửa sổ ngữ cảnh mặc định 200000.

Z Code lưu cấu hình này ở đâu?

Trong ~/.zcode/v2/config.json. Hãy sao lưu tệp này trước khi chuyển máy hoặc cài lại; tệp chứa khóa API của bạn, nên đừng chia sẻ.