getdeepseekapi.comРуководство
URL API DeepSeek и базовый URL: как переключиться
URL API DeepSeek, который вы копируете из собственной документации DeepSeek, — это базовый URL, и он работает только с ключом DeepSeek и моделями DeepSeek. Если вам нужен другой эндпоинт в стиле OpenAI, вы меняете этот URL, ключ и идентификатор модели.
Обновлено
Ключевые моменты
- Базовый URL — это префикс; SDK добавляет к нему /chat/completions.
- Этот сервис использует https://api.getdeepseekapi.com/v1 с идентификатором модели uncensored.
- Это не API DeepSeek, поэтому ключ DeepSeek здесь не сработает, и наоборот.
- Большинство клиентов также принимают URL и ключ через переменные OPENAI_BASE_URL и OPENAI_API_KEY.

Базовый URL, эндпоинт и путь: три части
Люди часто вставляют полный адрес в поле, ожидающее префикс, и получают 404. Три термина помогают понять разницу.
- Базовый URL: общий префикс каждого вызова, например
https://api.getdeepseekapi.com/v1. Это то, что вы вводите в настройке «Базовый URL API» или «Базовый URL» клиента. - Путь эндпоинта: часть, добавляемая SDK, например
/chat/completions,/responsesили/models. - Полный URL: база плюс путь, например
https://api.getdeepseekapi.com/v1/chat/completions. Для HTTP-клиентов, таких как curl, нужен именно он.
Правило, на котором попадается большинство: SDK и приложения запрашивают базовый URL, curl и HTTP-узлы запрашивают полный URL. Если инструмент выдает 404, сначала проверьте, не вставили ли вы полный URL туда, где ожидалась база, или наоборот. Дублированный путь, такой как /v1/chat/completions/chat/completions в ошибке, — это явный признак.
Что такое базовый URL DeepSeek и чем он не является
DeepSeek публикует адрес своего API в документации вместе с именами моделей, которые может использовать ваш ключ. Ищите там актуальное значение, а не доверяйте статье в блоге, включая эту. Ключ DeepSeek работает только с эндпоинтом DeepSeek и больше ни с чем.
Сервис на этом сайте — отдельный продукт. Это не официальный API DeepSeek, он не перенаправляет запросы в DeepSeek и не обслуживает модели DeepSeek. Это размещенный API, совместимый с OpenAI, для одной модели с открытыми весами, запущенный независимым провайдером и настроенный на ответы без отказов по контенту для законного использования взрослыми. Его адрес:
https://api.getdeepseekapi.com/v1 # model: uncensored
Идентификатор модели — uncensored, а аутентификация — Authorization: Bearer <key>. Ключи выдаются на странице API-ключей. Если вы сравниваете, что означает ключ для каждого сервиса, на странице Ключ API DeepSeek есть более подробная информация.
Переключение эндпоинтов в SDK OpenAI
Любой SDK OpenAI работает, если вы измените базовый URL и ключ. В Python:
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": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
В Node.js поле называется baseURL:
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: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
Обратите внимание на разницу: Python использует base_url, Node использует baseURL. Если их перепутать, SDK молча вернётся к адресу OpenAI по умолчанию, который отклонит ваш ключ.
Переключение без изменения кода
Официальные SDK OpenAI читают две переменные окружения, поэтому существующее приложение можно перенаправить без изменения кода:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
Имя модели — это часть, которую нельзя пропустить. Если в приложении жестко задан другой идентификатор модели, оно запросит его и выдаст ошибку, поэтому измените его на uncensored в настройках или конфигурации приложения. Многие инструменты отображают все три значения на одном экране настроек, обычно с подписями API base, API key и model.
Та же замена трех значений работает в фреймворках. Например, с LangChain в Python достаточно: ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored"). Инструменты разработки, принимающие эндпоинт, совместимый с OpenAI, работают так же; см. руководство по использованию API для программирования.
Прямые HTTP-запросы: точные пути
Для curl, скриптов и HTTP-узлов вы сами строите полный URL. Вот пути для этого сервиса:
| Назначение | Метод и URL |
|---|---|
| Чат | POST https://api.getdeepseekapi.com/v1/chat/completions |
| Responses API | POST https://api.getdeepseekapi.com/v1/responses |
| Список моделей | GET https://api.getdeepseekapi.com/v1/models |
| Баланс | GET https://api.getdeepseekapi.com/v1/balance |
| Баланс в стиле OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
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":"ping"}]}'
Используйте только HTTPS. Потоковая передача работает с "stream": true через события, отправляемые сервером, и один и тот же URL обслуживает оба режима.
Ввод URL в приложениях с экраном настроек
Многие чат-интерфейсы, редакторы и инструменты автоматизации имеют опцию «пользовательский эндпоинт, совместимый с OpenAI». Метки различаются, но поля сопоставляются одно к одному:
| Поле в приложении | Значение |
|---|---|
| Базовый URL API, Базовый URL, Эндпоинт, URL сервера | https://api.getdeepseekapi.com/v1 |
| Ключ API, Токен, Секрет | Ваш ключ от этого сервиса |
| Модель, Имя модели, Идентификатор модели | uncensored |
Некоторые приложения требуют полный URL чата, а не базовый. В этом случае используйте https://api.getdeepseekapi.com/v1/chat/completions. Если в приложении есть кнопка «проверить соединение», она обычно вызывает список моделей, который находится по адресу GET /v1/models. Если кнопка выдает ошибку, но ручной чат работает, проверка приложения строже, чем API, и вы можете ее игнорировать.
Быстрая проверка URL
Прежде чем отлаживать приложение, проверьте URL по списку моделей. Тело запроса не требуется, и запрос бесплатный:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
Вы должны получить JSON с массивом data. HTML-страница ошибки означает неверный хост или путь, например, отсутствие поддомена: хост начинается с api., а не www..
Исправление распространённых ошибок
- 404 Not Found. В базовом URL отсутствует
/v1, он указан дважды или содержит путь к эндпоинту. - 401 или ошибка аутентификации. Вы использовали ключ от другого сервиса, или в заголовке отсутствует
Bearer. Ключи не являются взаимозаменяемыми между поставщиками. - Модель не найдена. В запросе всё ещё указана модель старого поставщика. Установите
uncensored. - Приложение всё ещё обращается к старой службе. Некоторые инструменты кэшируют настройки или читают другую переменную. Перезапустите процесс и проверьте экран настроек.
- Проблема с завершающим слэшем. Большинство клиентов справляются с этим, но если один из них не справляется, удалите последний слэш из базового URL.
Если вы не уверены, на какой стороне происходит сбой, отправьте приведённую выше команду curl. Ответ 200 подтверждает URL, ключ и модель; всё остальное, что ломается, находится в вашем приложении. В документации указаны лимиты и заголовки, такие как X-Request-Id, что помогает при обращении в службу поддержки.
Что остаётся прежним после перехода
Форматы запросов и ответов соответствуют формату OpenAI, поэтому массивы сообщений, temperature, top_p, stop, seed, штрафы, вызов функций и JSON-режим работают как обычно. Контекстное окно составляет 100 000 токенов для промпта и завершения, а максимальный размер тела запроса — 8 МБ. Сервис поддерживает только текст: нет изображений, аудио, эмбеддингов или дообучения, поэтому функции, построенные на их основе, требуют другого поставщика.
Биллинг также отделён от старого поставщика: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов из предоплаченного баланса, как показано на странице цен. Новые пользователи могут получить $0,50 пробного баланса, чтобы проверить, что переход работает, прежде чем что-либо оплачивать.
Дополнительные руководства
Вопросы и ответы
Какой базовый URL у API DeepSeek?
DeepSeek публикует его в своей документации, поэтому проверьте там актуальное значение. Эндпоинт на этом сайте — это другой сервис по адресу https://api.getdeepseekapi.com/v1.
Могу ли я использовать ключ DeepSeek на этом эндпоинте?
Нет. Ключи выдаются для каждого сервиса. Получите ключ для этого API на странице ключей и установите модель в uncensored.
Должен ли базовый URL заканчиваться на /v1?
Да, для этого сервиса: https://api.getdeepseekapi.com/v1. SDK добавляют путь к эндпоинту после него, поэтому не добавляйте /chat/completions самостоятельно.
Почему я получаю 404 после изменения URL?
Обычно путь дублируется или отсутствует /v1. Сравните ваш базовый URL с точным значением, приведённым выше.
Ваш ключ — после заполнения одной формы
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.