Руководство по интеграции для разработчиков

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

Начните с указания клиента на наш базовый URL и передачи вашего API-ключа в заголовке авторизации. Это работает с любым SDK, совместимым с OpenAI, поскольку мы точно следуем стандартному протоколу. Сгенерируйте ключ мгновенно через Google или email на странице получения 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 поле. Проверьте статистику использования в заголовках ответа, чтобы отслеживать потребление токенов.

Python SDK

Используйте официальную библиотеку OpenAI для Python для интеграции нашего 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 package. Configure the client with our base URL and your API key just like you would for OpenAI. This allows you to use the same code structure for both testing and production. The SDK supports asynchronous operations for non-blocking requests.

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 демонстрирует отправку запроса на завершение чата. Этот 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. Это большое окно позволяет вам обрабатывать длинные документы или поддерживать обширную историю разговоров без усечения. Ошибки и отказы не расходуют кредиты, поэтому вы платите только за фактическое использование.