Базова URL-адреса та аутентифікація
Почніть кожен запит, звернувши ваш клієнт до правильного базового URL. Використовуйте ключ, отриманий під час реєстрації, щоб передати його в Authorization header. Цей заголовок автентифікує ваш обліковий запис і відстежує використання вашого попередньо оплаченого кредиту.
Наша інфраструктура створена для розробників, які хочуть прямого доступу без комісій за проксі-маршрутизацію. Ви отримуєте стабільну продуктивність, оскільки ми використовуємо власні сервери.
Перший запит
Надішліть своє перше повідомлення для перевірки підключення та реакції моделі. Використовуйте стандартний ендпоінт chat completions із системним промптом та запитом користувача. Це підтверджує, що ваш ключ працює, і показує сирну JSON-відповідь.
- Встановіть
modelfield наuncensored. - Включіть просте повідомлення користувача для тестування затримки.
- Перевірте
usageоб'єкт для підрахунку токенів.
SDK Python
Швидка інтеграція за допомогою офіційної бібліотеки Python. Встановіть пакет і ініціалізуйте клієнта з вашим базовим URL і ключем. Цей підхід автоматично обробляє серіалізацію та повторні спроби.
Визначте історію вашої розмови як список словників. Передайте їх безпосередньо до кінцевої точки чату. Бібліотека повертає об'єкт структурованої відповіді, який можна проаналюзувати для отримання тексту асистента.
Node SDK
Створюйте серверну логіку з клієнтом Node.js. Імпортуйте бібліотеку та налаштуйте ключ API та базовий URL. Ця конфігурація добре підходить для серверних служб, які обробляють вхідні дані користувачів асинхронно.
Викличте метод completion з вашими повідомленнями. Відповідь містить згенерований текст і статистику використання. Обробляйте помилки коректно, щоб уникнути падіння вашого додатку під час високого навантаження.
Потокові відповіді
Отримуйте токени в реальному часі для більш плавного користувацького досвіду. Увімкніть потокову передачу, встановивши відповідний прапорець у вашому запиті. Сервер надсилає чанки даних по мірі їх генерації.
Накопичуйте ці фрагменти на стороні клієнта, щоб відображати текст поступово. Це значно зменшує сприйняту затримку. Слідкуйте за останнім фрагментом для отримання даних про загальне використання токенів та билінг.
Ліміти, помилки та контекст
Дотримуйтесь лімітів швидкості, щоб уникнути переривань сервісу. Вам дозволено 300 запитів на хвилину та 8 паралельних з’єднань на ключ. Якщо ви перевищите цей ліміт, отримаєте помилку 429.
Помилка 401 означає, що ваш API-ключ недійсний. Помилка 402 вказує на недостатній попередньо оплачений баланс. Ваше контекстне вікно становить 100,000 токенів загальною місткістю. Тримайте ваш запит та відповідь в межах цього ліміту для забезпечення надійної продуктивності.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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);Потокова передача
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)