Посібник з інтеграції для розробників

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

Почніть з того, щоб вказати клієнту на нашу базову URL-адресу та надати свій API-ключ у заголовку авторизації. Це працює з будь-яким SDK, сумісним з OpenAI, оскільки ми точно дотримуємося стандартного протоколу. Згенеруйте ключ миттєво через Google або електронну пошту на сторінці Отримати API-ключ; номер телефону не потрібен. Зберігайте ключ у безпеці та використовуйте один активний ключ на акаунт, оскільки генерація нового замінює старий.

Автентифікація проста. Надішліть свій ключ в Authorization header для кожного запиту. Наша система перевіряє ключ перед обробкою токенів, гарантуючи, що кредит витрачають лише авторизовані облікові записи. Помилки, наприклад відсутність ключа, одразу повертають статус 401.

Перший запит

Надішліть стандартний запит chat completion для тестування з’єднання та якості відповіді. Цей простий виклик перевіряє ваш ключ та правильно зараховує кредити на вашому рахунку. Ідентифікатор моделі — uncensored, що обробляє текстовий ввід і вивід без відмов за змістом для законного дорослого використання. Замініть заповнювач на свій фактичний ключ і системний промпт.

Copycurl https://api.deepseekapicost.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 1 million tokens"}]
  }'

Ця команда curl демонструє мінімальну структуру, необхідну для роботи. Ви можете налаштувати messages масив, щоб включити контекст або інструкції. У відповіді повертається згенерований текст у content поле. Перевірте статистику використання в заголовках відповіді, щоб моніторити споживання токенів.

SDK Python

Використовуйте офіційну Python-бібліотеку OpenAI для інтеграції нашого API у ваші скрипти або застосування. Встановіть base_url та api_key атрибути перед виконанням запитів. Цей підхід забезпечує сумісність із існуючими кодовими базами, які вже використовують моделі OpenAI. Ви можете перемикатися між постачальниками, змінивши лише два рядки конфігурації.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapicost.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 показує, як ініціалізувати клієнта та надіслати запит. Бібліотека автоматично обробляє серіалізацію JSON та парсинг відповідей. Ви можете отримати доступ до об'єкта відповіді, щоб витягти контент, статистику використання та причини завершення. Цей метод ідеально підходить для бекенд-сервісів або конвеєрів обробки даних.

Node SDK

Інтегруйте наш API у додатки Node.js за допомогою openai npm пакет. Налаштуйте клієнта з нашим базовим URL та вашим API ключем так само, як і для OpenAI. Це дозволяє вам використовувати ту ж структуру коду як для тестування, так і для продакшену. SDK підтримує асинхронні операції для неблокуючих запитів.

Copyimport OpenAI from "openai";

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

Цей приклад Node.js демонструє надсилання запиту на завершення чату. The await ключове слово гарантує, що відповідь буде повністю отримана перед продовженням. Ви можете обробляти помилки за допомогою блоків try-catch для graceful управління мережевими проблемами або лімітами API. Об'єкт відповіді містить згенерований текст та деталі використання токенів.

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

Увімкніть потокове передавання, щоб отримувати відповіді токен за токеном для кращого досвіду користувача в чат-інтерфейсах. Встановіть stream параметр на true у вашому запиті. 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)

Наведений вище код потокової обробки обробляє кожен фрагмент одразу після його надходження. Ви можете миттєво додавати вміст до елемента інтерфейсу. Останній фрагмент містить статистику використання токенів. Ця функція підтримується всім клієнтами, сумісними з OpenAI, які коректно обробляють відповіді SSE.

Ліміти, помилки та контекстне вікно

Наш API встановлює суворі ліміти для забезпечення справедливого використання та стабільності системи. Вам дозволено 300 запитів на хвилину та 8 паралельних запитів на ключ. Тіло кожного запиту не повинно перевищувати 8 МБ. Якщо ви перевищите ці ліміти, API повертає код статусу 429. Зачекайте кілька секунд і повторіть запит. Помилки, такі як недійсний ключ, повертають 401, а недостатній баланс — 402.

Вікно контексту підтримує до 100,000 токенів для вводу та виводу в сумі. Максимальний обсяг відповіді за запит становить 16,000 токенів, або 2,048, якщо ви не вказали max_tokens. Таке велике вікно дозволяє обробляти довгі документи або зберігати обширну історію розмов без обрізання. Помилки та відмови не споживають кредити, тому ви платите лише за фактичне використання.