Головна / Посібники / Використання OpenCode з безкоштовним LLM API

Використання OpenCode з безкоштовним LLM API

OpenCode це агент для написання коду з відкритим кодом для терміналу та настільного комп'ютера. Він приймає будь-якого провайдера, сумісного з OpenAI. Цей посібник підключає OpenCode до безкоштовних моделей через FreeLLMAPI. Одна команда записує конфігурацію і зберігає ключ.

Код, назви моделей і мітки живого каталогу показано англійською.

Крок 1: Встановіть FreeLLMAPI

FreeLLMAPI це шлюз з відкритим кодом. Він працює на вашому комп'ютері в Docker і об'єднує безкоштовні тарифи 45 провайдерів за одним ключем.

Встановлення на macOS або Linux

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

Відкрийте http://localhost:3001. Додайте щонайменше два ключі безкоштовних провайдерів на сторінці Keys. Google AI Studio і Groq кожен видають безкоштовний ключ за кілька хвилин. Скопіюйте єдиний ключ з тієї самої сторінки.

Крок 2: Підключіть OpenCode однією командою

Одна команда

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

Команда виконує три дії:

  • Вона додає провайдера freellmapi до ~/.config/opencode/opencode.json. Провайдер перелічує моделі з вашого актуального каталогу разом з їхніми лімітами контексту.
  • Вона встановлює freellmapi/auto як модель за замовчуванням.
  • Вона зберігає ключ у файлі облікових даних OpenCode, ~/.local/share/opencode/auth.json. Змінна середовища не потрібна ні в CLI, ні в настільному застосунку.

Перед записом команда створює резервну копію. Вона об'єднує нового провайдера з наявною конфігурацією, тому ваші інші провайдери залишаються. Якщо встановлено XDG_CONFIG_HOME або XDG_DATA_HOME, команда використовує ці папки.

Перед початком довгого завдання переконайтеся, що шлюз може обробити запит зараз. Цей виклик перелічує лише моделі, для яких у даний момент є придатний ключ:

Перевірте, які моделі готові

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

Модель зі статусом exhausted має ключі, але всі вони зараз досягли ліміту. Цей статус знімається, коли закінчуються паузи. Запустіть npx freellmapi doctor, щоб переконатися, що запити клієнта доходять до шлюзу. Журнал запитів на панелі керування показує кожен виклик від OpenCode. Заголовок відповіді X-Routed-Via називає провайдера і модель, які відповіли на кожен запит. Якщо запит перейшов на резервний варіант, заголовок X-Fallback-Trail називає кожну невдалу ланку і причину.

Ручне налаштування: блок провайдера opencode.json

Щоб налаштувати вручну, додайте цей блок до ~/.config/opencode/opencode.json або до opencode.json у вашому проєкті. OpenCode використовує @ai-sdk/openai-compatible для endpoint /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 }
        }
      }
    }
  }
}

Потім додайте ключ. Запустіть OpenCode, виконайте /connect, виберіть провайдера freellmapi і вставте ваш єдиний ключ. Ідентифікатор провайдера в /connect повинен збігатися з ідентифікатором у конфігурації. Виконайте /models, щоб вибрати модель.

  • limit.context це максимальна кількість вхідних токенів моделі. limit.output це максимальна кількість токенів, яку вона може згенерувати.
  • Верхньорівневий model використовує формат provider/model. Без нього OpenCode залишає модель, яку використовував раніше.
  • Кожен ідентифікатор моделі, який ви хочете використовувати, повинен бути в карті models. Додайте інші ідентифікатори з GET /v1/models.
Примітка щодо версій конфігурації: документація OpenCode тепер описує формат конфігурації V2 з ключем providers. Документація говорить, що формат V1 вище лишається підтримуваним. Команда налаштування FreeLLMAPI записує формат V1.

Вибір моделей для OpenCode

OpenCode це агент. Він читає файли, редагує їх і запускає команди через виклики інструментів. Кожен запит містить системний запит, описи інструментів і вміст файлів. Використовуйте моделі з викликом інструментів і великим контекстним вікном.

Безкоштовні моделі для OpenCode: виклик інструментів і контекст 128K+
МодельБезкоштовно наКонтекстБезкоштовні ліміти (найкращі)ІнструментиЗображення
GLM 5.3UnoRouter1M1 запитів/хв
1 req/min per model
ТакНі
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 запитів/хв
40 RPM
ТакТак
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaТакТак
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceТакНі
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditТакТак
Gemini 3.7 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditТакТак
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 запитів/хв
50 запитів/добу
50 req/day account-wide (1,000 after a $10 purchase)
ТакТак
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 запитів/хв
50 запитів/добу
Shared rate limit
ТакНі
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 запитів/хв
250 запитів/добу
70,000 токенів/хв
~6M
ТакТак
Gemini 3.6 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayТакТак

Показано 12 із 109 відповідних безкоштовних моделей. Переглянути всі моделі.

Дані в реальному часі з каталогу FreeLLMAPI (версія 2026.11.19, перевірено 2026-11-19). Безкоштовні ліміти часто змінюються. Каталог перевіряється щодня.

Використовуйте freellmapi/auto, щоб маршрутизатор вибирав модель для кожного запиту. Додайте auto:smart або auto:fast до карти models, щоб спрямовувати запити за інтелектом або швидкістю. Ви також можете додати іменований профіль, наприклад auto:coding, після того як створите його на панелі керування.

Ліміти частоти запитів і довгі сеанси

Одне завдання агента може надіслати десятки запитів. Один безкоштовний тариф швидко зупиняє довге завдання. FreeLLMAPI рахує запити і токени для кожного ключа. Коли провайдер надсилає помилку 429, маршрутизатор передає запит наступній моделі в ланцюжку, і сеанс продовжується.

  • Додайте ключі від чотирьох або більше провайдерів. Більше провайдерів дають більше запитів на день.
  • Увімкніть передачу контексту за допомогою FREELLMAPI_CONTEXT_HANDOFF=on_model_switch у .env FreeLLMAPI. Коли модель змінюється, наступна модель отримує коротку примітку про те, що вона продовжує завдання.
  • Липкі сеанси утримують розмову на одній моделі протягом 30 хвилин. Це забезпечує послідовність роботи агента.
  • Починайте новий сеанс для кожного завдання. Менший контекст використовує менше токенів на кожен запит.

Усунення несправностей

ПроблемаПричинаРішення
«Invalid API key» з дійсним ключемПорожній apiKey у конфігурації замінює ключ з /connectВидаліть apiKey з options або запустіть setup-opencode ще раз
OpenCode не використовує нового провайдераВерхньорівневий model не встановленоВстановіть "model": "freellmapi/auto"
Модель не знайденоІдентифікатора моделі немає в карті models провайдераДодайте ідентифікатор до карти або запустіть setup-opencode ще раз
Ключ {env:VAR} порожнійOpenCode замінює незаданий змінну порожнім рядкомЕкспортуйте змінну в тій самій оболонці або збережіть ключ за допомогою /connect
Виклики інструментів не працюютьМодель слабко підтримує виклик інструментівВиберіть модель з таблиці вище
«All models rate-limited after N attempts»Усі ключі досягли свого лімітуДодайте ключі від більшої кількості провайдерів або зачекайте завершення пауз
Використовуйте кожну з цих моделей через один ключ. FreeLLMAPI це маршрутизатор з відкритим кодом, який ви розгортаєте самі. Він об'єднує всі ці безкоштовні тарифи за однією кінцевою точкою, сумісною з OpenAI, і переходить до наступного, коли один з них досягає ліміту. Переглянути каталог або або почніть роботу.

Часті запитання

Чи можна використовувати OpenCode безкоштовно?

Так. OpenCode має відкритий код. Підключіть його до FreeLLMAPI як провайдера, сумісного з OpenAI. Шлюз надсилає кожен запит до безкоштовних тарифів провайдерів, тому вартість інференсу становить $0.

Як додати власного провайдера, сумісного з OpenAI, до OpenCode?

Додайте до opencode.json провайдера з npm, встановленим на @ai-sdk/openai-compatible, options.baseURL і карту models. Потім виконайте /connect, щоб зберегти ключ, і /models, щоб вибрати модель.

Яка безкоштовна модель найкраща для OpenCode?

Використовуйте модель з викликом інструментів і контекстом щонайменше 128K. Таблиця на цій сторінці показує найсильніші безкоштовні моделі, які відповідають обом вимогам на сьогодні. Використовуйте freellmapi/auto, щоб маршрутизатор вибрав одну з них.

Де OpenCode зберігає ключі API?

Ключі, додані через /connect, зберігаються в ~/.local/share/opencode/auth.json. Команда налаштування FreeLLMAPI записує ключ туди, тому CLI і настільний застосунок обидва його знаходять.

Схожі посібники

Джерела

Усі посібники · Переглянути всі безкоштовні моделі