Strona główna / Poradniki / Używaj OpenCode z darmowym API LLM

Używaj OpenCode z darmowym API LLM

OpenCode to agent kodowania open source do terminala i aplikacji desktopowej. Akceptuje dowolnego dostawcę zgodnego z OpenAI. Ten przewodnik łączy OpenCode z darmowymi modelami przez FreeLLMAPI. Jedno polecenie zapisuje konfigurację i przechowuje klucz.

Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.

Krok 1: Zainstaluj FreeLLMAPI

FreeLLMAPI to brama open source. Działa na Twoim komputerze w Dockerze i łączy darmowe poziomy 45 dostawców za jednym kluczem.

Instalacja na macOS lub Linuksie

curl -fsSL https://freellmapi.co/install.sh | bash

Otwórz http://localhost:3001. Dodaj co najmniej dwa darmowe klucze dostawców na stronie Keys. Google AI Studio i Groq dają darmowy klucz w kilka minut. Skopiuj swój zunifikowany klucz z tej samej strony.

Krok 2: Połącz OpenCode jednym poleceniem

Jedno polecenie

npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencode

Polecenie robi trzy rzeczy:

  • Dodaje dostawcę freellmapi do ~/.config/opencode/opencode.json. Dostawca wymienia modele z Twojego aktualnego katalogu wraz z ich limitami kontekstu.
  • Ustawia freellmapi/auto jako domyślny model.
  • Zapisuje klucz w pliku poświadczeń OpenCode, ~/.local/share/opencode/auth.json. Nie potrzebujesz zmiennej środowiskowej, ani w CLI, ani w aplikacji desktopowej.

Polecenie tworzy kopię zapasową przed zapisem. Scala nowego dostawcę, więc Twoi inni dostawcy zostają. Jeśli ustawiono XDG_CONFIG_HOME lub XDG_DATA_HOME, polecenie używa tych folderów.

Zanim zaczniesz długie zadanie, upewnij się, że brama może obsłużyć żądanie teraz. To wywołanie wymienia tylko modele, które mają w tej chwili działający klucz:

Sprawdź, które modele są gotowe

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Model ze statusem exhausted ma klucze, ale wszystkie osiągnęły teraz limit. Ten status znika, gdy kończą się cooldowny. Uruchom npx freellmapi doctor, aby upewnić się, że żądania klienta docierają do bramy. Dziennik żądań w panelu pokazuje każde wywołanie z OpenCode. Nagłówek odpowiedzi X-Routed-Via podaje dostawcę i model, które odpowiedziały na każde żądanie. Jeśli żądanie przeszło na inny model, nagłówek X-Fallback-Trail podaje każdy nieudany krok i przyczynę.

Konfiguracja ręczna: blok providera w opencode.json

Aby skonfigurować ręcznie, dodaj ten blok do ~/.config/opencode/opencode.json albo do opencode.json w projekcie. OpenCode używa @ai-sdk/openai-compatible dla endpointów /v1/chat/completions.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "freellmapi/auto",
  "provider": {
    "freellmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeLLMAPI",
      "options": {
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Następnie dodaj klucz. Uruchom OpenCode, wpisz /connect, wybierz dostawcę freellmapi i wklej swój zunifikowany klucz. ID dostawcy w /connect musi być takie samo jak ID w konfiguracji. Uruchom /models, aby wybrać model.

  • limit.context to maksymalna liczba tokenów wejściowych modelu. limit.output to maksymalna liczba tokenów, które model może wygenerować.
  • Najwyższy poziom model używa formatu provider/model. Bez niego OpenCode zachowuje model, którego używał wcześniej.
  • Każde ID modelu, którego chcesz użyć, musi być w mapie models. Dodaj więcej ID z GET /v1/models.
Uwaga o wersjach konfiguracji: dokumentacja OpenCode opisuje teraz format konfiguracji V2 z kluczem providers. Dokumentacja mówi, że format V1 opisany wyżej nadal jest obsługiwany. Polecenie konfiguracji FreeLLMAPI zapisuje format V1.

Wybierz modele dla OpenCode

OpenCode jest agentem. Czyta pliki, edytuje je i uruchamia polecenia przez wywołania narzędzi. Każde żądanie zawiera prompt systemowy, definicje narzędzi i zawartość plików. Używaj modeli z wywoływaniem narzędzi i dużym oknem kontekstu.

Darmowe modele dla OpenCode: wywoływanie narzędzi i kontekst 128K+
ModelZa darmo wKontekstDarmowe limity (najlepsza oferta)NarzędziaWizja
GLM 5.3UnoRouter1M1 żądań/min
1 req/min per model
TakNie
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 żądań/min
40 RPM
TakTak
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaTakTak
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceTakNie
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditTakTak
Gemini 3.7 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditTakTak
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 żądań/min
50 żądań/dzień
50 req/day account-wide (1,000 after a $10 purchase)
TakTak
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 żądań/min
50 żądań/dzień
Shared rate limit
TakNie
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 żądań/min
250 żądań/dzień
70,000 tokenów/min
~6M
TakTak
Gemini 3.6 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayTakTak

Pokazano 12 z 109 pasujących darmowych modeli. Zobacz wszystkie modele.

Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.

Użyj freellmapi/auto, aby router wybierał model dla każdego żądania. Dodaj auto:smart lub auto:fast do mapy models, aby kierować żądania według inteligencji lub szybkości. Możesz też dodać nazwany profil, na przykład auto:coding, po utworzeniu go w panelu.

Limity szybkości i długie sesje

Jedno zadanie agenta może wysłać kilkadziesiąt żądań. Pojedynczy darmowy poziom szybko zatrzymuje długie zadanie. FreeLLMAPI liczy żądania i tokeny każdego klucza. Gdy dostawca wyśle błąd 429, router kieruje żądanie do następnego modelu w łańcuchu, a sesja trwa dalej.

  • Dodaj klucze od czterech lub więcej dostawców. Więcej dostawców daje więcej żądań dziennie.
  • Włącz przekazanie kontekstu przez FREELLMAPI_CONTEXT_HANDOFF=on_model_switch w pliku .env FreeLLMAPI. Gdy model się zmieni, następny model dostanie krótką notatkę, że kontynuuje zadanie.
  • Sesje przypięte (sticky) trzymają rozmowę na jednym modelu przez 30 minut. Dzięki temu agent zachowuje spójność.
  • Zacznij nową sesję dla każdego zadania. Mniejszy kontekst zużywa mniej tokenów na żądanie.

Rozwiązywanie problemów

ProblemPrzyczynaRozwiązanie
"Invalid API key" przy poprawnym kluczuPuste apiKey w konfiguracji nadpisuje klucz z /connectUsuń apiKey z options lub uruchom setup-opencode ponownie
OpenCode nie używa nowego dostawcyNajwyższy poziom model nie jest ustawionyUstaw "model": "freellmapi/auto"
Nie znaleziono modeluID modelu nie ma w mapie models dostawcyDodaj ID do mapy lub uruchom setup-opencode ponownie
Klucz {env:VAR} jest pustyOpenCode zastępuje nieustawioną zmienną pustym ciągiemWyeksportuj zmienną w tej samej powłoce albo zapisz klucz przez /connect
Wywołania narzędzi się nie udająModel ma słabe wywoływanie narzędziWybierz model z tabeli powyżej
"Wszystkie modele osiągnęły limit po N próbach"Wszystkie klucze osiągnęły limitDodaj klucze od większej liczby dostawców lub poczekaj na cooldowny
Używaj wszystkich tych modeli przez jeden klucz. FreeLLMAPI to router o otwartym kodzie, uruchamiany na własnym serwerze. Łączy wszystkie te darmowe plany za jednym punktem końcowym zgodnym z OpenAI i przełącza się na inny dostawcę, gdy limit zostanie przekroczony. Przeglądaj katalog lub uruchom.

Najczęstsze pytania

Czy mogę używać OpenCode za darmo?

Tak. OpenCode jest open source. Połącz go z FreeLLMAPI jako dostawcę zgodnego z OpenAI. Brama wysyła każde żądanie do darmowych poziomów dostawców, więc koszt wnioskowania wynosi 0 USD.

Jak dodać własnego dostawcę zgodnego z OpenAI do OpenCode?

Dodaj do opencode.json dostawcę z npm ustawionym na @ai-sdk/openai-compatible, z options.baseURL i mapą models. Następnie uruchom /connect, aby zapisać klucz, i /models, aby wybrać model.

Który darmowy model jest najlepszy dla OpenCode?

Użyj modelu z wywoływaniem narzędzi i co najmniej 128K kontekstu. Tabela na tej stronie pokazuje najmocniejsze darmowe modele spełniające dziś oba warunki. Użyj freellmapi/auto, aby router sam wybrał jeden z nich.

Gdzie OpenCode przechowuje klucze API?

Klucze dodane przez /connect trafiają do ~/.local/share/opencode/auth.json. Polecenie konfiguracji FreeLLMAPI zapisuje tam klucz, więc zarówno CLI, jak i aplikacja desktopowa go znajdą.

Powiązane poradniki

Źródła

Wszystkie poradniki · Przeglądaj wszystkie darmowe modele