API # API нейросети: запускайте своих ИИ-агентов из любого кода Отправьте запрос с ID агента — и получите ответ с учётом его инструкций, знаний и подключённых сервисов. Потоковые ответы, многошаговые диалоги и вызов функций ваших систем. А модели своего провайдера можно подключить по собственному ключу. [Попробовать бесплатно](https://t.me/modelyx_bot)[Как начать](#start) Стартовые кредиты после регистрации · оплата российской картой ## Возможности **Агент целиком — одним запросом** POST /api/v1/responses с ID или коротким именем (slug) агента. Запрос выполняется с его инструкциями, навыками, подключёнными сервисами и базой знаний. **Потоковые ответы** Включите stream — ответ приходит по частям по мере генерации (SSE). Ваше приложение показывает ход работы, а не ждёт до конца. **Многошаговые диалоги** Передайте ID прошлого ответа, и агент продолжит разговор с учётом сказанного. Без ручной склейки истории. **Вызов функций** Опишите функции своей системы — агент попросит вызвать нужную и продолжит с результатом. Найти заказ, проверить остатки, создать тикет. **Ресурсы и спецификация** Адреса API (эндпоинты) для агентов, чатов, сообщений, файлов, библиотек и моделей. Интерактивный справочник и OpenAPI-спецификация для генерации клиента. **Свой ключ провайдера** Добавьте ключ своего провайдера моделей — чаты на этих моделях не списывают кредиты Modelyx. Встроенные инструменты оплачиваются как обычно. ## Как начать - 1Создайте агента и проверьте его в чате. - 2Откройте в настройках раздел ключей API и создайте ключ с датой окончания. - 3Отправьте POST /api/v1/responses с ID или slug агента в поле model. - 4Изучите остальные эндпоинты в интерактивном справочнике /api/v1/docs. ## Пример запроса к API curl https://app.modelyx.ai/api/v1/responses \ -H "Authorization: Bearer $MODELYX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "YOUR_AGENT_ID_OR_SLUG", "input": "Summarize the top 10 customer complaints from this week in 5 bullet points." }' ## Примеры запросов Вставьте запрос в Modelyx и поменяйте детали под себя. Сведи 10 главных жалоб клиентов за эту неделю в 5 пунктов. Составь ответ на это письмо клиента: вежливо, коротко, с предложением замены товара. ## Частые вопросы **Где взять API-ключ?** В настройках откройте раздел ключей API, нажмите кнопку создания ключа, задайте имя и срок действия, затем скопируйте ключ. Храните его в менеджере секретов или переменной окружения. **Работает ли API нейросети в России?** Да, Modelyx работает из России без дополнительных настроек. Запуски оплачиваются кредитами аккаунта — российской картой в рублях или по счёту для компаний. ID агента — последняя часть адреса его страницы. **Можно ли попробовать API бесплатно?** Запуски через API списывают кредиты так же, как обычные чаты. После регистрации начисляются стартовые кредиты — их можно потратить и на пробные запросы. Тарифы — на странице цен. **Чем API Modelyx отличается от своего ключа провайдера?** API Modelyx запускает ваших агентов из внешнего кода. Свой ключ провайдера, наоборот, добавляет модели этого провайдера внутрь Modelyx. **Работает ли Auto на моём ключе провайдера?** Нет, Auto выбирает только из встроенных моделей Modelyx. Чтобы работать по своему ключу, выберите модель провайдера вручную. **Как защитить ключ?** Не вставляйте его в клиентский код и не пересылайте в чатах: любой, у кого он есть, запускает агентов за ваши кредиты. Ставьте срок действия и при утечке создавайте новый ключ. ## Подробно в базе знаний [API](https://modelyx.ai/docs/agents/api/)[Свой ключ от нейросетей](https://modelyx.ai/docs/get-started/own-api-key/)[Создание агента](https://modelyx.ai/docs/agents/build-an-agent/) ## Смотрите также [Агенты](https://modelyx.ai/product/agents/)[Интеграции](https://modelyx.ai/integrations/)[Безопасность](https://modelyx.ai/security/)[Тарифы](https://modelyx.ai/pricing/) ## Попробуйте на своей задаче Опишите задачу обычными словами — Modelyx подберёт модель и вернёт готовый результат. Стартовые кредиты после регистрации. [Начать бесплатно](https://t.me/modelyx_bot)