Client/Magpie

Dùng Wokey API với Magpie

Lấy khóa API Wokey, trỏ Magpie đến base URL của Wokey, rồi xác nhận kết nối bằng một yêu cầu curl.

Cập nhật

Trên trang nàyexpand_more

Lấy khóa API và base URLlink

Mọi client đều dùng cùng một khóa API Wokey và cùng một base URL.

Tạo khóa API

Đăng nhập và tạo khóa nền tảng trên trang API. Các khóa trong cùng một tài khoản dùng chung số dư của tài khoản đó.

Tạo khóa APIkey

Dùng base URL của Wokey

Đặt base URL của client là tên miền của gateway; cấu hình bên dưới cho biết có cần thêm /v1 hay không.

Cấu hình clientlink

Magpie là gateway mô hình chạy trên máy của bạn. Sau khi thêm Wokey làm provider, mọi agent trên máy đều có thể gọi các mô hình của Wokey qua nó. Magpie lưu một địa chỉ cho mỗi định dạng API, và một lệnh duy nhất đặt cả ba.

  1. 1

    Thêm provider

    Chạy lệnh magpie provider add bên dưới, thay YOUR_API_KEY bằng khóa API Wokey của bạn. url và responses dùng https://api.wokey.ai/v1; anthropic dùng https://api.wokey.ai không có /v1. Nếu không có tham số models, Magpie sẽ đọc danh sách mô hình từ Wokey.

  2. 2

    Hoặc dùng liên kết nhập

    Trên Magpie 0.1.8 trở lên, mở https://usemagpie.ai/import#name=Wokey&chat=https://api.wokey.ai/v1&anthropic=https://api.wokey.ai, dán khóa API vào hộp thoại và xác nhận.

  3. 3

    Chọn mô hình trong agent

    Ghi mô hình dưới dạng wokey/model-id, ví dụ wokey/claude-opus-5-5.

Magpie
magpie provider add "Wokey" \
  url=https://api.wokey.ai/v1 \
  responses=https://api.wokey.ai/v1 \
  anthropic=https://api.wokey.ai \
  key=YOUR_API_KEY

Định dạng API và base URLlink

Khi một client chuyển sang định dạng API khác, việc base URL có kết thúc bằng /v1 hay không có thể thay đổi.

Định dạngBase URLDùng cho
OpenAI Chat Completionshttps://api.wokey.ai/v1DeepSeek, GLM, Kimi và các mô hình khác
OpenAI Responseshttps://api.wokey.ai/v1Mô hình GPT
Anthropic Messageshttps://api.wokey.aiMô hình Claude

Nơi cấu hình: magpie provider add hoặc liên kết nhập (tệp ~/.config/magpie/providers.json)

Kiểm tra bằng curllink

Nếu client báo lỗi, trước hết hãy dùng curl để loại trừ vấn đề về khóa API và base URL.

Magpie mặc định dùng định dạng OpenAI Chat Completions. 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
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Lỗi và khắc phục sự cốlink

Trước hết hãy phân biệt các trường hợp xác thực, số dư, giới hạn tốc độ, mô hình không khả dụng và upstream hết thời gian chờ.

401

invalid api key

Khóa bị thiếu, nhập sai, đã bị xóa, hoặc header Authorization / x-api-key mâu thuẫn nhau.

402

insufficient balance

Số dư tài khoản quá thấp. Hãy nạp tiền trước khi gửi thêm yêu cầu.

403

model_denylisted / account_restricted

Lệnh gọi đến mô hình, hoặc đến mọi mô hình trên tài khoản, bị tạm dừng sau nhiều lần vi phạm. Xem Phí xử lý vi phạm và giới hạn.

403

request_blocked

Yêu cầu này bị chặn trước khi đến upstream và không bị tính phí, ví dụ gửi lại nguyên vẹn một yêu cầu mà mô hình vừa từ chối, hoặc người dùng cuối đang bị tạm dừng (X-End-User-Id). Thông báo lỗi cho biết điều gì bị chặn; hãy sửa yêu cầu theo thông báo hoặc thử lại sau. Các yêu cầu khác không bị ảnh hưởng.

429

rate limited

Lưu lượng quá dày. Hãy thử lại sau hoặc giảm số yêu cầu đồng thời. Nếu chỉ một mô hình, hoặc một người dùng cuối (X-End-User-Id), liên tục trả về 429, đó có thể là giới hạn tạm thời sau khi vi phạm.

499

client disconnected

Client đã đóng kết nối trước khi phản hồi hoàn tất (mã downstream_aborted). Mặc định trường hợp này miễn phí. Khi một tài khoản có ít nhất 50 lần client ngắt kết nối trong 24 giờ qua và chúng chiếm từ 10% số yêu cầu trở lên, các yêu cầu bị ngắt kết nối sau đó sẽ bị tính phí theo mức sử dụng mà upstream báo cáo: phần đầu vào đã xử lý, bao gồm đọc và ghi cache, và phần đầu ra chỉ khi upstream đã tính. Ngắt kết nối trước khi upstream báo cáo bất kỳ mức sử dụng nào vẫn miễn phí. Tài khoản sẽ được thông báo khi bắt đầu tính phí, và việc tính phí tự động dừng trong vòng một giờ khi tỷ lệ ngắt kết nối trở lại bình thường. Nguyên nhân thường gặp là thời gian chờ của client hoặc proxy quá ngắn, hoặc chương trình hủy yêu cầu trước khi chúng hoàn tất.

502

upstream unavailable

Dịch vụ mô hình upstream tạm thời không khả dụng. Hãy đổi mô hình hoặc thử lại sau.

504

upstream timeout

Phản hồi từ upstream hết thời gian chờ. Hãy rút ngắn ngữ cảnh, giảm max_tokens hoặc thử lại.

529

upstream overloaded

Mô hình upstream tạm thời quá tải và Wokey đã thử lại trên các tuyến khác (mã upstream_overloaded). Lỗi này không liên quan đến số dư của bạn. Hãy thử lại sau ít phút hoặc đổi mô hình.

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

Địa chỉ Wokey trong Magpie có cần kết thúc bằng /v1 không?
Magpie lưu một địa chỉ cho mỗi định dạng. Dùng https://api.wokey.ai/v1 cho chat và responses, và https://api.wokey.ai không có /v1 cho anthropic. Địa chỉ phải là https.
Nếu liên kết nhập không có tác dụng thì sao?
Liên kết nhập cần Magpie 0.1.8 trở lên. Hãy nâng cấp trước, hoặc thêm provider bằng lệnh magpie provider add.
Viết tên mô hình trong agent như thế nào?
Theo dạng id provider/tên mô hình. Provider tên Wokey có id là wokey, nên Claude Opus 5.5 là wokey/claude-opus-5-5.
Nhập khóa API Wokey ở đâu?
Dán khóa vào hộp thoại nhập hoặc truyền nó dưới dạng key= cho magpie provider add. Magpie lưu khóa trong ~/.config/magpie/providers.json.
Tôi có thể chia sẻ liên kết nhập chứa khóa của mình không?
Đừng chia sẻ. Tham số key là văn bản thuần, nên bất kỳ ai có liên kết đều có thể tiêu số dư của bạn. Hãy xóa tham số key trước khi chia sẻ; người kia sẽ nhập khóa của họ trong hộp thoại nhập.