Налаштування автентифікації та базового URL
Ваш API-ключ автентифікує кожен запит до наших серверів. Просто зареєструйтеся через Google або електронну адресу та скопіюйте ключ з вашої панелі керування. Вставте його у змінну середовища як DEEPSEEK_API_KEY і вкажіть вашому клієнту на https://api.keyapideepseek.com/v1. Ця базова URL-адреса працює з будь-якою стандартною бібліотекою, сумісною з OpenAI.
curl https://api.keyapideepseek.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
}'Ви можете перевірити свою конфігурацію, перелічивши доступні моделі. Відповідь підтверджує, що ваш ключ дійсний та активний. Цей крок гарантує, що ваша інтеграція вказує на правильний ендпоінт без обмежень перед надсиланням запитів.
Ендпоінт Chat Completions
The POST /v1/chat/completions ендпоінт приймає ваш запит і повертає відповідь моделі. Ви надсилаєте тіло JSON, що містить повідомлення, інструкції системи та параметри, такі як temperature. ID моделі завжди uncensored. Ця єдина модель обробляє всі ваші потреби в генерації тексту без складності маршрутизації.
from openai import OpenAI
client = OpenAI(base_url="https://api.keyapideepseek.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)Python SDK автоматично обробляє HTTP-запити. Ви передаєте свій ключ та базовий URL до конструктора клієнта. Решта коду дублює стандартні шаблони OpenAI. Це гарантує, що ви зможете змінити постачальника пізніше, не переписуючи всю логіку вашої програми.
Потокові відповіді та використання токенів
Увімкніть потокову передачу, встановивши stream: true у вашому запиті. API повертає потік фрагментів подій, надісланих сервером (SSE). Кожен фрагмент містить частковий текст і статистику використання. Останній фрагмент містить загальну кількість токенів для запиту.
stream = 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 та виклик функцій
Примусовий структурований вивід шляхом встановлення response_format до {"type": "json_object"}. Модель повертатиме валідний JSON замість вільного тексту. Це ідеально підходить для API-інтеграцій або задач витягування даних. Ви також можете визначити визначення функцій у своєму промпті для використання інструментів.
Модель підтримує tool_choice параметри. Ви можете примусово викликати конкретні функції або дозволити моделі приймати рішення. Ця гнучкість дозволяє вам створювати складних агентів. Переконайтеся, що схеми ваших функцій мають сувору типізацію, щоб уникнути помилок парсингу в коді вашого клієнта.
Ліміти частоти та конкурентність
Кожний API-ключ обмежено 300 запитами на хвилину. Ви можете одночасно активувати до 8 паралельних запитів. Максимальний розмір тіла запиту становить 8 МБ. Ці обмеження запобігають зловживанням та забезпечують стабільну продуктивність для всіх користувачів. Перевищення цих лімітів повертає помилку 429.
Реалізуйте експоненційне сповільнення у своєму клієнтському коді. Повторюйте невдалі запити після короткої затримки. Це плавно вирішує тимчасові проблеми з мережею. Ваш передоплачений кредит нараховується лише за успішні завершення, а не за повторні спроби через обмеження швидкості.
Обробка помилок та відмови
Помилка 401 означає, що ваш ключ недійсний або прострочений. Помилка 402 вказує на недостатній попередньо оплачений баланс. Помилка 429 сигналізує про вичерпання ліміту швидкості. Модель відхиляє запити, що містять сексуальний контент із залученням неповнолітніх. Весь інший законний дорослий контент дозволено.
Перевірте тіло відповіді про помилку для детальних повідомлень. Логуйте ці помилки для налагодження проблем інтеграції. Ваш кредит не витрачається для невдалих запитів. Ця прозора модель тарифікації допомагає точно прогнозувати витрати без прихованих комісій.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.keyapideepseek.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);