Быстрый старт: Интеграция с API DeepSeek Coder

Базовый URL и аутентификация

Ваш API-ключ аутентифицирует каждый запрос к нашему размещенному конечному пункту. Используйте базовый URL https://api.coderdeepseek.cc/v1 с любым OpenAI SDK или HTTP-клиентом. Идентификатор модели строго uncensored. Это работает на наших собственных серверах и не является перепродажей модели другого вендора. Вы получаете API-ключ сразу после регистрации через Google или email. Храните этот ключ в безопасности, так как он управляет вашим предоплаченным балансом.

Аутентификация основана на Authorization header. Передайте ваш ключ в качестве токена Bearer. Каждый запрос должен включать этот заголовок, чтобы избежать 401 ошибка. Мы не используем параметры запроса для аутентификации. Это обеспечивает чистые заголовки и совместимость со стандартным промежуточным ПО.

Отправка запросов: Завершения чата

Эндпоинт 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 объект для подсчета токенов. Это помогает вам точно контролировать свои расходы.

Интеграция Python SDK

Подключите 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

Используйте SDK OpenAI для Node.js для интеграции с вашими проектами на 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 возвращает поток Server-Sent Events (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 ошибка означает, что у вас нет кредита. Пополните баланс через криптовалюту, чтобы продолжить использование сервиса.