Jak połączyć OpenCode z CheapTokens (opencode.json)

Aby połączyć OpenCode z CheapTokens, dodaj niestandardowego dostawcę zgodnego z OpenAI: zapisz klucz API za pomocą /connect (identyfikator dostawcy cheaptokens), a następnie opisz dostawcę w opencode.json z bazowym adresem URL https://api.cheaptokens.dev/v1. Po tym Twoje modele CheapTokens pojawią się w /models.

Ten przewodnik opiera się na dokumentacji dostawców OpenCode (strona zaktualizowana 20 października 2026; sprawdzona 22 października 2026). To samo podejście działa dla pozostałych narzędzi z tej serii: Cline, Aider i Kilo Code.

Co będzie potrzebne#

• Zainstalowany OpenCode (patrz jego dokumentacja dla Twojej platformy).
• Klucz API CheapTokens. Utwórz go na swoim koncie i doładuj saldo; jedno saldo obejmuje wszystkie modele. Podstawy znajdziesz w dokumentacji CheapTokens.
• Fakty o API:
  • bazowy adres URL: https://api.cheaptokens.dev/v1
  • zgodność: OpenAI Chat Completions i Anthropic Messages
  • identyfikator modelu użyty poniżej: deepseek-ai/DeepSeek-V4-Flash-0731 (kontekst 380K, do 32 768 tokenów wyjściowych). Identyfikatory modeli są wymienione w dokumentacji CheapTokens: nazwy różnią się między dostawcami, więc skopiuj identyfikator stamtąd.

Krok 1. Zapisz klucz za pomocą /connect#

1. Uruchom OpenCode w swoim projekcie i wykonaj /connect.
2. Przewiń do Other.
3. Wprowadź unikalny identyfikator dostawcy: cheaptokens.
4. Wklej swój klucz API CheapTokens.

Ten krok tylko zapisuje dane uwierzytelniające. OpenCode nadal nie zna adresu ani modeli dostawcy: do tego służy opencode.json.

Krok 2. Opisz dostawcę w opencode.json#

Utwórz lub edytuj opencode.json i dodaj dostawcę. Identyfikator dostawcy w provider musi być zgodny z tym, który wprowadziłeś w /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
          }
        }
      }
    }
  }
}

Co robi każda część:

• npm — @ai-sdk/openai-compatible to pakiet dla punktów końcowych korzystających z /v1/chat/completions, które udostępnia CheapTokens. (OpenCode używa @ai-sdk/openai dla punktów końcowych opartych na /v1/responses.)
• name — etykieta wyświetlana w interfejsie OpenCode.
• options.baseURL — adres API CheapTokens.
• models — kluczowany po identyfikatorze modelu; name w środku to nazwa wyświetlana.
• limit.context / limit.output — opcjonalne; informują OpenCode o oknie kontekstu modelu i maksymalnej długości odpowiedzi.

Zamiast tego trzymaj klucz w zmiennej środowiskowej (opcjonalnie)#

Jeśli wolisz nie trzymać klucza w magazynie danych uwierzytelniających OpenCode, dodaj apiKey do options ze składnią {env:VARIABLE} zalecaną w dokumentacji:

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

Następnie wyeksportuj CHEAPTOKENS_API_KEY w swojej powłoce. Nie commituj prawdziwego klucza do repozytorium. Jeśli dopiero zaczynasz z kluczami, przeczytaj czym jest klucz API i jak go bezpiecznie przechowywać.

Krok 3. Sprawdź, czy działa#

Uruchom /models i wybierz DeepSeek-V4-Flash w ramach dostawcy CheapTokens. Następnie wyślij krótkie polecenie, na przykład: "Podsumuj w trzech zdaniach, co robi to repozytorium." Normalna odpowiedź oznacza, że bazowy adres URL, klucz i identyfikator modelu są poprawne.

Który model CheapTokens wybrać#

Dodaj tyle wpisów do models, ile chcesz — każdy to blok taki jak powyżej, z własnym identyfikatorem.

Dla sesji OpenCode, która wysyła wiele żądań w pętli, DeepSeek-V4-Flash to dobry domyślny wybór: wyjście jest tańsze niż cena referencyjna OpenRouter, odpowiedzi mogą osiągnąć 32 768 tokenów, a cena nie ma godzin szczytu. MiniMax-M2.7 jest również tańszy niż ceny referencyjne OpenRouter zarówno na wejściu, jak i na wyjściu. Wyjście GLM-5.3-Flash jest także tańsze niż cena referencyjna OpenRouter. Aktualne ceny (sprawdzane na żywo, żadne liczby się nie zdezaktualizują):

Aby oszacować sesję roboczą, na przykład 20 żądań po 100 000 tokenów wejściowych i 5 000 tokenów wyjściowych każde:

Zobacz wszystkie ceny i stronę DeepSeek, aby dowiedzieć się więcej.

Jeśli nie działa#

• Dostawcy lub modeli brakuje w /models. Sprawdź, czy opencode.json to poprawny JSON (bez końcowych przecinków) i czy klucz pod provider to dokładnie ten identyfikator, który wprowadziłeś w /connect. Jeśli oba są poprawne, zrestartuj OpenCode.
• 401 / błąd uwierzytelniania. Uruchom ponownie /connect i wklej klucz jeszcze raz, albo sprawdź zmienną CHEAPTOKENS_API_KEY w powłoce, w której uruchamia się OpenCode.
• 404 lub "model not found". Identyfikator modelu w models musi być zgodny z identyfikatorem CheapTokens znak po znaku, łącznie z prefiksem dostawcy (deepseek-ai/…).
• Błędy połączenia. Bazowy adres URL musi kończyć się na /v1 i nie zawierać dodatkowej ścieżki. Zobacz typowe błędy połączenia.
• "Not enough tokens". Doładuj saldo; zobacz co oznacza ten błąd.

Następne kroki#

Masz teraz OpenCode działający na CheapTokens z jednym saldem dla wszystkich modeli. Zdobądź klucz i wykonaj pierwsze wywołanie z dokumentacji CheapTokens.