getdeepseekapi.comДокументация
API DeepSeek: первый запрос за пять минут
Получите первый ответ за пять минут, указав в вашем клиенте, совместимом с OpenAI, наш базовый URL и аутентифицировавшись с помощью ключа, созданного при регистрации.
Базовый URL и аутентификация
Наш API следует стандартному интерфейсу OpenAI, поэтому вам нужно изменить только два значения в конфигурации клиента. Установите базовый URL в https://api.getdeepseekapi.com/v1 и используйте API-ключ, отображаемый сразу после создания аккаунта на странице Get API key. Для начала не нужен ни номер телефона, ни кредитная карта, а также вы получаете $0,50 пробного баланса, который действует семь дней.
В одном аккаунте может быть активен только один ключ одновременно. Если вы смените ключ, предыдущий будет немедленно отозван. Это упрощает управление секретами в средах разработки и продакшена без необходимости сложных областей разрешений.
Отправка завершения чата
Отправьте стандартный POST запрос на эндпоинт /v1/chat/completions, чтобы получить текстовый ответ. Эндпоинт принимает массив messages, содержащий ваш системный промпт и пользовательский запрос, а также идентификатор model, установленный в uncensored. Эта модель работает на наших собственных GPU-серверах и настроена на ответы без отказов в контенте для законного использования взрослыми.
Убедитесь, что тело запроса не превышает 8 МБ. Если ключ недействителен или истек, сервер возвращает ошибку 401. Если ваш предоплаченный баланс исчерпан, вы получите ошибку 402, требующую пополнения. Вы можете добавить средства от $10 через криптовалюту (USDT или USDC).
curl https://api.getdeepseekapi.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."}]
}'
Установка и использование Python SDK
Использование официальной библиотеки OpenAI для Python — самый быстрый способ интеграции. Установите пакет через pip, затем настройте клиент с вашим пользовательским базовым URL и API-ключом. Параметр model должен быть установлен в uncensored, чтобы убедиться, что вы общаетесь с нашим конкретным экземпляром.
Этот подход работает с любым SDK, совместимым с OpenAI, включая те, что используются для Node.js или Go. Клиент автоматически обрабатывает сериализацию и повторные попытки. Помните, что идентификатор модели — это не название вендора, как GPT-4; это конкретный идентификатор нашей модели без цензуры.
from openai import OpenAI
client = OpenAI(base_url="https://api.getdeepseekapi.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
Для сред JavaScript установите SDK OpenAI и настройте его аналогично примеру Python. Установите baseUrl на наш эндпоинт и укажите API-ключ. SDK Node.js поддерживает как синхронные, так и асинхронные шаблоны.
При формировании запроса укажите model: 'uncensored' в параметрах. Это гарантирует, что клиент отправляет запросы на правильный эндпоинт модели. SDK единообразно обрабатывает потоковые и непотоковые ответы, позволяя менять реализации без изменения основной логики запроса.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.getdeepseekapi.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);
Включение потоковой передачи (SSE)
Установите параметр stream в true, чтобы получить ответ Server-Sent Events (SSE). Сервер отправляет серию чанков, каждый из которых содержит часть сгенерированного текста. Это снижает воспринимаемую задержку для длинных ответов и позволяет клиенту отображать токены по мере их генерации.
Убедитесь, что код клиента правильно обрабатывает событие завершения потока. Потоковая передача не меняет тарификацию или подсчет токенов; вы все равно платите за 1M токенов для ввода и вывода. Общее контекстное окно по-прежнему ограничено 100 000 токенов для объединенного промпта и завершения.
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)
Лимиты, ошибки и контекстное окно
Ваш API-ключ ограничен 300 запросами в минуту. Если вы превысите этот порог, сервер вернет ошибку 429, указывающую на лимит запросов. Тело каждого запроса не должно превышать 8 МБ. Контекстное окно поддерживает 100 000 токенов для суммы промпта и завершения, поэтому при проектировании приложения необходимо учитывать длину как ввода, так и вывода.
Распространенные ошибки включают 401 для недействительных ключей, 402 для недостаточного предоплаченного кредита и 429 для лимитов запросов. Вы можете сгенерировать новый API-ключ в любое время в настройках аккаунта, что немедленно сделает старый ключ недействительным. Это полезно, если вы подозреваете утечку или нужно сменить учетные данные между средами.
Характеристики API
Все реальные лимиты и возможности API в одном месте — сверьте их до пополнения.
| Параметр | Значение |
|---|---|
| Формат API | совместим с OpenAI: любой OpenAI SDK работает — замените base URL и ключ |
| Эндпоинты | POST /v1/chat/completions · GET /v1/models |
| Авторизация | Authorization: Bearer YOUR_KEY |
| ID модели | uncensored |
| Base URL | https://api.getdeepseekapi.com/v1 |
| Контекстное окно | 100 000 токенов (вход и ответ вместе) |
| Параметры | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON-режим | response_format: {"type": "json_object"} |
| Потоковая передача | да — server-sent events, последний фрагмент содержит расход токенов |
| Максимум ответа | до остатка окна в 100 000 токенов; max_tokens необязателен (отдельного лимита нет) |
| Вызов функций | да — tools, tool_choice; ответ содержит tool_calls, в том числе в потоке; результат — сообщением role: tool |
| Лимит запросов | 300 запросов в минуту на ключ |
| Размер запроса | до 8 МБ |
| Параллельные запросы | до 8 одновременно на ключ |
| Заголовки ответа | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Срок действия | оплаченный баланс не сгорает, без подписки |
| Пополнение | USDT (TRC20) или USDC (Base), любая целая сумма от $10 до $500 |
| Пробный баланс | $0,50 на 7 дней, без карты · Пробный ключ: 2 параллельных запроса, 60 в минуту; полные лимиты (8 и 300) после первого пополнения |
| Цена | $0,25 за 1 млн входных токенов · $1,00 за 1 млн выходных |
| Оплата | предоплаченный баланс по фактическому расходу; ошибки и отказы бесплатны |
| Бонус | +5% от $50, +10% от $100 |
| Вход | Google или e-mail и пароль |
| Контент | контент для взрослых разрешён; сексуальный контент с несовершеннолетними запрещён |
| Ключи | один активный ключ на аккаунт; новый заменяет старый |
Коды ошибок
Ошибки приходят в JSON с постоянным type; неудачные и отклонённые запросы не оплачиваются.
| Код | Тип | Что значит |
|---|---|---|
400 | bad_request | неверный JSON, пустые сообщения, неверный параметр или превышено окно контекста |
401 | missing_key · invalid_key · key_revoked | нет ключа, ключ неверный или заменён новым |
402 | no_credit | баланс пуст — пополните, работа продолжится сразу |
403 | content_blocked | сексуальный контент с несовершеннолетними — отказ, без оплаты |
404 | not_found | неизвестный эндпоинт |
413 | request_too_large | тело запроса больше 8 МБ |
429 | rate_limited · concurrency | больше 300/мин или 8 параллельно — подождите и повторите |
503 | upstream_busy | модель занята — повторите через несколько секунд |
Вопросы и ответы
Какой размер контекстного окна?
Размер контекстного окна составляет 100 000 токенов, рассчитанных как сумма токенов входного промпта и выходного завершения. Это не 100 000 токенов, доступных исключительно для ввода.
Поддерживает ли этот сервис вызов функций?
Да, эндпоинт <code>/v1/chat/completions</code> поддерживает вызов инструментов и функций. Вы можете определить инструменты в запросе, и модель вернет для них структурированные аргументы.
Как обработать ошибку 402?
Ошибка 402 указывает, что баланс предоплаченного кредита равен нулю. Вы можете пополнить аккаунт от $10 с помощью криптовалюты (USDT или USDC). Кредиты не сгорают.
Ваш ключ — в одной форме от вас
Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.