API-ключ DeepSeek в VS Code: настройка с нашим API

Краткая версия

Вы спросили, как использовать API-ключ deepseek в vscode, и ответ состоит из двух частей. Во-первых, сам VS Code не принимает API-ключ для языковой модели; это делает расширение. Во-вторых, ключ с этого сайта не является ключом DeepSeek. Он принадлежит независимому API, совместимому с OpenAI, который запускает одну модель с открытыми весами, настроенную на ответы без отказов по контенту для законного использования взрослыми, и это не официальный API DeepSeek. Если у вас есть ключ с собственной платформы DeepSeek, введите его с эндпоинтом DeepSeek.

Для этого API каждое расширение требует тех же трех значений:

• Базовый URL: https://api.deepseekapikey.com/v1
• API-ключ: ключ из вашего аккаунта, отправляемый как токен Bearer
• Модель: uncensored

Разделы ниже показывают, куда вставить эти значения в Continue и расширениях семейства Cline, а также как проверить работоспособность и контролировать расходы.

Перед началом: получите ключ и проверьте его

Зарегистрируйтесь на странице API-ключей с помощью Google или электронной почты и пароля. Новые пользователи могут получить $0,50 пробного баланса в один клик, действительного в течение 7 дней, один на человека, без привязки карты. Платные пополнения начинаются с $20.

Откройте встроенный терминал в VS Code (Ctrl+` или Cmd+`) и выполните запрос. Если это сработает, любая последующая ошибка связана с настройками расширения, а не с проблемой ключа.

Copyexport API_KEY="paste-your-key-here"

curl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}],
    "max_tokens": 200
  }'

Ответ в формате JSON с массивом choices означает, что ключ, URL и имя модели верны. 401 означает неверный ключ. 404 обычно означает неверный путь. Вы также можете вызвать GET /v1/models с тем же заголовком для дешевой проверки.

Вариант 1: расширение Continue

Continue — это расширение-ассистент с открытым исходным кодом для VS Code, которое позволяет определять свои собственные модели. Установите его из вида расширений, откройте его настройки и добавьте модель, использующую провайдер OpenAI с пользовательским базовым URL. Continue со временем менял формат конфигурации: с JSON-файла на YAML-файл, поэтому проверьте текущую документацию расширения, если ваш файл выглядит иначе. Поля имеют одинаковое значение в обоих форматах. В JSON-формате запись модели выглядит так:

Copy{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.deepseekapikey.com/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

В YAML-формате запись модели содержит те же ключи: имя, provider: openai, model: uncensored, apiBase, установленный в базовый URL, и ключ. Сохраните файл, выберите новую модель в выпадающем списке моделей Continue и задайте вопрос в боковой панели.

Обратите внимание, что в этом API описаны только chat completions. Чат, редактирование и объяснение — это естественные сценарии. Автозаполнение по Tab внутри строки обычно использует другой стиль запроса, предназначенный для завершения текста в середине строки. Это не входит в возможности данного API, поэтому не рассчитывайте, что оно будет работать. Если вам это нужно, оставьте отдельного провайдера автозаполнения.

Ключ находится в файле, поэтому держите этот файл вне вашего репозитория. Если вы используете конфигурацию на уровне рабочего пространства, добавьте ее в .gitignore или используйте глобальную конфигурацию в домашнем каталоге.

Вариант 2: Cline и аналогичные расширения агентов

Cline и расширения на его основе, такие как Roo Code, запускают агента, который читает файлы, предлагает изменения и выполняет команды с вашего одобрения. В панели настроек есть выпадающий список провайдеров API. Выберите запись для провайдера, совместимого с OpenAI, и заполните форму:

1. Базовый URL: https://api.deepseekapikey.com/v1
2. API-ключ: ваш ключ
3. Идентификатор модели: uncensored

Некоторые версии запрашивают размер контекстного окна и максимальное значение вывода для пользовательской модели. Введите 100000 для окна, так как это размер контекста данного API: промпт и ответ вместе. Укажите максимальный вывод в несколько тысяч токенов, чтобы один ответ не уходил в бесконечность.

Агенты используют вызов функций или структурированный текстовый формат для действий, и API поддерживает формат вызова функций OpenAI (tools, tool_choice, результаты role: "tool") вместе с потоковой передачей. Насколько хорошо любая модель следует инструкциям агента, варьируется, поэтому начните с небольших задач, таких как переименование функции в двух файлах, и наблюдайте за первыми несколькими шагами, прежде чем позволить ему работать дольше.

Агенты также отправляют много запросов подряд. Полный ключ позволяет 8 одновременных запросов и 300 в минуту, пробный ключ — 2 и 60. Один агент обычно укладывается в эти числа, но два агента плюс панель чата на пробном ключе могут достичь предела параллельных запросов и выдать ошибки 429.

Вызов API из вашего кода в VS Code

Иногда цель — не расширение, а скрипт, который вы запускаете из редактора. Любой SDK OpenAI подойдет. В Node:

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseekapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Review this function for off-by-one errors." }],
});
console.log(res.choices[0].message.content);

Храните ключ в переменной среды, файле .env, который игнорируется git, или в хранилище секретов вашей операционной системы, никогда не в зафиксированном файле. Версия Python того же вызова использует OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key=...). В быстром старте есть больше примеров, включая потоковую передачу и JSON-режим.

Стоимость сессий кодирования

Цена составляет $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов. Ассистенты для программирования передают много контекста, поэтому входные данные преобладают. Возьмите запрос с 30 000 токенов кода и истории чата и ответом на 1 000 токенов:

• Ввод: 30 000 / 1 000 000 x $0,15 = $0,0045
• Вывод: 1 000 / 1 000 000 x $0,50 = $0,0005
• Итого: $0,005 за запрос, поэтому 200 запросов стоят $1,00.

Полный промпт на 100 000 токенов с тем же ответом стоит $0,015 + $0,0005 = $0,0155. Это все еще небольшая сумма, но циклы агентов повторяют это много раз, поэтому держите контекст плотным: открывайте только нужные файлы, а не весь репозиторий, и начинайте новый чат, когда задача меняется.

Кредиты предоплачены и не сгорают, подписки нет. Неудачные или отклоненные запросы не оплачиваются. Пополняйте на любую целую сумму от $20 до $500, с +5% от $50, +10% от $100 и +15% от $200, оплачивая криптовалютой (USDT на TRC20, USDC на Base). Пополнение на $50 зачисляет $52,50. Подробности см. на странице цен.

Чек-лист устранения неполадок

• 401 Unauthorized. Ключ неверен или имеет пробелы в конце. Помните, что ключ, выданный собственной платформой DeepSeek, здесь не сработает.
• 404 Not Found. Проверьте базовый URL. Некоторые расширения самостоятельно добавляют /chat/completions, поэтому указывайте им базовый URL, заканчивающийся на /v1. Другие требуют полный путь. Следуйте подсказке в поле.
• Модель не найдена. ID модели должен быть точно uncensored.
• 429 с кодом concurrency. Слишком много запросов одновременно. Закройте лишние чаты или агентов. Потоковые запросы занимают слот до завершения.
• 429 с Retry-After: 5. Временная перегрузка. Подождите пять секунд, и повторная попытка расширения обычно проходит успешно.
• Запрос слишком большой. Лимит размера тела запроса — 8 МБ, а лимит контекста — 100 000 токенов. Уменьшите прикрепленные файлы.

Промпты не используются для обучения, но ваше расширение может вести свои собственные журналы и телеметрию, поэтому проверьте его настройки, если вы работаете с приватным кодом. Сервис предназначен для законного использования взрослыми и имеет строгое правило против сексуального контента с участием несовершеннолетних. Он генерирует только текст, поэтому код — это нормально, а изображения — нет. Если вам нужна предыстория о том, чем этот сервис отличается от собственного DeepSeek, статья на мифах и фактах охватывает это.

Дополнительные руководства

• API-ключ DeepSeek в Janitor AI: настройка с нашим API
• Ключ API DeepSeek в SillyTavern: подключение нашего API
• DeepSeek API: мифы и факты для доступа без цензуры