Премини към основното съдържание
Български— Изберете език
Меню

Добавяне на персонализирани доставчици

Урок 7 от 16 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Защо да използвате доставчици от трети страни?
  2. Анатомия на един доставчик
  3. Примери за често срещани доставчици
  4. Деклариране на модел при доставчик
  5. Пълен пример: OpenRouter
  6. Локален доставчик с Ollama
  7. Ключови изводи

Обновено на 2 ноември 2026 г. — Devstral. Devstral 2 (devstral-2512) достигна края на своя жизнен цикъл на 31 юли 2026 г., а Devstral Small 2 — на 31 март 2026 г.: обажданията към тези модели вече не са гарантирани. Официалната таблица ги пренасочва към Mistral Medium 3.5, който самият той е обявен за остарял в полза на Mistral Large 4. Codestral (codestral-2508) остава общодостъпен за довършване на код. Проверете таблицата с модели, за да видите къде сочат псевдонимите -latest, преди да използвате повторно тези примери.

Защо да използвате доставчици от трети страни?

По подразбиране Vibe комуникира с API на Mistral. Но архитектурата на инструмента е проектирана да бъде независима: можете да добавите всеки доставчик, съвместим с формата на OpenAI API. Това отговаря на четири реални нужди. Можете да получите достъп до модели от други доставчици — Claude, GPT, Llama, да маршрутизирате заявки чрез релей като OpenRouter, за да сравните множество модели за една и съща задача, да се свържете с локално копие (Ollama, vLLM), когато кодът не трябва да напуска машината, или да превключвате доставчиците в зависимост от естеството на работата.

Типичен сценарий включва екип, който работи ежедневно с Devstral 2 чрез API на Mistral, но преминава към локално копие винаги, когато обработва клиентско хранилище, подлежащо на ограничения за поверителност.

Анатомия на един доставчик

Вие декларирате доставчик във файла config.toml, използвайки директивата [[providers]]:

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

Всяко поле има специфична роля:

  • name — Уникален идентификатор за доставчика (използва се за препратка към модели)
  • api_base — Базов URL на API (краят /chat/completions ще бъде добавен автоматично)
  • api_key_env_var — Име на променливата на средата, съдържаща API ключа
  • api_style — Формат на API. Използвайте "openai" за всеки доставчик, съвместим с OpenAI
  • backend — Тип бекенд. "generic" работи за повечето случаи

Класическият капан се отнася до api_base: тъй като Vibe сам добавя /chat/completions, URL адрес, който вече включва този суфикс, ще доведе до невалиден адрес и мрежова грешка, която е трудна за диагностициране.

Примери за често срещани доставчици

Ето стойностите, които трябва да въведете за най-разпространените услуги. Двата локални доставчици нямат променлива за ключ, тъй като не изискват удостоверяване.

Доставчикapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (локален)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_API_KEY
vLLM (собствен хостинг)http://votre-serveur:8000/v1—

Деклариране на модел при доставчик

Самото деклариране на доставчика не е достатъчно: след това трябва да прикачите моделите, които възнамерявате да използвате.

[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2

Полето name повтаря идентификатора на модела точно така, както го познава доставчикът, знак по знак. provider трябва да съвпада с name на предварително деклариран доставчик, в противен случай Vibe няма да знае къде да изпрати заявката. alias дефинира съкратено име за използване във Vibe, а temperature задава нивото на креативност, от 0.0 за детерминирано поведение до 1.0 за по-изобретателен модел. За код ниска стойност като тази в примера води до много по-стабилни резултати.

За да активирате този модел по подразбиране, просто използвайте повторно неговия псевдоним:

active_model = "devstral-openrouter"

Пълен пример: OpenRouter

Ето пълна конфигурация с един доставчик и два прикачени модела:

# ~/.vibe/config.toml

# Доставчик OpenRouter
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

# Безплатен модел Devstral чрез OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2

# Модел Llama чрез OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3

Сама по себе си конфигурацията не е достатъчна: все още трябва да дефинирате променливата на средата, която доставчикът очаква, иначе обажданията ще бъдат изпратени без удостоверяване.

export OPENROUTER_API_KEY="sk-or-votre-cle-ici"

След като и двата модела са декларирани, разполагате с два взаимозаменяеми псевдонима. По време на сесия командата /model devstral-free превключва между тях, без да губи разговора, което Ви позволява да сравните два отговора за един и същи проблем. При стартиране опцията --model прави същото: vibe --model llama-70b.

Локален доставчик с Ollama

Случаят с модел, обслужван локално, заслужава отделен пример, тъй като не изисква API ключ: полето api_key_env_var просто остава празно.

[[providers]]
name = "ollama"
api_base = "http://localhost:11434/v1"
api_key_env_var = ""
api_style = "openai"
backend = "generic"

[[models]]
name = "codestral:latest"
provider = "ollama"
alias = "codestral-local"

Предимството е пряко: Вашите данни никога не напускат Вашата машина. Това е опцията, която трябва да изберете за работа с чувствителен код или просто за да продължите да пишете код във влак без интернет връзка.

Ключови изводи

  • Vibe поддържа всеки доставчик, съвместим с формата на OpenAI API
  • Декларирайте доставчик с [[providers]] във файла config.toml
  • Всеки модел е прикачен към доставчик и може да има псевдоним
  • /model Ви позволява да превключвате между моделите по време на сесия
  • Локалните доставчици (Ollama, vLLM) позволяват работа офлайн