Ikonekta ang OpenHands sa CheapTokens: model, Base URL, key

Maaari mong patakbuhin ang OpenHands sa isang CheapTokens model sa pamamagitan ng pagpuno ng tatlong field sa Settings > LLM pagkatapos i-on ang Advanced: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL (https://api.cheaptokens.dev/v1), at API Key. Iyon na ang buong setup. Ang natitirang bahagi ng pahinang ito ay ang kahulugan ng bawat field at ang hitsura kapag may mali sa isa sa kanila.

Ang mga pangalan ng field at ang panuntunan sa model-string ay mula sa OpenHands docs page tungkol sa OpenAI-compatible endpoints (sinuri noong 8 Nobyembre 2026; walang petsa o bersyon ang pahina). Ang pinakabagong OpenHands release sa petsang iyon ay v1.37.0 (6 Nobyembre 2026). Kung ang label sa iyong build ay bahagyang naiiba, sundin ang posisyon: model, base URL, key.

Bago mo buksan ang Settings#

Tatlong bagay na dapat nasa kamay ang makakatipid sa iyo ng isang round trip: ang key, ang model id, at access sa Settings.

Bago sa keys at base URLs? Ang What base_url is and how to switch ay sumasaklaw nito sa ilang minuto, at ang list models with GET /v1/models ay nagpapakita kung paano maghanap ng id nang mag-isa.

Ang tatlong field#

Buksan ang Settings > LLM at i-on ang Advanced. Ang Base URL field ay nasa ilalim ng Advanced toggle.

Inilalarawan ng docs ang panuntunan sa model nang ganito: Ang Custom Model ay openai/ na sinusundan ng pangalan ng model, at kung dadaan ka sa isang proxy na may sariling prefix, openai/<proxy-prefix>/<model-name>. Ang bahagi pagkatapos ng openai/ ay ang pangalan ng model. Para sa CheapTokens ang id ay deepseek-ai/DeepSeek-V4-Flash-0731, kaya ang buong string ay openai/deepseek-ai/DeepSeek-V4-Flash-0731.

Bakit itong model para sa isang agent? Ang DeepSeek-V4-Flash ay may 380K context window at hanggang 32,768 output tokens bawat sagot, at isang presyo sa anumang oras, kaya ang mahabang session ay hindi nagmamahal sa peak time. Ang isang coding agent ay muling nagpapadala ng maraming context sa bawat hakbang, at iyon ang gamit ng window.

Mas gusto mo ang GLM? Gamitin ang openai/zai-org/GLM-5.3-Flash (390K context, hanggang 8,192 output tokens) sa parehong field at walang iba pang babaguhin. Pareho ang balance, pareho ang key, pareho ang Base URL.

Suriin muna ang mga piyesa sa labas ng OpenHands#

Bago mo sisihin ang agent, magpadala ng isang request gamit ang parehong URL, key at id. Kung gumana ito, anumang natitirang problema ay nasa paraan ng pag-type mo sa mga field.

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}'

Pansinin ang nawawala: walang openai/ sa model value. Ang prefix na iyon ay para sa OpenHands, hindi para sa API. Ang tugon ay may usage block na may prompt_tokens at completion_tokens — ang parehong dalawang numero na makikita mong nagdadagdag sa isang agent session.

Ang hitsura ng maling field#

Ang bawat isa sa tatlong field ay maaaring maging sanhi:

• Maling key. Ang API ay sumasagot ng 401 — nawawala ang key, mali ang pagkakasulat, o may trailing space mula sa pagkopya.
• Maling Base URL. Napupunta ang request sa maling lugar at makakakuha ka ng 404 o connection error. Dapat magtapos ang address sa /v1 at walang dagdag na path.
• Maling model string. Alinman sa nawawala ang prefix, o ang id pagkatapos nito ay hindi ang buong id (tumatanggap lamang ang API ng buong gateway_id, hindi ng maikling id tulad ng deepseek-v4-flash-0731).

Ang buong paliwanag para sa 401 kumpara sa 404 ay nasa API 401 or 404: wrong key, base URL or model id.

Magkano ang isang session#

Ang isang agent ay nagsisingil para sa buong context sa bawat hakbang, hindi para sa iyong one-line task. Sabihin nating ginagawa ng OpenHands ang isang bug sa loob ng 40 hakbang, na may mga 30,000 tokens na ipinapadala at 1,500 na isinusulat pabalik bawat hakbang. Ang isang hakbang sa DeepSeek-V4-Flash ay $0.0006; ang apatnapu nito ay nasa ibaba, katabi ng iba pang mga model at OpenRouter.

Sa kabuuan, kung pagsasamahin ang input at output, ang DeepSeek-V4-Flash ay lumalabas na mas mura kaysa sa OpenRouter para sa workload na ito. Ang mga assumption ay sa iyo baguhin: ang isang maikling fix ay maaaring tumagal ng 10 hakbang, ang isang malaking refactor ay 100. Ang kasalukuyang presyo ay nasa pricing page, at ang model page ay cheap DeepSeek.

Gumagamit ka na ba ng OpenHands sa ibang provider?#

Kung gayon, tatlong value lang ang papalitan mo: Custom Model, Base URL, API Key. Walang ibang nagbabago sa proyekto, at maaari kang bumalik sa dati sa parehong paraan. Ang step-by-step na koneksyon para sa API mismo ay nasa CheapTokens docs; ang katulad na setup sa ibang tool ay connect Aider.