Аутентификация и установка базового URL
Ваш API-ключ аутентифицирует каждый запрос к нашим серверам. Просто зарегистрируйтесь через Google или адрес электронной почты и скопируйте ключ из панели управления. Вставьте его в переменную окружения как DEEPSEEK_API_KEY и направьте ваш клиент на https://api.keyapideepseek.com/v1. Этот базовый URL работает с любой стандартной библиотекой, совместимой с OpenAI.
curl https://api.keyapideepseek.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
}'Вы можете проверить настройку, запросив список доступных моделей. Ответ подтверждает, что ваш ключ действителен и активен. Этот шаг гарантирует, что ваша интеграция указывает на правильный эндпоинт без фильтрации перед отправкой промптов.
Эндпоинт Chat Completions
The POST /v1/chat/completions эндпоинт принимает ваш запрос и возвращает ответ модели. Вы отправляете JSON-тело, содержащее сообщения, системные инструкции и параметры, такие как temperature. Идентификатор модели всегда uncensored. Эта единственная модель обрабатывает все ваши потребности в генерации текста без сложности маршрутизации.
from openai import OpenAI
client = OpenAI(base_url="https://api.keyapideepseek.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)SDK Python автоматически обрабатывает HTTP-запросы. Вы передаете свой ключ и базовый URL в конструктор клиента. Остальной код зеркально отражает стандартные шаблоны OpenAI. Это гарантирует, что вы сможете сменить вендора позже, не переписывая всю логику приложения.
Потоковые ответы и использование токенов
Включите потоковую передачу, установив stream: true в вашем запросе. API возвращает поток фрагментов Server-Sent Events (SSE). Каждый фрагмент содержит частичный текст и статистику использования. Последний фрагмент включает общее количество токенов для запроса.
stream = 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)Потоковая передача снижает воспринимаемую задержку для пользователей. Вы можете отображать токены по мере их поступления. Это критически важно для генерации длинных текстов или интерактивных интерфейсов чата. Отслеживайте использование токенов в последнем фрагменте, чтобы точно контролировать расход предоплаченного кредита.
Режим JSON и вызов функций
Включайте структурированный вывод, установив response_format для {"type": "json_object"}. Модель возвращает валидный JSON вместо текста в свободной форме. Это идеально для интеграций API или задач извлечения данных. Вы также можете определить определения функций в промпте для использования инструментов.
Модель поддерживает tool_choice параметры. Вы можете принудительно задать конкретные функции или позволить модели принять решение. Эта гибкость позволяет создавать сложных агентов. Убедитесь, что схемы ваших функций строго типизированы, чтобы избежать ошибок разбора в коде клиента.
Лимиты запросов и параллелизм
Каждый API-ключ ограничен 300 запросами в минуту. Одновременно может быть активно до 8 запросов. Максимальный размер тела запроса составляет 8 МБ. Эти ограничения предотвращают злоупотребления и обеспечивают стабильную производительность для всех пользователей. При их превышении возвращается ошибка 429.
Реализуйте экспоненциальное замедление в коде клиента. Повторяйте неудачные запросы после короткой задержки. Это gracefully обрабатывает временные сетевые проблемы. Ваш предоплаченный кредит списывается только за успешные завершения, а не за повторные попытки из-за ограничения скорости.
Обработка ошибок и отказы
Ошибка 401 означает, что ваш ключ недействителен или истек. Ошибка 402 указывает на недостаточный предоплаченный баланс. Ошибка 429 сигнализирует о достижении лимита скорости. Модель отказывается от запросов, содержащих сексуальный контент с участием несовершеннолетних. Весь остальной законный контент для взрослых разрешен.
Проверьте тело ответа об ошибке для получения подробных сообщений. Логируйте эти ошибки для отладки проблем интеграции. Ваши кредиты не списываются за неудачные запросы. Эта прозрачная модель биллинга помогает точно прогнозировать расходы без скрытых комиссий.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.keyapideepseek.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);