Bumalik sa blog

Mga tool at integrasyonGabay

Ikonekta ang DeepSeek Harness sa CheapTokens: custom provider

Magdagdag ng custom na OpenAI-compatible provider sa DeepSeek Harness, ituro ito sa CheapTokens API at magpatakbo ng unang coding task. Dagdag pa, ano ang dapat i-check kung nabigo ito.

Ni CheapTokens TeamNai-publish noong 7 min na pagbabasa

Cover: DeepSeek Harness na konektado sa CheapTokens sa pamamagitan ng custom provider
Sa pahinang ito
  1. Ano ang kinokonekta mo
  2. I-check ang key bago mo buksan ang Harness
  3. Punan ang custom provider form
  4. Piliin ang model at magpatakbo ng unang task
  5. Bakit bagay ang murang model sa isang agent loop
  6. Kung hindi ito gumagana
  7. Bago mo isara ang tab

Para gamitin ang DeepSeek Harness sa CheapTokens, buksan ang Settings → Models, ilipat ang card sa Custom model API, itakda ang base URL sa https://api.cheaptokens.dev/v1, piliin ang OpenAI Chat Completions bilang protocol, i-paste ang iyong CheapTokens key at idagdag ang model id na deepseek-ai/DeepSeek-V4-Flash-0731. Piliin ang model na iyon sa picker at ang susunod mong session ay tatakbo dito.

Iyon na ang buong trick. Ang natitirang bahagi ng page na ito ay ang eksaktong form, isang mabilis na check na gumagana ang key bago mo sisihin ang app, at isang maikling listahan ng mga dapat tingnan kapag tumanggi ang gateway.

Ang mga setting sa ibaba ay mula sa Harness docs noong 24 Oktubre 2026. Ang proyekto ay nasa public preview, at nagbabala ang README nito na magkakaroon ng mga pagbabagong makakasira ng compatibility, kaya kung may label na lumipat, pagkatiwalaan ang screen at ang provider guide.

Ano ang kinokonekta mo#

Ang DeepSeek Harness ay isang open-source agent mula sa DeepSeek (MIT license, nakabase sa Cordis plugin architecture). Dumadating ito bilang desktop app para sa macOS sa Apple silicon at Windows 64-bit, o bilang web UI na sinisimulan mo gamit ang npx @deepseek-ai/dsh web (kailangan ang Node.js). Ang web UI ay bumubukas sa http://127.0.0.1:3080 bilang default.

Out of the box, humihingi ito ng DeepSeek key. Pero ang parehong Models screen ay may card para sa anumang wala sa catalog nito, isang relay, isang company gateway o ibang provider. Ang card na iyon ang ginagamit natin.

Sa panig ng CheapTokens kailangan mo ng dalawang bagay: isang key at isang balance. Kung wala ka pang nagawang key, ang Your first API request with CheapTokens ay tumatagal ng ilang minuto, at ang What is an API key and how to store it safely ay sumasaklaw sa kung saan ito itatago.

I-check ang key bago mo buksan ang Harness#

Isang request mula sa terminal ang magsasabi sa iyo kung maayos ang key, ang balance at ang model id. Kung gumagana ito at hindi gumagana ang Harness, ang problema ay nasa form, hindi sa account.

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

Dapat kang makakuha ng JSON answer na may choices array at isang usage block na nagbibilang ng input at output tokens. Ang error na may estilo na Invalid API key ay nangangahulugang ang key; ang mensahe tungkol sa balance ay nangangahulugang kailangan ng top-up.

Punan ang custom provider form#

Buksan ang Settings → Models at ilipat ang provider card sa Custom model API. Punan ang mga field nang ganito:

Field Ano ang ilalagay
Provider ID cheaptokens (lowercase; hindi na ito mababago mamaya, kaya pumili ng pangalang gusto mo)
Display name CheapTokens
Base URL https://api.cheaptokens.dev/v1
API protocol OpenAI Chat Completions
Credential ang iyong CheapTokens API key
Models deepseek-ai/DeepSeek-V4-Flash-0731

Dalawang detalye ang nagpapatalisod sa mga tao. Una, ang base URL ay https://api.cheaptokens.dev/v1, eksaktong tulad ng sa curl sa itaas na walang /chat/completions. Pangalawa, ang model id ay ang buong isa na may prefix na deepseek-ai/. Ang maikling pangalan tulad ng deepseek-v4-flash ay hindi ang inaasahan ng API. Kung gusto mo ang background tungkol sa base_url at kung paano ito palitan, tingnan ang OpenAI-compatible API: what base_url is and how to switch.

Mayroon ding Fetch available models button. Sinasabi ng docs na nag-query ito sa GET /models at maaari mong laging i-type nang manu-mano ang id. Ang pag-type nito ang ligtas na paraan dito, kaya gawin iyon.

Custom model API card sa DeepSeek Harness: ang walang laman na form ay nagiging punong CheapTokens provider
Illustration: ang Custom model API card bago at pagkatapos punan

Piliin ang model at magpatakbo ng unang task#

Buksan ang model picker at piliin ang CheapTokens model. Ang pagpili ng model doon ay ginagawa itong default para sa mga bagong session, kaya hindi mo na kailangang ulitin.

Ngayon bigyan ito ng maliit at masusuri na bagay. Sabihin nating mayroon kang proyekto na may failing test:

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

Ang gusto mong makita: pinapatakbo ng agent ang test command, binabasa ang failing file, ine-edit ito, pinapatakbo muli ang mga test at nagpapakita ng diff. Kung ginagawa nito iyon, tapos na ang koneksyon. Ang iyong balance na ngayon ang nagbabayad para sa loop.

Bakit bagay ang murang model sa isang agent loop#

Ang agent ay hindi nagpapadala ng isang tanong. Ipinapadala nito ang buong usapan, ang mga file listing at ang tool output muli sa bawat hakbang, kaya ang isang session ay halos input tokens. Iyon ang dahilan kung bakit nakakagulat ang mga bill ng agent (why a long chat costs more ay nagpapaliwanag ng mekanika, at ang How to estimate the cost of an AI agent ay nagbibigay ng paraan).

Sabihin nating ang isang session ay may 200 hakbang, ang bawat hakbang ay nagpapadala ng mga 30,000 tokens ng context at nakakakuha ng mga 600 tokens pabalik. Iyon ay 200 × 30,000 = 6,000,000 input tokens at 200 × 600 = 120,000 output tokens. Sa DeepSeek-V4-Flash ang session na iyon ay nagkakahalaga ng $0.102 sa mga presyo ngayon, at ito ay mas mura kaysa sa OpenRouter sa kabuuan, kasama ang input at output. Ang talahanayan sa ibaba ay gumagamit ng parehong workload para sa bawat model na inaalok namin:

Modelo Gastos OpenRouter
GLM-5.3-Flash $0.125 $0.257
DeepSeek-V4-Flash $0.102 $0.304
MiniMax-M2.7 $0.318 $1.94

6,000,000 input at 120,000 output na token sa kabuuan. Ang mga presyo kada 1M token ay kasalukuyan at nagbabago kasabay ng aming mga taripa; ang column ng OpenRouter ay nagpapakita ng reference na presyo para sa parehong workload.

Para sa mahabang session, ang DeepSeek-V4-Flash ay nagbibigay sa iyo ng 380K context window, hanggang 32,768 tokens sa isang sagot, at isang presyo sa anumang oras: walang peak-hour surcharge. Gumagamit ito ng parehong balance tulad ng bawat ibang CheapTokens model, kaya maaari kang lumipat ng model sa Harness nang hindi nagto-top up muli. Ang mga kasalukuyang rate ay nasa pricing page, at ang model page ay may higit pa tungkol sa DeepSeek line.

Mas gusto mong panatilihing mas magaan ang session? Idagdag ang zai-org/GLM-5.3-Flash (390K context, hanggang 8,192 output tokens) o MiniMaxAI/MiniMax-M2.7 (180K context, hanggang 8,192 output tokens) sa parehong provider bilang karagdagang model ids. Ang isang provider ay maaaring maghawak ng ilang model, at hinahayaan ka ng picker na lumipat sa pagitan nila.

Kung hindi ito gumagana#

Inililista ng Harness docs ang mga karaniwang suspect. Narito sila kasama ang dapat gawin:

  • Tumanggi ang gateway sa bawat request kahit tama ang key at URL. Ang hugis ng request ay naiiba sa inaasahan ng endpoint. Ang Harness ay may per-model compatibility settings, tulad ng role na ginagamit para sa system prompt o ang pangalan ng output-token field. Nasa $DSH_HOME/profiles/<profile>/cordis.patch.yml ang mga ito at nagre-reload nang walang restart. Kunin ang eksaktong mga key mula sa provider guide sa halip na hulaan ang mga ito.
  • Nawawala ang effort menu para sa model na ini-type mo. Ipinapakita ng Harness ang mga reasoning level para lamang sa mga model na nagdedeklara ng mga ito. Ang manu-manong inilagay na model ay walang idineklara, kaya nananatiling walang laman ang menu. Ang pagdedeklara ng mga level ay bahagi ng parehong per-model settings file.
  • 401 kapag kumukuha ng mga model. I-check ang key, o laktawan ang button at ilagay mismo ang model id.
  • Nahinto ang sagot sa gitna ng pangungusap. Iyon ay token limit, hindi sirang koneksyon; tingnan ang why an AI answer stops mid-sentence.
  • Isang 401 o 403 sa log mula sa unang request. Ulitin ang curl check sa itaas gamit ang parehong key. Kung gumagana ang curl, i-type muli ang key sa Credential field; ang stray space sa dulo ay klasiko.

Kung gumagamit ka na ng ibang agent na may parehong key, ang connecting OpenCode ay sumusunod sa parehong pattern, at ang CheapTokens docs ay naglilista ng bawat endpoint. Isang tool pa sa parehong drawer, isang balance.

Bago mo isara ang tab#

  • Base URL: https://api.cheaptokens.dev/v1
  • Protocol: OpenAI Chat Completions
  • Model id: deepseek-ai/DeepSeek-V4-Flash-0731
  • Key: mula sa iyong CheapTokens account, itinatago mula sa mga screenshot at repo

Patakbuhin ang failing-test task nang isang beses at panoorin ang usage sa iyong balance. Ang isang run na iyon ay magsasabi sa iyo kung magkano ang gastos ng sarili mong mga session.