Ключ API для DeepSeek Harness

Ключ DeepSeek: где взять

Самый простой путь — ключ самой DeepSeek. Выдают его в кабинете разработчика platform.deepseek.com: регистрируетесь, создаёте ключ в разделе API keys и копируете. Платите по расходу токенов с баланса аккаунта; актуальные тарифы в официальном прайсе (цены в долларах, в таблице сейчас deepseek-flash и deepseek-v4-pro). Цифры я сюда нарочно не переношу: они меняются, а устаревшая цена на чужом сайте хуже, чем её отсутствие.

Про оплату из России в кабинете DeepSeek ничего определённого сказать не могу: доступные способы платформа показывает только при пополнении, а в публичной документации их нет. Если ваша карта не проходит, ниже есть обходные варианты.

Куда вставить ключ

1. Откройте Settings → Models В веб-интерфейсе DSH (как запустить) на странице моделей есть карточка DeepSeek с одним полем — для ключа.
2. Вставьте ключ и сохраните Ключ сразу начинает работать, перезапускать сервер не нужно. Хранится он в $DSH_HOME/.credentials.yaml, а настройки держат только ссылку на него; после сохранения страница показывает замаскированное значение, и прочитать ключ обратно через интерфейс нельзя.
3. Выберите модель Подключённые модели появляются в выборе модели у поля ввода. Выбранная становится моделью по умолчанию для новых сессий; у уже начатой сессии модель записана в её журнале и не меняется задним числом.

Ключ можно задать и без интерфейса, переменной окружения или в файле $DSH_HOME/.env: DSH ищет учётные данные в окружении процесса, в .credentials.yaml, в .env рабочей папки и в $DSH_HOME/.env, именно в таком порядке. Это удобно для режима headless на сервере.

Другие провайдеры

На той же странице моделей есть две кнопки. Add provider — встроенные провайдеры из каталога pi-ai: в списке видны идентификаторы вроде anthropic, openai, moonshotai (Kimi), zai (GLM). Вводите ключ, а endpoint, протокол и список моделей подставятся из каталога. Провайдеры со входом через OAuth, например Codex, пока не поддерживаются.

Add a custom provider — для шлюза компании, своего сервера или сервиса, которого нет в каталоге. Нужно заполнить:

• Provider ID — строчными буквами; после создания его нельзя переименовать (на него ссылаются сессии, настройки и ключи), только удалить и создать новый;
• base URL — адрес API;
• API protocol — какой протокол говорит endpoint: openai-completions (OpenAI Chat Completions — самый распространённый), openai-responses (OpenAI Responses API) или anthropic-messages. Один провайдер — один протокол; шлюзу с двумя протоколами нужны две записи;
• ключ — у OpenAI-совместимых endpoint'ов он обязателен, даже если сервер его не проверяет;
• хотя бы одна модель — кнопка Fetch available models в разделе Model catalog спрашивает у endpoint'а список (GET /models) и открывает выбор; если endpoint отвечает в незнакомом формате, идентификаторы моделей вписываются вручную и работают так же.

Если ключ и адрес верные, а запросы всё равно отлетают с ошибкой, дело обычно в форме запроса: pi-ai шлёт системный промпт reasoning-моделей с ролью developer и лимит ответа в поле max_completion_tokens, а многие шлюзы понимают только system и max_tokens. Это правится в $DSH_HOME/settings.yaml у нужного провайдера:

llm-pi-ai:
  providers:
    my-gateway:
      compat:
        supportsDeveloperRole: false
        maxTokensField: max_tokens

Остальные тонкости — модели с картинками, уровни reasoning, формат thinking у DeepSeek за чужим шлюзом — в оригинале руководства Configure models (англ.).

Оплата из России

Напрямую у OpenAI и Anthropic не выйдет: российские карты они не принимают, а часть сервисов ещё и закрыта по региону. Рабочие варианты, от простого к сложному:

1. Посредник с оплатой в рублях. Сервис перепродаёт доступ к моделям и отдаёт OpenAI-совместимый endpoint. Я пользуюсь Aprium: там оплата в рублях картами Мир, Visa и Mastercard, списание за фактический расход и без VPN. Через один ключ доступны Claude, GPT и Gemini, так что менять модель можно одной строкой в конфиге. В DSH такой сервис подключается как custom provider: протокол openai-completions, base URL https://api.aprium.ru/v1, ключ из кабинета (раздел «Аккаунт → Ключи»), модели — через Fetch available models. Одно но: запросы идут через посредника, и чувствительный код я бы туда не отправлял, для него есть локальная модель.
2. Кабинет DeepSeek. Если доступный там способ оплаты вам подходит, это прямой путь без наценки посредника.
3. Локальная модель. Бесплатно и без интернета, но нужен компьютер с большим объёмом памяти и модель, умеющая вызывать инструменты. Разбор — LM Studio и Ollama.

Если провайдер доступен только через прокси, задайте HTTPS_PROXY и HTTP_PROXY в окружении или в $DSH_HOME/.env: DSH читает их при запуске и пускает через прокси запросы к моделям, веб-поиск и MCP по HTTP. Системные настройки прокси и «системный прокси» в Clash он не смотрит, только переменные или TUN-режим. Подробно — в руководстве по прокси (англ.).

Дальше

• Локальные модели LM Studio и Ollama как custom provider: адреса, ключ-заглушка, оговорки.
• Установка Если DSH ещё не запущен: Node.js и одна команда.
• Плагины: модели и провайдеры Категория каталога — адаптеры к другим API, балансировщики, счётчики расхода.
• Вопросы и ответы Бесплатно ли, сколько стоит, что значит developer preview.