Посібник з інтеграції: ключ API deepseek coder

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

Ваш API-ключ автентифікує кожен запит. Встановіть базовий URL на https://api.deepseekcoderapikey.com/v1 у вашій конфігурації клієнта. Ця URL-адреса обробляє як кінцеву точку chat completions, так і models без необхідності додавати додаткові сегменти шляху. Ви отримуєте один ключ на обліковий запис, а генерація нового миттєво замінює попередній ключ.

Збережіть ключ у змінній середовища з назвою DEEPSEEK_API_KEY або передайте його безпосередньо клієнту вашого SDK. Кінцева точка приймає стандартні заголовки, тому ви можете змінити постачальника, змінивши лише базову URL-адресу та значення ключа. Цей підхід працює з Cursor, розширеннями VS Code та локальними інструментами розробки, які очікують OpenAI-сумісний інтерфейс.

Автентифікація завершується невдачею зі статусом 401, якщо ключ відсутній або недійсний. Використовуйте

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

приклад, щоб перевірити з'єднання перед інтеграцією у логіку вашої програми.

Ендпоінт Chat Completions (POST)

Надсилайте повідомлення до POST /v1/chat/completions ендпоінт, що використовує ідентифікатор моделі uncensored. Цей ендпоінт обробляє текстовий вхід і повертає текстовий вивід, підтримуючи синхронні та потокові відповіді. Ви можете налаштувати поведінку моделі за допомогою параметрів, таких як temperature, top_p та послідовності зупинки.

Вікно контексту дозволяє до 100 000 токенів для поєднаного промпту та відповіді. Якщо ви не вказали ліміт max_tokens, модель за замовчуванням використовує 2 048 токенів за запит. Використовуйте

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.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 від OpenAI.

Помилки, такі як недостатність коштів, повертають код статусу 402, тоді як невірні запити повертають 400. Перевірте тіло відповіді для отримання детальних повідомлень про помилки, щоб швидко налагодити структуру вашого запиту.

Кінцева точка Models (GET)

Виконайте запит до доступних моделей, надіславши GET /v1/models запит. Цей ендпоінт повертає список об'єктів моделей, включаючи uncensored model ID. Ви можете використати цей ендпоінт, щоб переконатися, що ваш API-ключ дійсний і служба працює онлайн, перш ніж робити масові запити.

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

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

Потокові відповіді (SSE)

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

Кожен чанк містить частковий вміст, а останній чанк містить статистику загального використання токенів. Уважно парсуйте SSE-потік, щоб обробляти мережеві перериви та буферизувати часткові токени. The

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)

приклад демонструє, як обробляти потік у JavaScript.

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

Function Calling та режим JSON

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

Для структурованих виводів увімкніть режим JSON, встановивши response_format до json_object. Це змушує модель повертати дійсний JSON, що корисно для парсингу конфігураційних даних або відповідей API. Цей

Copyimport OpenAI from "openai";

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

фрагмент показує, як налаштувати режим JSON у Node.js.

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

Ліміти частоти та обмеження

Ваш API-ключ обмежений 300 запитами на хвилину та 8 одночасними запитами. Максимальний розмір тіла запиту становить 8 МБ. Якщо ви перевищите ці ліміти, API поверне помилку 429 Too Many Requests. Реалізуйте експоненційне сповільнення (exponential backoff) у вашому клієнті для коректного оброблення лімітів швидкості.

Помилки, такі як 401, вказують на недійсний ключ, тоді як 402 сигналізує про недостатність коштів. Повернення коштів за кредит не здійснюється, але подвійні списання можна вирішити через сторінку Підтримки. Кредити ніколи не застарівають, тому ви можете поповнити рахунок у зручний момент.

Контекстне вікно на 100,000 токенів стосується загального промпта та завершення. Слідкуйте за використанням токенів, щоб залишатися в межах бюджету. Використовуйте систему передоплати, щоб платити лише за те, що ви використовуєте, без щомісячних платежів або підписок.