Klien/WorkBuddy

Menggunakan Wokey API di WorkBuddy

Siapkan API key Wokey, arahkan WorkBuddy ke base URL Wokey, lalu pastikan koneksinya dengan satu request curl.

Diperbarui

Di halaman iniexpand_more

Siapkan API key dan base URLlink

Semua klien memakai API key Wokey yang sama dan base URL yang sama.

Buat API key

Masuk, lalu buat key platform di halaman API. Semua key dalam satu akun memakai saldo yang sama.

Buat API keykey

Gunakan base URL Wokey

Isi base URL klien dengan domain gateway; konfigurasi di bawah menunjukkan apakah /v1 perlu ditambahkan.

Konfigurasikan klienlink

WorkBuddy memakai OpenAI Chat Completions untuk model kustom. Di WorkBuddy, buka Settings → Model → Custom models lalu masukkan endpoint Wokey, API key, dan deepseek-v4.1-flash; tool calling dan input gambar kemudian dapat dipakai oleh tugas WorkBuddy dan alur kerja agent.

  1. 1

    Buka pengaturan model

    Klik tombol akun di pojok kiri bawah WorkBuddy → Settings → Model. Anda juga bisa membuka pemilih model lalu memilih Configure custom model.

  2. 2

    Tambahkan model kustom

    Pilih Custom. Atur endpoint ke https://api.wokey.ai, tempel API key Wokey Anda, lalu masukkan ID model yang persis, deepseek-v4.1-flash (ID lama deepseek-flash juga berfungsi).

  3. 3

    Atur kemampuan

    Aktifkan tool calling dan input gambar. Biarkan mode reasoning dan protokol kustom nonaktif. deepseek-v4.1-flash menerima teks, gambar, dan tool; jika Anda memakai deepseek-v4-flash, nonaktifkan input gambar karena model itu hanya menerima teks.

  4. 4

    Simpan dan ganti model

    Jalankan Test connection, simpan model, lalu pilih model tersebut di pemilih model percakapan. Mulailah dengan prompt teks singkat sebelum menguji tool atau gambar.

WorkBuddy
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

Format API dan base URLlink

Saat satu klien berganti format API, base URL bisa berubah antara diakhiri /v1 atau tidak.

FormatBase URLCocok untuk
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek, GLM, Kimi, dan model lainnya

Lokasi konfigurasi: Settings → Models → Custom models

Masalah umumlink

  • 404: biarkan endpoint di https://api.wokey.ai dan protokol kustom nonaktif. Hanya jika protokol kustom aktif Anda perlu memasukkan path lengkap https://api.wokey.ai/v1/chat/completions.
  • 401: tempel key-nya saja ke kolom API key; jangan tambahkan awalan Bearer. Pastikan key aktif dan akun memiliki saldo.
  • model_not_found: atur ID model ke deepseek-v4.1-flash, tanpa spasi atau akhiran tambahan.
  • Request gambar gagal: pilih deepseek-v4.1-flash dan aktifkan input gambar. deepseek-v4-flash hanya menerima teks.
  • 429, 502, 504, atau 529: kurangi konkurensi, persingkat konteks, atau coba lagi nanti; Anda juga bisa beralih ke model lain yang tersedia.

Verifikasi dengan curllink

Jika klien menampilkan error, pastikan dulu API key dan base URL benar dengan curl.

WorkBuddy secara default memakai format OpenAI Chat Completions. Jika request ini mengembalikan 200, berarti API key dan base URL sudah benar. Ganti YOUR_API_KEY dengan key Anda sebelum mengirimnya.

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

Error dan pemecahan masalahlink

Bedakan dulu kasus autentikasi, saldo, rate limit, ketersediaan model, dan timeout upstream.

401

invalid api key

Key tidak ada, salah ketik, sudah dihapus, atau header Authorization / x-api-key saling bertentangan.

402

insufficient balance

Saldo akun terlalu rendah. Isi saldo sebelum mengirim request lagi.

403

model_denylisted / account_restricted

Panggilan ke model tersebut, atau ke semua model di akun, dijeda setelah pelanggaran berulang. Lihat “Biaya penanganan pelanggaran dan pembatasan”.

403

request_blocked

Request ini diblokir sebelum sampai ke upstream dan tidak dikenai biaya, misalnya pengiriman ulang tanpa perubahan atas request yang baru saja ditolak model, atau pengguna akhir yang dijeda (X-End-User-Id). Pesan error menyebutkan apa yang diblokir; ubah request sesuai pesan tersebut atau coba lagi nanti. Request lain tidak terpengaruh.

429

rate limited

Request terlalu sering. Coba lagi nanti atau kurangi konkurensi. Jika hanya satu model, atau satu pengguna akhir (X-End-User-Id), yang terus mengembalikan 429, itu mungkin batas sementara setelah pelanggaran.

499

client disconnected

Klien menutup koneksi sebelum respons selesai (kode downstream_aborted). Secara default ini gratis. Begitu sebuah akun memiliki setidaknya 50 pemutusan dari sisi klien dalam 24 jam terakhir dan jumlah itu mencapai 10% atau lebih dari request-nya, request terputus berikutnya ditagih sesuai penggunaan yang dilaporkan upstream: input yang diproses, termasuk cache read dan cache write, serta output hanya jika upstream menghitungnya. Pemutusan sebelum upstream melaporkan penggunaan apa pun tetap gratis. Akun diberi tahu saat penagihan dimulai, dan penagihan berhenti otomatis dalam satu jam setelah tingkat pemutusan kembali normal. Penyebab umumnya adalah timeout klien atau proxy yang terlalu singkat, atau program yang membatalkan request sebelum selesai.

502

upstream unavailable

Layanan model upstream sementara tidak tersedia. Ganti model atau coba lagi nanti.

504

upstream timeout

Respons upstream melewati batas waktu. Persingkat konteks, kurangi max_tokens, atau coba lagi.

529

upstream overloaded

Model upstream sementara kelebihan beban dan Wokey sudah mencoba ulang di rute lain (kode upstream_overloaded). Ini tidak berkaitan dengan saldo Anda. Coba lagi sebentar lagi atau ganti model.

Pertanyaan umumlink

Apakah alamat API WorkBuddy perlu diakhiri /v1?
Tidak. Gunakan https://api.wokey.ai dan biarkan sakelar protokol kustom mati. Hanya saat protokol kustom menyala Anda memasukkan alamat lengkap https://api.wokey.ai/v1/chat/completions; jika keduanya tidak cocok, hasilnya 404.
Apa yang diisi di nama model?
ID model yang persis, misalnya deepseek-v4.1-flash, tanpa spasi atau akhiran. Selain itu akan mengembalikan model_not_found.
Mengapa request gambar gagal?
Periksa bahwa modelnya deepseek-v4.1-flash dan sakelar input gambar menyala. deepseek-v4-flash adalah model teks, jadi matikan input gambar saat memakainya.