Paano ikonekta ang OpenCode sa CheapTokens (opencode.json)

Upang ikonekta ang OpenCode sa CheapTokens, magdagdag ng custom na OpenAI-compatible provider: itago ang iyong API key gamit ang /connect (provider ID cheaptokens), pagkatapos ilarawan ang provider sa opencode.json gamit ang base URL https://api.cheaptokens.dev/v1. Pagkatapos nito, lalabas ang iyong mga CheapTokens model sa /models.

Sinusundan ng gabay na ito ang OpenCode providers documentation (page na na-update noong Oktubre 20, 2026; sinuri noong Oktubre 22, 2026). Gumagana rin ang parehong paraan para sa iba pang mga tool sa seryeng ito: Cline, Aider at Kilo Code.

Ano ang kailangan mo#

• Naka-install ang OpenCode (tingnan ang dokumentasyon nito para sa iyong platform).
• Isang CheapTokens API key. Gumawa ng isa sa iyong account at mag-top up ng balanse; isang balanse ang sumasaklaw sa lahat ng modelo. Nasa CheapTokens docs ang mga pangunahing kaalaman.
• Ang mga API fact:
  • base URL: https://api.cheaptokens.dev/v1
  • compatibility: OpenAI Chat Completions at Anthropic Messages
  • model id na ginamit sa ibaba: deepseek-ai/DeepSeek-V4-Flash-0731 (380K context, hanggang 32,768 output tokens). Nakalista ang mga model id sa CheapTokens docs: nagkakaiba ang mga pangalan sa pagitan ng mga provider, kaya kopyahin ang id mula doon.

Hakbang 1. Itago ang key gamit ang /connect#

1. Simulan ang OpenCode sa iyong proyekto at patakbuhin ang /connect.
2. Mag-scroll sa Other.
3. Maglagay ng natatanging provider ID: cheaptokens.
4. I-paste ang iyong CheapTokens API key.

Ang hakbang na ito ay nag-iimbak lamang ng credential. Hindi pa rin alam ng OpenCode ang address o ang mga modelo ng provider: para iyon ang opencode.json.

Hakbang 2. Ilarawan ang provider sa opencode.json#

Gumawa o i-edit ang opencode.json at idagdag ang provider. Ang provider ID sa provider ay dapat tumugma sa inilagay mo sa /connect.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

Ano ang ginagawa ng bawat bahagi:

• npm — @ai-sdk/openai-compatible ang package para sa mga endpoint na gumagamit ng /v1/chat/completions, na siyang inilalantad ng CheapTokens. (Ginagamit ng OpenCode ang @ai-sdk/openai para sa mga endpoint na binuo sa /v1/responses.)
• name — ang label na ipinapakita sa OpenCode interface.
• options.baseURL — ang CheapTokens API address.
• models — naka-key sa model id; ang name sa loob ay display name.
• limit.context / limit.output — opsyonal; sinasabi nila sa OpenCode ang context window ng modelo at maximum na haba ng sagot.

Itago ang key sa environment variable sa halip (opsyonal)#

Kung mas gusto mong hindi itago ang key sa credential store ng OpenCode, idagdag ang apiKey sa options gamit ang {env:VARIABLE} syntax na inirerekomenda ng docs:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Pagkatapos, i-export ang CHEAPTOKENS_API_KEY sa iyong shell. Huwag i-commit ang tunay na key sa repository. Kung bago ka sa mga key, basahin ang what an API key is and how to store it safely.

Hakbang 3. Suriin kung gumagana ito#

Patakbuhin ang /models at piliin ang DeepSeek-V4-Flash sa ilalim ng CheapTokens provider. Pagkatapos, magpadala ng maikling prompt, halimbawa: "Summarize what this repository does in three sentences." Ang normal na sagot ay nangangahulugang tama ang base URL, key at model id.

Aling CheapTokens model ang pipiliin#

Magdagdag ng kahit gaano karaming entry sa models — bawat isa ay isang block tulad ng nasa itaas, na may sariling id.

Para sa isang OpenCode session, na nagpapadala ng maraming request sa isang loop, ang DeepSeek-V4-Flash ay isang magandang default: mas mura ang output kaysa sa reference price ng OpenRouter, umaabot ang mga sagot sa 32,768 tokens, at walang peak hours ang presyo. Ang MiniMax-M2.7 ay mas mura rin kaysa sa reference prices ng OpenRouter sa parehong input at output. Ang output ng GLM-5.3-Flash ay mas mura rin kaysa sa reference price ng OpenRouter. Kasalukuyang mga presyo (sinuri nang live, walang numerong maluluma):

Upang tantiyahin ang isang working session, halimbawa 20 request na may 100,000 input at 5,000 output tokens bawat isa:

Tingnan ang all prices at ang DeepSeek page para sa higit pa.

Kung hindi ito gumagana#

• Nawawala ang provider o mga modelo sa /models. Suriin na ang opencode.json ay valid JSON (walang trailing commas) at ang key sa ilalim ng provider ay eksaktong ID na inilagay mo sa /connect. Kung tama ang dalawa, i-restart ang OpenCode.
• 401 / authentication error. Patakbuhin muli ang /connect at i-paste muli ang key, o suriin ang CHEAPTOKENS_API_KEY variable sa shell kung saan nagsisimula ang OpenCode.
• 404 o "model not found". Ang model id sa models ay dapat tumugma sa CheapTokens id nang karakter por karakter, kasama ang vendor prefix (deepseek-ai/…).
• Mga error sa koneksyon. Ang base URL ay dapat magtapos sa /v1 at walang dagdag na path. Tingnan ang common connection errors.
• "Not enough tokens". Mag-top up ng balanse; tingnan ang what the error means.

Mga susunod na hakbang#

Mayroon ka nang OpenCode na tumatakbo sa CheapTokens na may isang balanse para sa lahat ng modelo. Kumuha ng key at gawin ang iyong unang call mula sa CheapTokens docs.