Подключение API нейросети к вашим системам: пошагово

Порядок один для любой модели и любой системы, меняются только адрес, ключ и название модели:

• Модель и провайдер: где будут обрабатываться данные, какой объем, какой формат запросов.
• Ключ: получить в кабинете провайдера и хранить только на сервере.
• Первый запрос: проверить связку из кода, до любых интеграций.
• Подключение: связать CRM, 1С, сайт или бота с вашим сервером, а сервер с API.
• Эксплуатация: лимиты, повторы при ошибках, журнал и контроль расходов.

Начните с данных. Если в запросах будут персональные данные клиентов, зарубежное облако означает трансграничную передачу по 152-ФЗ. Тогда проще взять открытую модель на своих серверах или в своем ЦОДдата-центр для ИИ Дата-центр для ИИ это здание с тысячами серверов на видеокартах и других ускорителях, мощным электропитанием и охлаждением, где обучают и запускают нейросети. Подробнее в словаре, где запросы не покидают контур.

Формат стоит брать совместимый с OpenAI. DeepSeek API на 16.10.2026 принимает этот формат: достаточно поменять адрес (https://api.deepseek.com) и ключ в привычной библиотеке. vLLM поднимает такие же интерфейсы на вашем сервере, и открытая модель подключается к готовому коду без переписывания.

Если нужна именно модель OpenAI, аккаунт оформляют на юрлицо в стране, где провайдер работает: на 16.10.2026 России нет в списке стран OpenAI API. Что доступно официально, разобрано на странице о доступе к API из России.

Объем решает остальное. Посчитайте, сколько запросов в день придет из CRM, бота и сайта, и сравните тарифы провайдеров в сравнении цен API, а свой сервер в калькуляторе стоимости локального ИИ.

Ключ выдает провайдер в личном кабинете. Он открывает доступ к аккаунту и к оплате, поэтому храните его только на сервере: в переменной окружения или в хранилище секретов. OpenAI в справочнике API просит не показывать ключ в коде браузера и приложений, Alibaba Cloud предупреждает, что ключ в коде повышает риск утечки.

Утечки случаются не только с ключами. 2 мая 2023 года Samsung запретила сотрудникам генеративный ИИгенеративный ИИ Генеративный ИИ (generative AI) это нейросети, которые создают новый контент: тексты, изображения, музыку, видео и программный код по описанию на обычном языке. Подробнее в словаре после того, как инженеры загрузили в ChatGPT внутренний исходный код. Правило для интеграции: в запрос уходит только то, что нужно модели для ответа.

• Не вставляйте ключ в код сайта, мобильного приложения или бота, который видит пользователь.
• Заведите отдельный ключ на каждую систему: CRM, сайт, бот. Утек один, отзываете один.
• Задайте лимит расходов в кабинете провайдера: у OpenAI и Anthropic он есть на 16.10.2026.
• Меняйте ключи по графику: выпустить новый, переключить системы, отозвать старый.

Установите библиотеку openai для Python и положите ключ в переменную окружения DEEPSEEK_API_KEY. Пример ниже отправляет запрос в DeepSeek; для своего сервера на vLLM меняются только base_url и название модели.

Если ответ пришел, связка работает. Ошибка 401 означает неверный ключ или чужой регион ключа, 429 говорит о превышении лимита. Параметр timeout в примере не дает запросу висеть дольше 30 секунд.

Для Node.js у DeepSeek есть такой же пример, а запрос через curl идет на метод /chat/completions с ключом в заголовке Authorization: Bearer. Так связку можно проверить с сервера еще до написания кода.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.deepseek.com",
    api_key=os.environ["DEEPSEEK_API_KEY"],
    timeout=30,
)

reply = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "Ты помощник отдела продаж. Отвечай кратко."},
        {"role": "user", "content": "Клиент спрашивает срок поставки 200 штук"},
    ],
)
print(reply.choices[0].message.content)

Нейросеть сама в CRM не ходит. Между системой и API стоит ваш серверный код или готовая интеграция: он берет данные из системы, отправляет запрос модели и записывает ответ обратно.

Начните с одного сценария: например, черновик ответа клиенту в CRM, который менеджер проверяет перед отправкой. Так вы увидите качество модели на живых данных, не рискуя перепиской с клиентами.

Схемы для популярных систем собраны в разделе интеграций, отдельно разобрано подключение ИИ к 1С. Там же видно, какие права и события нужны в каждой системе.

• CRM: событие о новой заявке (webhook) запускает запрос к модели, ответ попадает в карточку сделки или в задачу менеджеру.
• 1С: обмен через HTTP-сервисы или файлы обмена; модель разбирает документы и заполняет поля.
• Бот в Telegram: сервер получает сообщение, отправляет его модели и возвращает ответ пользователю. Ключ остается на сервере, в боте его нет.
• Сайт: форма или чат обращается к вашему серверу, а сервер к API. Прямой вызов API из браузера раскрывает ключ.

Провайдеры считают лимиты в запросах и токенахтокен Токен это кусочек текста: слово, часть слова или знак, с которыми работает языковая модель. Подробнее в словаре в минуту, Google для Gemini еще и в запросах в день. Превышение возвращает ошибку 429. Anthropic в таком ответе передает заголовок retry-after: столько секунд нужно подождать перед повтором (на 16.10.2026).

У Anthropic при достижении месячного потолка расходов запросы получают 429 без заголовка retry-after, и повторы не помогут до начала следующего месяца или до повышения лимита. Журнал должен отличать такой случай от обычного лимита.

Если API работает на вашем сервере с vLLM, лимиты задаете вы сами, а журнал остается внутри компании.

Для больших объемов мы даем выделенный API на DeepSeek, Qwen и других открытых моделяхмодель с открытыми весами Модель с открытыми весами (open-weights model) это нейросеть, файлы параметров которой можно скачать и запустить на своем оборудовании. Подробнее в словаре: формат OpenAI, вы видите инфраструктуру, журналы и процессы обработки запросов.

• Повторы: при 429 и сетевых сбоях повторяйте запрос с растущей паузой, а не сразу.
• Таймаут: задайте предельное время ответа, чтобы CRM не зависала, как timeout=30 в примере.
• Журнал: пишите время, систему, модель, число токенов, код ошибки и длительность. Текст запросов с персональными данными в журнал не кладите или маскируйте.
• Расходы: оповещения и жесткий лимит в кабинете провайдера. У OpenAI жесткий лимит останавливает запросы при достижении суммы.