Dùng Wokey API với pi

1. 1

   Export khóa API

   Chạy export WOKEY_API_KEY="YOUR_API_KEY" trong terminal dùng để khởi động pi, hoặc thêm vào ~/.zshrc.

2. 2

   Ghi models.json

   Lưu nội dung bên dưới vào ~/.pi/agent/models.json. Nếu tệp đã có provider khác, chỉ thêm mục wokey dưới providers.

3. 3

   Chọn mô hình

   Khởi động pi, gõ /model và chọn một mô hình dưới wokey.

{
  "providers": {
    "wokey": {
      "baseUrl": "https://api.wokey.ai",
      "api": "anthropic-messages",
      "apiKey": "$WOKEY_API_KEY",
      "models": [
        { "id": "claude-opus-5-5", "reasoning": true, "input": ["text", "image"] }
      ]
    }
  }
}

Nơi cấu hình: ~/.pi/agent/models.json

pi 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" }
    ]
  }'

baseUrl của pi có cần kết thúc bằng /v1 không?

Tùy vào trường api. Với anthropic-messages, dùng https://api.wokey.ai không có /v1; với openai-completions hoặc openai-responses, dùng https://api.wokey.ai/v1.

Vì sao các mô hình Wokey không có trong /model?

pi không liệt kê mô hình tùy chỉnh khi không xác định được khóa API. Nếu apiKey là $WOKEY_API_KEY, hãy export WOKEY_API_KEY trong cùng terminal khởi động pi, rồi kiểm tra models.json có phải JSON hợp lệ không. /model đọc lại tệp mỗi lần mở.

Làm sao gửi ảnh đến mô hình Wokey trong pi?

Theo mặc định, mô hình tùy chỉnh trong pi chỉ khai báo đầu vào văn bản. Thêm "input": ["text", "image"] vào mô hình nhận ảnh để khai báo rằng nó nhận đầu vào hình ảnh.

Tôi có cần thay đổi cửa sổ ngữ cảnh và đầu ra tối đa không?

Nếu không có chúng, pi mặc định contextWindow 128000 và maxTokens 16384. Khi mô hình có cửa sổ lớn hơn, hãy đặt contextWindow và maxTokens trong mục mô hình theo giá trị trên trang mô hình đó.

Tôi có thể không để khóa API trong tệp không?

Có. apiKey chấp nhận biến môi trường viết dạng $NAME, và dạng !command đọc khóa từ đầu ra của một lệnh.