Как to Integrate the DeepSeek API

Предварительные требования: Настройка окружения

Начните с обеспечения того, чтобы в вашей среде разработки была установлена необходимая SDK. Вам нужен языковой рантайм, такой как Python или Node.js, и способ безопасного хранения учетных данных API. Эта настройка идентична использованию любого другого OpenAI-compatible сервиса.

Вам не нужно устанавливать драйверы, специфичные для вендора. Прокси обрабатывает все инференсы моделей, поэтому вашей машине нужно только отправлять HTTP-запросы и парсить JSON-ответы. Это снижает накладные расходы на зависимости и делает ваш проект лёгким.

Установка официального SDK

Установите официальный SDK для предпочитаемого языка для обработки аутентификации и сериализации. Для Python используйте pip install openai. Для Node.js выполните npm install openai.Эта библиотека управляет базовыми HTTP-соединениями.

SDK абстрагирует сложность формирования JSON-запросов. Вы можете сосредоточиться на определении промпта и обработке возвращаемых токенов. Эта стандартизация позволяет сменить провайдера в будущем, изменив только базовый URL.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekpago.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)

Настройка базового URL и ключа

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

Передайте ваш ключ через api_key параметр. Этот ключ генерируется при регистрации на сайте. Он аутентифицирует ваши запросы и отслеживает использование предоплаченного кредита. Без этой конфигурации ваши запросы завершатся ошибкой 404 или 401.

Выполнение первого запроса

Отправьте простое завершение текста, чтобы проверить подключение и поведение модели. Используйте идентификатор модели uncensored для доступа к конкретной модели, работающей на прокси. Эта модель настроена на ответы без отказов в контенте для законного взрослого использования.

Тело запроса включает messages массив и model identifier. The response contains the generated text in the content поле. Это подтверждает, что ваша интеграция корректно работает с uncensored моделью.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

Включение потоковой передачи ответов

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

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

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)

Использование Tools и Function Calling

Определите инструменты в теле запроса, чтобы позволить модели генерировать структурированные выводы. Передайте список определений функций в tools параметр. Модель вернет вызов функции вместо обычного текста, когда это уместно.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekpago.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

Принудительно заставляйте модель возвращать корректный JSON, установив response_format для {"type": "json_object"}. Это полезно для разбора данных в вашем приложении. Это снижает необходимость в постобработке с помощью регулярных выражений.

Модель строго соблюдает это ограничение. Если вывод не является валидным JSON, запрос может завершиться ошибкой. Это обеспечивает надёжность вашего конвейера при интеграции с автоматизированными системами. Вы также можете задать temperature и top_p для управления креативностью.

Обработка ошибок и ограничений частоты запросов

API ограничивает количество запросов до 300 в минуту на ключ. Если вы превысите этот лимит, получите ошибку 429. Вы также можете выполнять до 8 одновременных запросов на ключ. Соблюдайте эти лимиты, чтобы избежать прерывания сервиса.

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

Мониторинг использования токенов

Отслеживайте использование предоплаченных средств, контролируя количество токенов. Последний фрагмент в потоковом ответе содержит usage объект. Это показывает подсчеты входных и выходных токенов.

Цены составляют $0.15 за 1M входных токенов и $0.50 за 1M выходных токенов. Ошибки бесплатны. Вы можете рассчитать расходы локально, умножив количество токенов на эти ставки. Это помогает точно планировать пополнение крипто-счета.