Швидкий старт: Інтеграція з API DeepSeek Coder

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

Ваш API-ключ автентифікує кожен запит до нашого хостованого ендпоінту. Використовуйте базовий URL https://api.coderdeepseek.cc/v1 з будь-яким SDK OpenAI або HTTP-клієнтом. Ідентифікатор моделі є суто uncensored. Це працює на наших власних серверах і не є перепродажем моделі іншого постачальника. Ви отримуєте API-ключ одразу після реєстрації через Google або електронну пошту. Зберігайте цей ключ у безпеці, оскільки він контролює ваш передоплачений кредит.

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

Відправка запитів: Chat Completions

Ендпоінт chat completions обробляє ваші запити та повертає текстові виводи. Надішліть POST-запит на /v1/chat/completions. Вкажіть назву моделі, масив повідомлень та бажані параметри. Система обробляє текст на вході та повертає текст на виході. Ви можете керувати форматом відповіді та умовами зупинки. Це працює як для простих запитань, так і для складних задач програмування.

Використовуйте наведену нижче команду curl для тестування з’єднання. Замініть YOUR_API_KEY з вашим реальним ключем. Запит використовує uncensored модель ідентифікатор. Це підтверджує, що ваша автентифікація та баланс кредиту активні.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

Перевірте, чи містить відповідь choices масив. Кожен варіант включає повідомлення з згенерованим контентом. Перевірте usage об'єкт для підрахунку токенів. Це допомагає точно моніторити ваші витрати.

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

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

Налаштуйте модель на uncensored. Передавайте свої повідомлення у стандартному форматі. SDK підтримує всі наші функції, включаючи виклик функцій та режим JSON. Ви можете встановлювати параметри, такі як temperature та top_p безпосередньо. Це полегшує міграцію з інших постачальників.

Copyfrom openai import OpenAI

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

Обробляйте винятки для помилок мережі або невірних запитів. Перевіряйте код статусу, якщо ви парсите сирі відповіді. Це забезпечує надійну обробку помилок у вашій програмі. SDK абстрагує більшість складності.

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

Використовуйте Node.js OpenAI SDK для інтеграції з вашими проектами на JavaScript або TypeScript. Встановіть пакет та налаштуйте базовий URL. Це зберігає сумісність із існуючою структурою вашого коду. Ви можете використовувати ті ж методи, що й у Python. SDK підтримує як CommonJS, так і ES модулі.

Встановіть модель на uncensored. Передавайте свої повідомлення та параметри. SDK обробляє потокові та непотокові запити. Ви можете перехоплювати помилки та відповідно їх логувати. Це забезпечує стабільність вашого додатку під навантаженням.

Copyimport OpenAI from "openai";

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

Протестуйте свою інтеграцію з простим промптом. Переконайтеся, що відповідь відповідає вашим очікуванням. Перевірте використання токенів у об’єкті відповіді. Це допомагає відстежувати витрати та продуктивність. SDK дозволяє легко швидко ітерувати.

Потокові відповіді та використання токенів

Увімкніть потокову передачу, встановивши stream: true у вашому запиті. API повертає потік подій, надісланих сервером (SSE). Ви отримуєте фрагменти тексту по мірі їх генерації. Це зменшує сприйняту затримку для довгих відповідей. Останній фрагмент містить загальне використання токенів.

Парсуйте події SSE для витягування вмісту. Об’єднайте чанки, щоб сформувати повну відповідь. Відстежуйте usage об'єкт у останньому блоці. Це дає точні підрахунки токенів для билінгу. Стримінг ідеальний для додатків реального часу.

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)

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

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

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

Розмір контекстного вікна становить 100 000 токенів. Це включає як промпт, так і відповідь. Максимальний обсяг відповіді — 16 000 токенів на запит. Якщо ви не встановили max_tokens, за замовчуванням встановлюється 2,048. A 401 помилка означає, що ваш ключ недійсний. A 402 помилка означає, що у вас немає коштів. Поповніть баланс через криптовалюту, щоб продовжити використання сервісу.