Документация по API DeepSeek: Руководство по быстрому старту

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

Наш API работает с любым клиентом, совместимым с OpenAI, просто изменив базовый URL и предоставив API-ключ. Мы не маршрутизируем несколько моделей; мы размещаем одну большую языковую модель uncensored, настроенную для взрослых и программистов. Аутентификация основана на одном API-ключе на аккаунт, который вы получаете сразу после регистрации через Google или электронную почту. Номер телефона не требуется, и подписок нет. Ваши промпты не используются для обучающих данных, обеспечивая конфиденциальность при интеграции нашей конечной точки в вашу существующую кодовую базу.

Copycurl https://api.deepseekapidocumentation.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Explain the difference between supervised fine-tuning and RLHF."}]
  }'

POST /v1/chat/completions: Основной эндпоинт

Отправляйте свои разговоры в наш единственный эндпоинт для ответов «текст на вход — текст на выход». Вам не нужно управлять маршрутизацией моделей или беспокоиться о задержках шлюза, так как мы обслуживаем один настроенный эндпоинт напрямую. Идентификатор модели — uncensored, и она реагирует на стандартные параметры завершения чата. Такой подход устраняет сложность выбора из пула моделей. Вы получаете предсказуемое поведение без шума от множества версий вендоров.

Copyfrom openai import OpenAI

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

GET /v1/models: Проверьте вашу uncensored модель

Убедитесь в подключении и активной модели, обратившись к конечной точке models. Это вернет конкретную конфигурацию нашей модели без цензуры, отличную от GPT, Claude или других поставщиков. Вы можете напрямую проверить контекстное окно и лимиты токенов на основе этого ответа. Это быстрая проверка, чтобы убедиться, что клиентский SDK правильно указывает на наши серверы. Используйте это для отладки проблем с подключением перед отправкой тяжелых запросов.

Copyimport OpenAI from "openai";

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

Параметры: Temperature, Top P и потоковое вещание

Контролируйте креативность с помощью temperature и top_p или включите потоковую передачу через Server-Sent Events (SSE). Потоковая передача обеспечивает обновления токенов в реальном времени, что критично для создания отзывчивых интерфейсов чата. Вы также можете установить seed для детерминированных выводов или определить последовательности остановки. Наш API возвращает использование токенов в последнем чанке потока. Эта прозрачность помогает точно отслеживать расходы по мере генерации текста моделью.

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)

Режим JSON и вызов функций

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

Лимиты запросов и количество токенов

Каждый ключ поддерживает 300 запросов в минуту и позволяет 8 одновременных запросов. Контекстное окно вмещает 100 000 токенов в сумме, максимальный вывод — 16 000 токенов за запрос. Если вы не установите max_tokens, лимит по умолчанию составляет 2 048 токенов. Тела запросов не могут превышать 8 МБ. Эти лимиты строгие, но предсказуемые, что помогает вам разработать надежную логику повторных попыток без неожиданного ограничения пропускной способности. Ошибки не потребляют кредит, поэтому вы можете тестировать свободно.