API DeepSeek V4: первый запрос за пять минут

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

Наш API использует стандартную аутентификацию по API-ключу. Вы можете мгновенно сгенерировать ключ на странице Получить API-ключ, введя свой адрес электронной почты и пароль. Для пробного периода не требуется банковская карта; он включает $0,50 действительного баланса на 7 дней. Получив ключ, настройте клиент на использование нашего базового URL: https://api.deepseek4api.com/v1.

Установите заголовок Authorization в значение Bearer YOUR_API_KEY. Этот базовый URL работает с любым SDK, совместимым с OpenAI. Идентификатор модели, который вы должны указать в запросах, — uncensored. Это гарантирует, что вы взаимодействуете с нашей моделью с открытыми весами, настроенной на неограниченные ответы, а не с вариантом от конкретного поставщика.

Базовое завершение чата

Отправьте стандартный запрос на завершение чата для генерации текста. API принимает список сообщений, содержащих поля role и content. Ниже приведен базовый пример cURL, демонстрирующий простой текстовый запрос. Это работает для любого клиента, совместимого с OpenAI, путем изменения базового URL и идентификатора модели.

Copycurl https://api.deepseek4api.com/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."}]
  }'

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

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

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

Copyfrom openai import OpenAI

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

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

Использование Node SDK

Для приложений на Node.js используйте пакет openai npm. Инициализируйте клиент, указав baseURL на наш сервис, и предоставьте API-ключ. Идентификатор модели остаётся uncensored.

Copyimport OpenAI from "openai";

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

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

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

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

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)

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

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

API устанавливает контекстное окно на 100 000 токенов для промпта и ответа модели вместе. Тела запросов не должны превышать 8 МБ. Лимит составляет 300 запросов в минуту на API-ключ. При превышении лимита вы получите ошибку лимита запросов 429.

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