Документація API для розробників

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

Почніть із заміни базової URL-адреси на нашу виділену кінцеву точку та передачі вашого API-ключа у заголовку Authorization. Ми не використовуємо стандартну базову URL-адресу OpenAI; ви повинні вказати ваш SDK на https://api.deepseektokenplan.com/v1. Це гарантує, що ваші запити обробляються через нашу інфраструктуру uncensored-моделей, а не через сторонній проксі. Ідентифікатор моделі, який ви вказуєте в тілі запиту, — "uncensored", що активує спеціальні налаштовані ваги на наших серверах. Аутентифікація базується на простій схемі Bearer-токена, яка сумісна з будь-якою бібліотекою клієнтів, сумісною з OpenAI. Ваш ключ генерується миттєво під час реєстрації через Google або електронну пошту без необхідності вказувати номер телефону. Зберігайте цей ключ у безпеці, оскільки він безпосередньо пов'язаний із балансом вашого передоплаченого кредиту.

Перший запит

Надішліть стандартний запит на завершення чатів за допомогою cURL для перевірки налаштувань та доступності моделі. Цей простий POST-запит демонструє, як API приймає системний запит та повідомлення користувача. Ви можете налаштувати параметри temperature та top_p для керування креативністю. У відповіді повертається згенерований текст разом із статистикою використання токенів для прозорості розрахунків. Переконайтеся, що тіло запиту містить правильний ідентифікатор моделі та ваш API-ключ у заголовку. Цей метод працює як для генерації тексту, так і для виклику функцій. Використовуйте цю команду для підтвердження з’єднання перед інтеграцією у ваш додаток. Кінцева точка однаково добре підтримує потоковий та непотоковий режими.

Інтеграція SDK Python

Використовуйте офіційну Python-бібліотеку OpenAI для взаємодії з нашим API, налаштувавши базовий URL та API-ключ. Ініціалізуйте клієнта своїми обліковими даними та викличте метод завершення чату з бажаним ідентифікатором моделі. Цей підхід дозволяє використовувати існуючі кодові бази, створені для OpenAI, без значного рефакторингу. Ви можете отримувати потокові відповіді або отримувати повний текст одночасно. Бібліотека автоматично обробляє серіалізацію JSON та HTTP-запити. Налаштуйте таймаути та параметри повторних спроб відповідно до ваших конкретних випадків використання. Цей метод ідеально підходить для бекенд-сервісів та конвеєрів обробки даних. Переконайтеся, що ви оновили базовий URL так, щоб він вказував на наш конкретний ендпоінт.

Інтеграція Node SDK

Інтегруйте API у свої застосунки JavaScript або TypeScript за допомогою пакету OpenAI Node. Встановіть базовий URL і API-ключ у конфігурації клієнта перед виконанням будь-яких запитів. Ця конфігурація дозволяє використовувати знайомі методи, такі як chat.completions.create() з нашою uncensored моделлю. Ви можете передавати такі параметри, як температура та послідовності зупинки, щоб налаштувати результат. SDK ефективно обробляє потокові відповіді для додатків реального часу. Використовуйте цей підхід для веб-серверів або інструментів командного рядка. Переконайтеся, що ви імпортували необхідні модулі та правильно налаштували змінні середовища. Цей метод підтримує як синхронні, так і асинхронні шаблони запитів.

Потокова передача та токени

Увімкніть потокове передавання, щоб отримувати часткові відповіді по мірі їх генерації, покращуючи взаємодію з користувачем для чат-інтерфейсів. API використовує Server-Sent Events (SSE) для доставки токенів у реальному часі. Ви можете відстежувати використання токенів у останньому фрагменті потоку для точної білінгу. Ця функція підтримується всіма основними SDK і може бути реалізована вручну, якщо потрібно. Потокове передавання зменшує сприйняту затримку для довгих відповідей. Встановіть stream параметр на true у тілі запиту. API повертає статистику використання в останній події, дозволяючи вам правильно відняти суму від вашого передоплаченого кредиту. Цей метод є суттєвим для додатків, які вимагають миттєвого зворотного зв'язку.

Ліміти та обробка помилок

Відстежуйте ліміти швидкості та обробляйте помилки акуратно, щоб забезпечити стабільне з'єднання. API дозволяє 300 запитів на хвилину на ключ і 8 одночасних запитів. Розмір тіла кожного запиту не повинен перевищувати 8 МБ. Якщо ви надішлете недійсний ключ, ви отримаєте помилку 401 Unauthorized. Помилка 402 вказує на недостатність передоплачених кредитів, що вимагає поповнення через криптовалюту. Помилка 429 означає, що ви перевищили ліміт швидкості; зачекайте і повторіть спробу. Вікно контексту становить 100,000 токенів для промпта та завершення разом. Максимальний вивід становить 16,000 токенів, якщо ви не вкажете менше max_tokens значення. Завжди перевіряйте код стану та тіло відповіді для отримання детальних повідомлень про помилки.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseektokenplan.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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseektokenplan.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);

Потокова передача

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)