Hubungkan OpenHands ke CheapTokens: model, Base URL, key

Anda dapat menjalankan OpenHands pada model CheapTokens dengan mengisi tiga kolom di Settings > LLM setelah mengaktifkan Advanced: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL (https://api.cheaptokens.dev/v1), dan API Key. Itu seluruh pengaturannya. Sisa halaman ini menjelaskan arti tiap kolom dan bagaimana tampilannya jika salah satunya keliru.

Nama kolom dan aturan string model diambil dari halaman dokumentasi OpenHands tentang endpoint yang kompatibel dengan OpenAI (diperiksa 8 November 2026; halaman tersebut tidak mencantumkan tanggal atau versi). Rilis OpenHands terbaru pada tanggal itu adalah v1.37.0 (6 November 2026). Jika label di build Anda terlihat sedikit berbeda, ikuti posisinya: model, base URL, key.

Sebelum membuka Settings#

Tiga hal yang perlu disiapkan akan menghemat satu putaran: key, id model, dan akses ke Settings.

Baru mengenal key dan base URL? Apa itu base_url dan cara menggantinya membahasnya dalam beberapa menit, dan daftar model dengan GET /v1/models menunjukkan cara mencari id sendiri.

Tiga kolom#

Buka Settings > LLM dan aktifkan Advanced. Kolom Base URL berada di bawah toggle Advanced.

Dokumentasi menjelaskan aturan model seperti ini: Custom Model adalah openai/ diikuti nama model, dan jika Anda melalui proxy yang punya prefiks sendiri, openai/<proxy-prefix>/<model-name>. Bagian setelah openai/ adalah nama model. Untuk CheapTokens id-nya adalah deepseek-ai/DeepSeek-V4-Flash-0731, jadi string lengkapnya adalah openai/deepseek-ai/DeepSeek-V4-Flash-0731.

Mengapa model ini untuk agen? DeepSeek-V4-Flash memiliki jendela konteks 380K dan hingga 32.768 token output per jawaban, serta satu harga di jam berapa pun, sehingga sesi panjang tidak menjadi lebih mahal pada jam sibuk. Agen coding mengirim ulang banyak konteks di setiap langkah, dan itulah kegunaan jendela konteks tersebut.

Lebih suka GLM? Gunakan openai/zai-org/GLM-5.3-Flash (konteks 390K, hingga 8.192 token output) di kolom yang sama dan tidak perlu mengubah apa pun lagi. Saldo sama, key sama, Base URL sama.

Periksa komponennya di luar OpenHands terlebih dahulu#

Sebelum menyalahkan agen, kirim satu permintaan dengan URL, key, dan id yang sama. Jika ini berhasil, masalah yang tersisa ada pada cara Anda mengetik kolom-kolom tersebut.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'

Perhatikan yang tidak ada: tidak ada openai/ di nilai model. Prefiks itu untuk OpenHands, bukan untuk API. Balasan membawa blok usage dengan prompt_tokens dan completion_tokens — dua angka yang sama yang nanti akan Anda lihat terakumulasi sepanjang sesi agen.

Bagaimana tampilan kolom yang salah#

Masing-masing dari tiga kolom bisa menjadi penyebabnya:

• Key salah. API menjawab 401 — key hilang, salah ketik, atau ada spasi di akhir akibat menyalin.
• Base URL salah. Permintaan menuju tempat yang salah dan Anda mendapat 404 atau error koneksi. Alamat harus berakhiran /v1 dan tidak mengandung path tambahan.
• String model salah. Entah prefiksnya hilang, atau id setelahnya bukan id lengkap (API hanya menerima gateway_id lengkap, bukan id pendek seperti deepseek-v4-flash-0731).

Penjelasan lengkap untuk 401 versus 404 ada di API 401 atau 404: key, base URL, atau id model yang salah.

Berapa biaya satu sesi#

Agen menagih seluruh konteks di setiap langkah, bukan hanya tugas satu baris Anda. Misalkan OpenHands mengerjakan bug selama 40 langkah, dengan sekitar 30.000 token dikirim masuk dan 1.500 ditulis kembali per langkah. Satu langkah pada DeepSeek-V4-Flash adalah $0.0006; empat puluh langkah ada di bawah, bersebelahan dengan model lain dan OpenRouter.

Secara total, dengan input dan output dihitung bersama, DeepSeek-V4-Flash lebih murah daripada OpenRouter untuk beban kerja ini. Asumsinya bisa Anda ubah: perbaikan singkat mungkin butuh 10 langkah, refactor besar 100. Harga terkini ada di halaman harga, dan halaman modelnya adalah DeepSeek murah.

Sudah memakai OpenHands dengan penyedia lain?#

Maka Anda hanya menukar tiga nilai: Custom Model, Base URL, API Key. Tidak ada yang lain di proyek yang berubah, dan Anda bisa kembali dengan cara yang sama. Koneksi langkah demi langkah untuk API itu sendiri ada di dokumentasi CheapTokens; pengaturan serupa di alat lain adalah menghubungkan Aider.