Руководство по интеграции: ключ API deepseek coder

Базовый URL и аутентификация

Ваш API-ключ аутентифицирует каждый запрос. Установите базовый URL на https://api.deepseekcoderapikey.com/v1 в конфигурации вашего клиента. Этот URL обрабатывает как endpoint завершения чата, так и endpoint моделей без необходимости дополнительных сегментов пути. Вы получаете один ключ на аккаунт, и генерация нового немедленно заменяет предыдущий ключ.

Сохраните ключ в переменной окружения с именем DEEPSEEK_API_KEY или передать его напрямую клиенту вашего SDK. Эндпоинт принимает стандартные заголовки, поэтому вы можете сменить провайдера, изменив только базовый URL и значение ключа. Этот подход работает с Cursor, расширениями VS Code и локальными инструментами разработки, ожидающими интерфейс, совместимый с OpenAI.

Аутентификация завершается неудачей со статусом 401, если ключ отсутствует или недействителен. Используйте

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

пример, чтобы проверить подключение перед интеграцией в логику вашего приложения.

Эндпоинт Chat Completions (POST)

Отправляйте сообщения в POST /v1/chat/completions эндпоинт с использованием идентификатора модели uncensored. Этот эндпоинт обрабатывает текстовый ввод и возвращает текстовый вывод, поддерживая как синхронные, так и потоковые ответы. Вы можете настроить поведение модели с помощью параметров, таких как temperature, top_p и последовательности остановки.

Окно контекста поддерживает до 100 000 токенов для промпта и завершения в сумме. Если вы не укажете лимит max_tokens, модель по умолчанию использует 2 048 токенов на запрос. Используйте

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

фрагмент кода демонстрирует, как структурировать стандартный запрос чата с официальным Python SDK от OpenAI.

Ошибки, такие как недостаток средств, возвращают код состояния 402, а некорректные запросы — 400. Проверьте тело ответа для получения подробных сообщений об ошибках, чтобы быстро отладить структуру полезной нагрузки.

Эндпоинт Модели (GET)

Запрос доступных моделей, отправив GET /v1/models запрос. Эта конечная точка возвращает список объектов моделей, включая uncensored идентификатор модели. Вы можете использовать этот эндпоинт, чтобы убедиться, что ваш API-ключ действителен и сервис работает онлайн, перед тем как делать запросы с высокой нагрузкой.

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

Интеграция этой проверки в последовательность запуска гарантирует, что ваше приложение быстро завершит работу с ошибкой, если API недоступен. Это также помогает убедиться, что базовый URL настроен правильно, прежде чем переходить к фактическим запросам на завершение чата.

Потоковые ответы (SSE)

Включите потоковую передачу, установив stream параметр в true в вашем запросе. API возвращает поток Server-Sent Events (SSE), доставляя токены по мере их генерации. Этот подход снижает воспринимаемую задержку для помощников по написанию кода и позволяет обновлять интерфейс в реальном времени в вашем приложении.

Каждый чанк содержит частичное содержимое, а последний чанк включает статистику общего использования токенов. Тщательно анализируйте поток SSE, чтобы обрабатывать сетевые сбои и буферизовать частичные токены. The

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

пример демонстрирует, как обрабатывать поток в JavaScript.

Потоковая передача идеально подходит для генерации длинного кода или подробных объяснений. Она обеспечивает более плавный пользовательский опыт по сравнению с ожиданием всего ответа. Убедитесь, что ваш клиент корректно обрабатывает событие завершения потока, чтобы завершить ответ.

Function Calling и режим JSON

Используйте вызов функций, чтобы модель могла вызывать внешние инструменты. Определите свои функции в tools parameter и укажите tool_choice для управления тем, когда модель использует их. API поддерживает стандартные определения инструментов, позволяя интегрировать их с вашими собственными бэкенд-сервисами.

Для структурированных выводов включите режим JSON, установив response_format для json_object. Это заставляет модель возвращать валидный JSON, что полезно для парсинга конфигурационных данных или ответов API.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

фрагмент кода показывает, как настроить JSON-режим в Node.js.

Сочетайте вызов функций с потоковой передачей для интерактивного использования инструментов. Модель может вызывать несколько инструментов за один ход, что позволяет создавать сложные многошаговые рабочие процессы. Убедитесь, что ваш клиент корректно обрабатывает вывод инструментов, чтобы поддерживать контекст разговора.

Лимиты запросов и ограничения

Ваш API-ключ ограничен 300 запросами в минуту и 8 одновременными запросами. Максимальный размер тела запроса составляет 8 МБ. Если вы превысите эти лимиты, API вернет ошибку 429 Too Many Requests. Реализуйте экспоненциальное замедление в клиенте для graceful обработки лимитов частоты запросов.

Ошибки, такие как 401, указывают на неверный ключ, а 402 сигнализирует о недостатке кредитов. Возврат средств за кредиты не производится, но двойные списания можно решить через страницу поддержки. Кредиты не имеют срока действия, поэтому вы можете пополнить счет в удобное время.

Контекстное окно на 100,000 токенов применяется к общему промпту и завершению. Отслеживайте использование токенов, чтобы оставаться в рамках бюджета. Используйте систему предоплаченных кредитов, чтобы платить только за то, что вы используете, без ежемесячных платежей или подписок.