Быстрый старт для пользователей DeepSeek

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

Для использования нашего API направьте ваш клиент на https://api.deepseekapi.top/v1. Вам не нужно изменять пути эндпоинтов; стандартный /v1/chat/completions работает так, как ожидается. Аутентификация основана на одном API-ключе, сгенерированном при регистрации. Передайте этот ключ в заголовке Authorization в виде токена Bearer. Если ключ отсутствует или недействителен, сервер вернет ошибку 401. Убедитесь, что переменные среды настроены правильно перед отправкой первого запроса.

• Базовый URL: https://api.deepseekapi.top/v1
• Заголовок авторизации: Authorization: Bearer YOUR_API_KEY

Копироватьcurl https://api.deepseekapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Эндпоинт Chat Completions

Наш API принимает стандартные запросы на завершение чата. Отправьте запрос POST на /v1/chat/completions с идентификатором модели uncensored. Модель отвечает на текстовый ввод и генерирует текстовый вывод, не применяя фильтры контента, характерные для официального DeepSeek или других крупных провайдеров. Это идеально подходит для творческого письма, ролевых игр или обработки данных без ограничений. Вы можете управлять поведением с помощью параметров, таких как temperature и top_p. Ответ включает сгенерированный текст и статистику использования токенов.

Помните, что модель — это не GPT, Claude или модель другого вендора. Это независимая модель с открытыми весами, настроенная для неограниченного законного использования. Проверьте страницу тарифов для стоимости токенов.

Копироватьfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapi.top/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 SDK

Для разработчиков Node.js процесс идентичен стандартным интеграциям OpenAI. Инициализируйте клиент, указав ваш базовый URL и API-ключ. Установите модель на uncensored в вашей конфигурации. SDK управляет жизненным циклом запроса, включая повторные попытки и обработку ошибок, так же, как и для любого сервиса, совместимого с OpenAI. Это позволяет повторно использовать существующие кодовые базы с минимальными усилиями. Убедитесь, что вы используете последнюю версию пакета npm openai для полной совместимости.

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

Копироватьimport OpenAI from "openai";

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

Потоковые ответы

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

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

Копировать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-режим

API поддерживает вызов функций через параметры tools и tool_choice. Определите ваши функции в запросе, и модель вернет структурированные вызовы инструментов. Вы также можете обеспечить строгий вывод JSON, установив response_format в {"type": "json_object"}. Это полезно для генерации структурированных данных без ошибок парсинга. Модель настроена на надежное следование этим инструкциям.

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

Лимиты, ошибки и контекстное окно

Ваше контекстное окно составляет 100 000 токенов, объединяя промпт и завершение. Максимальный вывод — 32 000 токенов на запрос или 2 048, если вы не установили max_tokens. Лимиты запросов составляют 300 запросов в минуту и 8 параллельных запросов на ключ. Если вы превысите эти значения, вы получите ошибку 429. Ошибка 401 указывает на недействительный ключ, а ошибка 402 означает, что ваш предоплаченный баланс исчерпан. Ошибки и отказы не потребляют токены. Запросы ограничены телом размером 8 МБ. Зарегистрируйтесь через Google или email, чтобы получить ключ немедленно.