RU ▾
Получить API-ключ

deepseek4api.comГид

Обзор документации API DeepSeek и готовая замена

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

Обновлено

Два соединяющихся коннектора со светящимися блоками кода, демонстрирующие замену API
Две стопки монет разной высоты, подающие питание на небольшой сервер, демонстрируют ценообразование на входные и выходные токены

Ключевые моменты

  • DeepSeek предоставляет API в стиле OpenAI, поэтому SDK OpenAI работает после изменения базового URL, ключа и имени модели.
  • Этот сайт не является официальным API DeepSeek; он предоставляет одну независимую модель с открытыми весами под идентификатором uncensored.
  • Один и тот же код работает на обоих: меняются только три значения.
  • Контекстное окно здесь составляет 100 000 токенов, поддерживаются потоковая передача, инструменты и JSON-режим.

Пять вопросов, на которые отвечает документация API DeepSeek

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

ВопросДокументация DeepSeekЭтот API
Базовый URLОписано в их быстром старте (api.deepseek.com)https://api.deepseek4api.com/v1
АутентификацияBearer-токен в заголовке AuthorizationBearer-токен в заголовке Authorization
Имя моделиУказано в документации к моделям; проверьте актуальные именаuncensored
Основной эндпоинтЗавершение диалогаChat completions, Responses, список моделей
ЦеныПроверьте их текущие тарифы$0,15 за 1 млн входных токенов, $0,50 за 1 млн выходных токенов

Читайте собственные страницы DeepSeek для получения информации об их моделях, ценах и лимитах; они меняются, и эта статья не пытается их пересказать. Суть в том, что форма запроса общая, поэтому переход между ними — это изменение конфигурации.

Один важный момент: этот сайт не является официальным API DeepSeek, и это не маршрутизатор к DeepSeek. Это хостинговый эндпоинт, совместимый с OpenAI, предоставляющий одну модель с открытыми весами от независимого провайдера, настроенную на ответы без отказов по контенту для законного использования взрослыми.

Шаг 1: аутентификация и базовый URL

Создайте аккаунт (через Google или по email и паролю) и откройте страницу API-ключа. Скопируйте ключ. Новые пользователи также могут одним кликом получить $0,50 пробного баланса, действительного в течение 7 дней и не требующего привязки карты.

Каждый запрос содержит заголовок Authorization: Bearer YOUR_KEY. С помощью curl:

curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Этот запрос возвращает доступную модель uncensored. Если вы копируете пример из DeepSeek, замените три вещи: базовый URL, ключ и имя модели. Ничего больше менять не нужно.

Шаг 2: завершение чата в Python

SDK OpenAI используется в примерах документации DeepSeek, и он работает здесь без изменений:

from 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": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain idempotency in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Передаются поддерживаемые параметры сэмплирования, включая temperature, top_p, stop, seed, а также штрафы за присутствие и частоту. max_tokens необязателен, так как ответ может использовать всё, что осталось от контекстного окна на 100 000 токенов.

Шаг 3: потоковая передача, JSON-режим и инструменты

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

Установите stream: true для получения событий, отправляемых сервером. Использование указывается в конце потока.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseek4api.com/v1",
  apiKey: process.env.API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about caching." }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

JSON-режим

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

Вызов функций

Параметры tools и tool_choice работают в формате OpenAI, вызовы инструментов передаются в виде дельт, а результаты возвращаются как сообщения с role: "tool". Если ваш код уже выполняет вызов функций для DeepSeek, его можно перенести с изменением трех значений выше, но протестируйте свои собственные схемы.

Где они различаются

Один и тот же протокол не означает одну и ту же службу. Проверьте следующее при переносе рабочей нагрузки:

  • Поведение модели. Другая модель дает другие ответы, стиль рассуждений и поведение при отказе. Запустите набор промптов еще раз перед переключением чего-либо в продакшене.
  • Поля, специфичные для рассуждений. Если вы зависите от полей ответа, специфичных для вендора, от конкретной модели DeepSeek, не предполагайте, что они есть здесь. Стандартные поля завершения чата есть.
  • Недоступные функции. Этот API работает только с текстом: нет изображений, аудио, видео, эмбеддингов или дообучения.
  • Лимиты. Полный ключ позволяет 8 параллельных запросов и 300 в минуту; пробный ключ позволяет 2 и 60. При превышении лимита вы получите HTTP 429 с rate_limited или concurrency.
  • Баланс. Проверьте кредит с помощью GET /v1/balance, маршрута кредитов в стиле OpenAI или заголовка X-Balance-USD в каждом ответе.

Чтобы взглянуть на то, как пользователь, ориентированный на DeepSeek, думает о стоимости, см. заметки о ценах DeepSeek; для настроек редактора — руководство VS Code.

Сколько стоит запрос здесь

Оплата предоплаченная, по токенам: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Запрос с 1 500 входными токенами и 600 выходными токенами стоит 1 500 × $0,15 / 1 млн = $0,000225 за входные данные плюс 600 × $0,50 / 1 млн = $0,0003 за выходные данные, итого $0,000525. Пополнение на $20 покрывает около 38 000 таких запросов.

Пополнения принимаются на любую целую сумму от $20 до $500, с бонусом +5% от $50, +10% от $100 и +15% от $200. Вы можете оплатить криптовалютой (USDT на TRC20, USDC на Base). Баланс не сгорает, а неудачные или отклоненные запросы не оплачиваются. Подробности на странице ценообразования.

Чек-лист миграции

Если вы переносите приложение, которое уже работает с DeepSeek, пройдите по этим шагам в указанном порядке. Каждый шаг занимает несколько минут.

  1. Внесите три значения в конфигурацию. Базовый URL, ключ и имя модели должны поступать из переменных окружения, а не быть захардкоженными в коде.
  2. Проведите дымовое тестирование. Один обычный запрос к чату, один потоковый запрос, один вызов в JSON-режиме и один вызов инструмента. Четыре приведенных выше фрагмента кода покрывают их.
  3. Воспроизведите реальные промпты. Возьмите 30 промптов из ваших логов и сравните ответы бок о бок. Оценивайте их по своим критериям, а не по общему баллу.
  4. Обработайте 429. Добавьте повторную попытку с экспоненциальной задержкой и учитывайте заголовок Retry-After. Потоковый запрос удерживает слот параллельности до конца потока, поэтому закрывайте брошенные потоки.
  5. Следите за стоимостью. Логируйте usage из каждого ответа и сравнивайте его с заголовком X-Balance-USD за день трафика.
  6. Выкатывайте постепенно. Сначала отправьте 5–10 процентов трафика на новый эндпоинт, затем увеличивайте объем.

Сравнивайте стоимость задачи, а не цену за токен, так как разные модели используют разное количество токенов для одной и той же работы. Для открытой проверки того, как ведут себя модели для написания текстов с мягкими ограничениями, статья о ролевой игре является полезным дополнением.

Выбор между ними

Используйте собственный API DeepSeek, когда вам конкретно нужна модель DeepSeek, её проприетарные функции или официальная поддержка. Используйте этот эндпоинт, когда вам нужна размещённая OpenAI-совместимая модель, которая отвечает без отказов по контенту для законного использования совершеннолетними, с простой предоплаченной оплатой и промптами, которые не используются для обучения. Многим командам понадобятся оба варианта за переключателем конфигурации, что упрощается благодаря общему протоколу. Справочные материалы по этому API находятся в документации.

Вопросы и ответы

Это официальный API DeepSeek?

Нет. Это независимый OpenAI-совместимый эндпоинт, обслуживающий одну модель с открытыми весами под идентификатором uncensored. Это не сервис DeepSeek, и он не маршрутизирует запросы к нему.

Могу ли я переиспользовать свой код DeepSeek?

Если он использует SDK OpenAI или формат завершения чата, обычно да. Измените базовый URL, ключ и имя модели, затем протестируйте свои промпты.

Где найти имя модели?

Вызовите GET /v1/models. Этот API обслуживает единственную модель с идентификатором uncensored.

Какой размер контекстного окна?

100 000 токенов для промпта и завершения.

Bearer-токен в заголовке Authorization

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.