Руководство пользователя DeepSeek V4 API

1. Регистрация и аутентификация

DeepSeek V4 API совместим с SDK OpenAI, что значительно снижает затраты на миграцию и позволяет разработчикам беспрепятственно интегрироваться с существующими инструментами экосистемы ИИ.

Получение API-ключа

1. Посетите Платформу DeepSeek.
2. Нажмите «API Keys» -> «Create new secret key» в правом верхнем углу.
3. Примечание: Ключ отображается только один раз при создании, поэтому сохраните его в надежном месте.

2. Быстрый старт (Пример на Python)

Сначала установите официальный SDK OpenAI (да, вы правильно прочитали, просто используйте SDK OpenAI):

pip install openai

Затем просто измените два параметра: base_url и api_key.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # Ваш API-ключ DeepSeek
    base_url="https://api.deepseek.com"  # Ключевой момент!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # Имя модели может отличаться после выпуска V4
    messages=[
        {"role": "system", "content": "You are a helpful AI assistant."},
        {"role": "user", "content": "Hello, please introduce DeepSeek V4."},
    ],
    stream=False
)

print(response.choices[0].message.content)

3. Расширенные возможности

3.1 Потоковая передача (Streaming)

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

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Write a long poem about whales"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 Вызов функций (Function Calling)

DeepSeek V4 поддерживает мощный Function Calling, способный точно парсить параметры JSON, что делает его идеальным для создания агентов.

3.3 Режим JSON

Если вам нужно, чтобы модель выводила валидный формат JSON, обязательно укажите json_object в response_format и явно запросите вывод JSON в промпте.

4. Ценообразование и оптимизация затрат

Цены на DeepSeek V4 чрезвычайно доступны (конкретные цены ожидают официального объявления, см. V3 по $0.14/M токенов). Чтобы сэкономить еще больше денег:

• Кэширование промптов: V4 вводит механизм кэширования контекста. Если ваш системный промпт длинный (например, база знаний), последующие запросы будут стоить значительно меньше из-за попаданий в кэш.
• Оптимизация контекста: Не запихивайте в него нерелевантную историю чата.

5. Лучшие практики

• Обработка ошибок: Обязательно реализуйте try-except, особенно для ошибок rate_limit_exceeded (429), со стратегией повтора с экспоненциальной задержкой.
• Настройки тайм-аута: Сложные задачи рассуждения могут требовать более длительного времени генерации, поэтому установите тайм-аут на 60 секунд или более.
• Системный промпт: Дайте V4 четкую «персону», и он будет работать лучше.

Возникли проблемы? Ознакомьтесь с нашей Документацией API или присоединяйтесь к сообществу Discord для получения помощи.