Hubungkan DeepSeek Harness ke CheapTokens: penyedia kustom

Untuk menggunakan DeepSeek Harness dengan CheapTokens, buka Settings → Models, alihkan kartu ke Custom model API, atur base URL ke https://api.cheaptokens.dev/v1, pilih OpenAI Chat Completions sebagai protokol, tempel kunci CheapTokens Anda dan tambahkan id model deepseek-ai/DeepSeek-V4-Flash-0731. Pilih model tersebut di pemilih model dan sesi berikutnya akan berjalan dengannya.

Itulah keseluruhan triknya. Sisa halaman ini adalah formulir persisnya, pemeriksaan cepat bahwa kunci berfungsi sebelum Anda menyalahkan aplikasi, dan daftar singkat hal yang perlu diperiksa ketika gateway menolak.

Pengaturan di bawah ini berasal dari dokumentasi Harness per 24 Oktober 2026. Proyek ini dalam pratinjau publik, dan README-nya memperingatkan bahwa akan ada perubahan yang merusak kompatibilitas, jadi jika ada label yang berpindah, percayai layar dan panduan penyedia.

Apa yang Anda hubungkan#

DeepSeek Harness adalah agen open-source dari DeepSeek (lisensi MIT, dibangun di atas arsitektur plugin Cordis). Tersedia sebagai aplikasi desktop untuk macOS di Apple silicon dan Windows 64-bit, atau sebagai web UI yang Anda jalankan dengan npx @deepseek-ai/dsh web (memerlukan Node.js). Web UI terbuka di http://127.0.0.1:3080 secara default.

Secara bawaan ia meminta kunci DeepSeek. Tetapi layar Models yang sama memiliki kartu untuk apa pun yang tidak ada di katalognya, relay, gateway perusahaan atau penyedia lain. Kartu itulah yang kita gunakan.

Di sisi CheapTokens Anda memerlukan dua hal: kunci dan saldo. Jika Anda belum membuat kunci, Permintaan API pertama Anda dengan CheapTokens hanya butuh beberapa menit, dan Apa itu API key dan cara menyimpannya dengan aman membahas di mana menyimpannya.

Periksa kunci sebelum Anda membuka Harness#

Satu permintaan dari terminal memberi tahu Anda apakah kunci, saldo dan id model sudah benar. Jika ini berhasil dan Harness tidak, masalahnya ada di formulir, bukan di akun.

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 hi in five words."}]
  }'

Anda harus mendapatkan jawaban JSON dengan array choices dan blok usage yang menghitung token input dan output. Kesalahan bergaya Invalid API key berarti kunci; pesan tentang saldo berarti perlu top-up.

Isi formulir penyedia kustom#

Buka Settings → Models dan alihkan kartu penyedia ke Custom model API. Isi kolom seperti ini:

Dua detail sering membuat orang tersandung. Pertama, base URL adalah https://api.cheaptokens.dev/v1, persis seperti pada curl di atas tanpa /chat/completions. Kedua, id model adalah yang lengkap dengan awalan deepseek-ai/. Nama pendek seperti deepseek-v4-flash bukan yang diharapkan API. Jika Anda ingin latar belakang tentang base_url dan cara mengalihkannya, lihat API kompatibel OpenAI: apa itu base_url dan cara mengalihkannya.

Ada juga tombol Fetch available models. Dokumentasi menyatakan bahwa tombol itu memanggil GET /models dan Anda selalu dapat mengetik id secara manual. Mengetiknya adalah jalur aman di sini, jadi lakukan itu.

Pilih model dan jalankan tugas pertama#

Buka pemilih model dan pilih model CheapTokens. Memilih model di sana menjadikannya default untuk sesi baru, jadi Anda tidak perlu mengulanginya.

Sekarang beri tugas kecil yang dapat diperiksa. Misalnya Anda punya proyek dengan tes yang gagal:

Run the tests, find why test_parse_date fails and fix it. Show me the diff.

Yang ingin Anda lihat: agen menjalankan perintah tes, membaca file yang gagal, mengeditnya, menjalankan tes lagi dan menampilkan diff. Jika ia melakukannya, koneksi selesai. Saldo Anda sekarang yang membiayai loop tersebut.

Mengapa model murah cocok untuk loop agen#

Agen tidak mengirim satu pertanyaan. Ia mengirim seluruh percakapan, daftar file dan output alat lagi di setiap langkah, jadi satu sesi sebagian besar adalah token input. Itulah yang membuat tagihan agen mengejutkan (mengapa obrolan panjang lebih mahal menjelaskan mekanismenya, dan Cara memperkirakan biaya agen AI memberikan metodenya).

Misalkan satu sesi memiliki 200 langkah, setiap langkah mengirim sekitar 30.000 token konteks dan mendapat sekitar 600 token kembali. Itu 200 × 30.000 = 6.000.000 token input dan 200 × 600 = 120.000 token output. Pada DeepSeek-V4-Flash sesi itu berbiaya $0.102 dengan harga hari ini, dan totalnya lebih murah daripada OpenRouter, dengan input dan output dihitung bersama. Tabel di bawah ini menggunakan beban kerja yang sama untuk setiap model yang kami tawarkan:

Untuk sesi panjang DeepSeek-V4-Flash memberi Anda jendela konteks 380K, hingga 32.768 token dalam satu jawaban, dan satu harga kapan pun: tanpa biaya tambahan jam sibuk. Ia menggunakan saldo yang sama dengan setiap model CheapTokens lainnya, jadi Anda dapat berganti model di Harness tanpa top-up lagi. Tarif terkini ada di halaman harga, dan halaman model memiliki lebih banyak tentang lini DeepSeek.

Ingin menjaga sesi lebih ringan? Tambahkan zai-org/GLM-5.3-Flash (konteks 390K, hingga 8.192 token output) atau MiniMaxAI/MiniMax-M2.7 (konteks 180K, hingga 8.192 token output) ke penyedia yang sama sebagai id model tambahan. Satu penyedia dapat menampung beberapa model, dan pemilih model memungkinkan Anda berpindah di antaranya.

Jika tidak berhasil#

Dokumentasi Harness mencantumkan tersangka yang biasa. Berikut ini beserta tindakannya:

• Gateway menolak setiap permintaan meskipun kunci dan URL sudah benar. Bentuk permintaan berbeda dari yang diharapkan endpoint. Harness memiliki pengaturan kompatibilitas per model, seperti peran yang digunakan untuk system prompt atau nama kolom token output. Pengaturan itu ada di $DSH_HOME/profiles/<profile>/cordis.patch.yml dan dimuat ulang tanpa restart. Ambil kunci persisnya dari panduan penyedia daripada menebaknya.
• Menu effort hilang untuk model yang Anda ketikkan. Harness hanya menampilkan tingkat penalaran untuk model yang mendeklarasikannya. Model yang dimasukkan manual tidak mendeklarasikan apa pun, jadi menunya tetap kosong. Mendeklarasikan tingkat adalah bagian dari file pengaturan per model yang sama.
• 401 saat mengambil model. Periksa kuncinya, atau lewati tombolnya dan masukkan id model sendiri.
• Jawaban berhenti di tengah kalimat. Itu batas token, bukan koneksi yang rusak; lihat mengapa jawaban AI berhenti di tengah kalimat.
• 401 atau 403 di log dari permintaan pertama. Ulangi pemeriksaan curl di atas dengan kunci yang sama. Jika curl berhasil, ketik ulang kunci di kolom Credential; spasi nyasar di akhir adalah kasus klasik.

Jika Anda sudah menggunakan agen lain dengan kunci yang sama, menghubungkan OpenCode mengikuti pola yang sama, dan dokumentasi CheapTokens mencantumkan setiap endpoint. Satu alat lagi di laci yang sama, satu saldo.

Sebelum Anda menutup tab#

• Base URL: https://api.cheaptokens.dev/v1
• Protokol: OpenAI Chat Completions
• Id model: deepseek-ai/DeepSeek-V4-Flash-0731
• Kunci: dari akun CheapTokens Anda, jauhkan dari tangkapan layar dan repo

Jalankan tugas tes yang gagal sekali dan pantau penggunaan pada saldo Anda. Satu kali jalan itu memberi tahu Anda berapa biaya sesi Anda sendiri.