Документація DeepSeek API: Посібник зі швидкого старту

Базова URL-адреса та аутентифікація

Наш API працює з будь-яким клієнтом, сумісним з OpenAI, просто змінивши базовий URL та надавши API-ключ. Ми не маршрутизуємо кілька моделей; ми розміщуємо одну велику мовну модель без цензури, налаштовану для дорослого та програмістського використання. Автентифікація базується на одному 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. Це повертає конкретну конфігурацію нашої невідфільтрованої LLM, відмінну від 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, ліміт за замовчуванням становить 2048 токенів. Тіла запитів не можуть перевищувати 8 МБ. Ці ліміти є суворими, але передбачуваними, що допомагає розробити надійну логіку повторних спроб без несподіваного обмеження швидкості. Помилки не споживають кредит, тому ви можете вільно тестувати.