Ollama API key: нужен ли ключ локально и как устроен облачный API

  </tr><tr>
    <td>
    <p>Локальная модель</p>
  </td>
<td>
    <p><code>http://127.0.0.1:11434/api</code></p>
  </td>
<td>
    <p>Запущенный Ollama и установленная локальная модель; ключ не требуется <a href="#src-s1" rel="noopener noreferrer">s1</a><a href="#src-s2" rel="noopener noreferrer">s2</a></p>
  </td>

  </tr><tr>
    <td>
    <p>Прямой Ollama Cloud</p>
  </td>
<td>
    <p><code>https://ollama.com/api</code></p>
  </td>
<td>
    <p>Ключ аккаунта в Bearer-заголовке; локальный сервер не требуется <a href="#src-s1" rel="noopener noreferrer">s1</a><a href="#src-s3" rel="noopener noreferrer">s3</a></p>
  </td>

  </tr><tr>
    <td>
    <p>OpenAI-совместимый локальный клиент</p>
  </td>
<td>
    <p><code>http://127.0.0.1:11434/v1</code></p>
  </td>
<td>
    <p>Клиент может требовать непустой <code>api_key</code>, который сервер Ollama игнорирует <a href="#src-s7" rel="noopener noreferrer">s7</a></p>
  </td>

  </tr><tr>
    <td>
    <p>OpenAI-совместимый прямой cloud</p>
  </td>
<td>
    <p><code>https://ollama.com/v1</code></p>
  </td>
<td>
    <p>Действительный ключ Ollama, не локальная заглушка <a href="#src-s2" rel="noopener noreferrer">s2</a><a href="#src-s7" rel="noopener noreferrer">s7</a></p>
  </td>

  </tr></tbody>
    </table>
  <p>Проверьте <strong>фактический base URL клиента</strong>, не только название модели. На удалённой машине <code>localhost</code> указывает на неё саму, а не на компьютер с Ollama. Если URL ведёт к <code>ollama.com</code>, содержимое запросов отправляется в облачный сервис; Ollama описывает обработку cloud-промптов и ответов отдельно от локального режима <a href="#src-s3" rel="noopener noreferrer">s3</a><a href="#src-s4" rel="noopener noreferrer">s4</a>. Для данных компании сначала установите правила доступа и размещения, затем проверяйте сетевой выход по <a href="/zhurnal/proverka-offline-kontura-ii/" rel="noopener noreferrer">методике офлайн-контура</a>.</p><h2>Как без ключа проверить именно локальный endpoint?</h2><p>После запуска Ollama на <strong>своём</strong> устройстве выполните:</p><p>curl -sS -f http://127.0.0.1:11434/api/tags<br /></p><p>Официальный <code>GET /api/tags</code> возвращает список локально доступных моделей, включая их имена; в схеме также предусмотрены признаки <code>remote_model</code> и <code>remote_host</code> у удалённой модели <a href="#src-s5" rel="noopener noreferrer">s5</a>. Успешный HTTP-ответ подтверждает доступность сервера, <strong>не</strong> ответ модели и <strong>не</strong> отсутствие облачных обращений. Пустой список означает, что сначала следует выбрать и загрузить подходящую модель. Если сервис на другом адресе, используйте фактическое значение привязки и не публикуйте его в открытой сети <a href="#src-s4" rel="noopener noreferrer">s4</a>.</p><p>Для проверки генерации возьмите <strong>имя своей локально загруженной модели</strong> из списка и отправьте короткий вымышленный запрос (не документы клиентов). Синтаксис <code>/api/chat</code> и <code>stream:false</code> описан в API Ollama <a href="#src-s6" rel="noopener noreferrer">s6</a><a href="#src-s8" rel="noopener noreferrer">s8</a>:</p><p>curl -sS -f http://127.0.0.1:11434/api/chat \<br />  -H 'Content-Type: application/json' \<br />  -d '{"model":"ИМЯ_ВАШЕЙ_ЛОКАЛЬНОЙ_МОДЕЛИ","messages":[{"role":"user","content":"Ответь одним словом: готово"}],"stream":false}'<br /></p><p>Замените демонстрационное имя <strong>точным</strong> именем из <code>/api/tags</code>; пример с буквальным заполнителем не предназначен для запуска. Проверьте <code>message.content</code> в ответе. Если получили ошибку подключения, сперва проверьте, запущен ли сервер и тот ли порт указан. Если указанной модели нет, загрузите совместимую локальную модель по <a href="/zapusk/ollama/" rel="noopener noreferrer">гайду Ollama</a> и повторите. Собственный ответ или скорость этого примера Modelium не измерял.</p><h2>Как проверить прямой облачный запрос, не перепутав его с локальным?</h2><p>На стороне <strong>своего приложения</strong> создайте ключ в настройках Ollama и передайте его по HTTPS в <code>Authorization: Bearer</code> к <code>https://ollama.com/api/chat</code>; для ответа нужен поддерживаемый облачный идентификатор модели, который следует получить из облачного списка <code>/api/tags</code> <a href="#src-s1" rel="noopener noreferrer">s1</a><a href="#src-s3" rel="noopener noreferrer">s3</a><a href="#src-s6" rel="noopener noreferrer">s6</a>. Такой запрос использует облачную обработку и может расходовать лимит аккаунта; не запускайте его с реальными данными до проверки условий, а ключ не записывайте в shell history или код. Для OpenAI-совместимого SDK меняется base URL на <code>https://ollama.com/v1</code> и используется <strong>настоящий</strong> ключ, тогда как локальный пример SDK <code>api_key='ollama'</code> — лишь обязательная для клиента строка, игнорируемая сервером <a href="#src-s7" rel="noopener noreferrer">s7</a>.</p><p>Тестируйте разницу между режимами на контролируемом вводе, сверяя <strong>адрес</strong>, <strong>тег</strong> и <strong>ответ</strong>, а не один HTTP-код. Локальный вызов без ключа успешен не потому, что вы «авторизованы», а потому что локальный endpoint по документации не требует авторизации <a href="#src-s1" rel="noopener noreferrer">s1</a>. Неправильный или отсутствующий ключ к прямому cloud должен приводить к отказу, но точный код ошибки не следует обещать для каждой версии клиента. Если приложение требует ввести ключ для локальной Ollama, выясните, это ограничение поля в интерфейсе интеграции или оно действительно переключает запрос на облачный хост <a href="#src-s7" rel="noopener noreferrer">s7</a>.</p><h2>Что делать, если необходим строго локальный контур?</h2><p>Используйте загруженную локальную модель, проверьте <code>base URL</code> каждого клиента и отключите cloud-функции Ollama через <code>disable_ollama_cloud: true</code> в <code>~/.ollama/server.json</code> <strong>или</strong> <code>OLLAMA_NO_CLOUD=1</code>, затем перезапустите сервис. Документация сообщает, что после отключения в логах будет <code>Ollama cloud disabled: true</code>; при этом cloud-модели и web search недоступны <a href="#src-s4" rel="noopener noreferrer">s4</a>. Эта настройка не является доказательством отсутствия <strong>всех</strong> сетевых обращений приложений и ОС. Проведите отдельную проверку фактического исходящего трафика на тестовом вводе по <a href="/zhurnal/proverka-offline-kontura-ii/" rel="noopener noreferrer">методике Modelium</a>.</p><p><strong>Следующий шаг:</strong> откройте <a href="/zapusk/ollama/" rel="noopener noreferrer">гайд первого локального запуска Ollama</a>, получите список доступных моделей и ответ через <code>127.0.0.1:11434</code>. Только затем добавляйте свой клиент или ограниченный адаптер к данным, например <a href="/zhurnal/ollama-dlya-1s/" rel="noopener noreferrer">для тестовой 1С</a>. В журнале проверки сохраните адрес и тег модели, версию Ollama и факт ответа, но не секретный ключ.</p>