DeepSeek API: Повний Посібник з Інтеграції та Використання

Як почати роботу з API

Налаштування доступу до API починається зі створення облікового запису розробника на платформі DeepSeek та створення першого ключа API у розділі облікових даних. Процес швидкого старту складається з трьох основних етапів: налаштування автентифікації, встановлення SDK та виконання першого запиту. Більшість розробників завершують тестування першого запиту протягом 15 хвилин, використовуючи надані шаблони коду.

Автентифікація використовує формат токена Bearer з ключами, що мають префікс sk-. Базовий URL для всіх кінцевих точок API — https://api.deepseek.com/v1, що відповідає конвенціям RESTful. Обов’язкові заголовки включають Authorization з вашим ключем API та Content-Type зі значенням application/json. Обмеження швидкості діють для кожного ключа окремо, що дозволяє командам розподіляти квоти між різними проєктами.

Для встановлення Python SDK використовуйте pip, щоб додати офіційну бібліотеку клієнта. Наведений нижче код демонструє повний робочий процес першого запиту з використанням моделі DeepSeek V3 через кінцеву точку завершення чату:

pip install deepseek-sdk

from deepseek import DeepSeek

client = DeepSeek(api_key="sk-your-api-key-here")

response = client.chat.completions.create(
    model="deepseek-chat-v3",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    max_tokens=500,
    temperature=0.7
)

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

Для розробників, які віддають перевагу запитам через curl, еквівалентний виклик HTTP потребує явного налаштування заголовків. Цей підхід зручний для тестування без залежностей від SDK:

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat-v3",
    "messages": [{"role": "user", "content": "Hello, API!"}],
    "max_tokens": 100
  }'

API повертає відповіді у форматі JSON, що містять згенерований текст, статистику використання токенів та метадані запиту. Успішні відповіді містять масив choices з результатом роботи моделі, тоді як помилки повертають стандартизовані коди для відлагодження. Кількість токенів відображається в об'єкті usage, де фіксуються prompt_tokens, completion_tokens та total_tokens для точності розрахунків.

• Отримання налаштувань ключа API у вкладці безпеки панелі розробника.
• Встановлення Python SDK або використання прямих HTTP-запитів для гнучкості.
• Тестування з'єднання за допомогою простого завершення чату перед виходом у продакшн.
• Моніторинг заголовків відповіді для перевірки статусу лімітів та залишку квоти.

Посібники зі швидкого старту в документації охоплюють інші мови, включаючи Node.js та Go, з прикладами для фреймворків Express, Flask та FastAPI. Конфігурації вебхуків для асинхронної обробки потребують верифікації кінцевої точки під час початкового налаштування.