Dùng Wokey API với WorkBuddy

1. 1

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

   Nhấp nút tài khoản ở góc dưới bên trái của WorkBuddy → Settings → Model. Bạn cũng có thể mở bộ chọn mô hình và chọn Configure custom model.

2. 2

   Thêm mô hình tùy chỉnh

   Chọn Custom. Đặt endpoint là https://api.wokey.ai, dán khóa API Wokey của bạn và nhập chính xác mã mô hình deepseek-v4.1-flash (mã cũ deepseek-flash cũng dùng được).

3. 3

   Đặt năng lực

   Bật gọi công cụ và đầu vào hình ảnh. Để tắt chế độ suy luận và giao thức tùy chỉnh. deepseek-v4.1-flash nhận văn bản, hình ảnh và công cụ; nếu bạn dùng deepseek-v4-flash, hãy tắt đầu vào hình ảnh vì mô hình đó chỉ nhận văn bản.

4. 4

   Lưu và chuyển mô hình

   Chạy Test connection, lưu mô hình, rồi chọn nó trong bộ chọn mô hình của cuộc hội thoại. Hãy thử một prompt văn bản ngắn trước khi thử công cụ hoặc hình ảnh.

Provider: Custom
Endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model: deepseek-v4.1-flash
Tool calling: On
Image input: On
Reasoning mode: Off
Custom protocol: Off

Nơi cấu hình: Settings → Models → Custom models

• 404: giữ endpoint là https://api.wokey.ai và để tắt giao thức tùy chỉnh. Chỉ khi bật giao thức tùy chỉnh, bạn mới nhập đường dẫn đầy đủ https://api.wokey.ai/v1/chat/completions.
• 401: dán chính khóa vào trường API key; không thêm tiền tố Bearer. Xác nhận khóa đang hoạt động và tài khoản còn số dư.
• model_not_found: đặt mã mô hình là deepseek-v4.1-flash, không có dấu cách hay hậu tố thừa.
• Yêu cầu có ảnh thất bại: chọn deepseek-v4.1-flash và bật đầu vào hình ảnh. deepseek-v4-flash chỉ nhận văn bản.
• 429, 502, 504 hoặc 529: giảm số yêu cầu đồng thời, rút ngắn ngữ cảnh hoặc thử lại sau; bạn cũng có thể chuyển sang mô hình khả dụng khác.

WorkBuddy 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 https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Địa chỉ API trong WorkBuddy có cần kết thúc bằng /v1 không?

Không. Hãy dùng https://api.wokey.ai và giữ công tắc giao thức tùy chỉnh ở trạng thái tắt. Chỉ khi bật giao thức tùy chỉnh bạn mới nhập đầy đủ https://api.wokey.ai/v1/chat/completions; nếu không khớp sẽ trả về 404.

Tên mô hình điền gì?

ID mô hình chính xác, ví dụ deepseek-v4.1-flash, không có khoảng trắng hay hậu tố. Bất kỳ giá trị nào khác đều trả về model_not_found.

Vì sao yêu cầu hình ảnh thất bại?

Kiểm tra mô hình là deepseek-v4.1-flash và công tắc đầu vào hình ảnh đang bật. deepseek-v4-flash là mô hình văn bản, nên hãy tắt đầu vào hình ảnh khi dùng nó.