Документация API для разработчиков

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

Начните с изменения базового URL на наш выделенный эндпоинт и передачи вашего API-ключа в заголовке Authorization. Мы не используем стандартный базовый URL OpenAI; вы должны указать ваш SDK на https://api.deepseektokenplan.com/v1. Это гарантирует, что ваши запросы обрабатываются через нашу инфраструктуру uncensored-моделей, а не через сторонний прокси. Идентификатор модели, указанный в теле запроса, — "uncensored", что активирует специфические настроенные веса на наших серверах. Аутентификация основана на простой схеме Bearer-токена, совместимой с любой библиотекой клиентов, совместимой с OpenAI. Ваш ключ генерируется мгновенно при регистрации через Google или email, без необходимости указания номера телефона. Храните этот ключ в безопасности, так как он напрямую связан с балансом предоплаченных средств.

Первый запрос

Отправьте стандартный запрос chat completions с помощью cURL для проверки вашей настройки и доступности модели. Этот простой POST-запрос демонстрирует, как API принимает системный запрос и сообщение пользователя. Вы можете настроить параметры temperature и top_p для управления креативностью. В ответе возвращается сгенерированный текст вместе со статистикой использования токенов для прозрачности биллинга. Убедитесь, что тело запроса содержит правильный идентификатор модели и ваш API-ключ в заголовке. Этот метод работает как для генерации текста, так и для вызова функций. Используйте эту команду для подтверждения подключения перед интеграцией в ваше приложение. Конечная точка одинаково хорошо поддерживает потоковый и непотоковый режимы.

Интеграция Python SDK

Используйте официальную библиотеку OpenAI для Python для взаимодействия с нашим API, настроив базовый URL и API-ключ. Инициализируйте клиента с вашими учетными данными и вызовите метод завершения чата с желаемым идентификатором модели. Этот подход позволяет использовать существующие кодовые базы, созданные для OpenAI, без значительной рефакторизации. Вы можете потоково передавать ответы или получать полный текст сразу. Библиотека автоматически обрабатывает сериализацию JSON и HTTP-запросы. Настройте параметры таймаута и повторных попыток в соответствии с вашим конкретным случаем использования. Этот метод идеален для бэкенд-сервисов и конвейеров обработки данных. Убедитесь, что вы обновили базовый URL, чтобы он указывал на наш конкретный эндпоинт.

Интеграция Node SDK

Интегрируйте API в ваши приложения JavaScript или TypeScript с помощью пакета OpenAI Node. Установите base URL и API-ключ в конфигурации клиента перед выполнением любых запросов. Эта настройка позволяет использовать знакомые методы, такие как chat.completions.create() с нашей uncensored-моделью. Вы можете передавать параметры, такие как temperature и последовательности остановки, для тонкой настройки вывода. SDK эффективно обрабатывает потоковые ответы для приложений реального времени. Используйте этот подход для веб-серверов или инструментов командной строки. Убедитесь, что вы импортировали необходимые модули и правильно настроили переменные окружения. Этот метод поддерживает как синхронные, так и асинхронные шаблоны запросов.

Потоковая передача и токены

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

Лимиты и обработка ошибок

Отслеживайте лимиты скорости и обрабатывайте ошибки gracefully, чтобы обеспечить стабильное соединение. API позволяет 300 запросов в минуту на ключ и 8 одновременных запросов. Тело каждого запроса не должно превышать 8 МБ. Если вы отправите недействительный ключ, вы получите ошибку 401 Unauthorized. Ошибка 402 указывает на недостаточность предоплаченных кредитов, требуя пополнения через крипто. Ошибка 429 означает превышение лимита скорости; подождите и повторите попытку. Контекстное окно составляет 100,000 токенов для промпта и завершения вместе. Максимальный вывод составляет 16,000 токенов, если вы не укажете меньшее max_tokens значение. Всегда проверяйте код состояния и тело ответа на наличие подробных сообщений об ошибках.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Потоковая передача

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)