
Замените base URL и ключ — и всё работает
Подключайте модели PortalGPT к приложениям, Telegram-ботам, AI-агентам, CRM и внутренним сервисам. Если ваш сервис уже работает с OpenAI-совместимым API, чаще всего достаточно заменить base URL и ключ.
export OPENAI_API_KEY="ваш-ключ" export OPENAI_BASE_URL="https://api.portalgpt.ru/v1"
Это API для интеграций, а не обычный чат PortalGPT.
Документация, с которой можно начать сразу
Примеры запросов, параметры, модели, ошибки и инструкции по подключению популярных инструментов.
Быстрый старт
export OPENAI_API_KEY="ВАШ_КЛЮЧ" export OPENAI_BASE_URL="https://api.portalgpt.ru/v1" curl https://api.portalgpt.ru/v1/models \ -H "Authorization: Bearer ВАШ_КЛЮЧ"
Убедитесь, что ключ создан в личном кабинете, base URL указан без лишнего пути, а запрос отправляется на endpoint PortalGPT.
Авторизация
Authorization: Bearer ВАШ_КЛЮЧ Content-Type: application/json base_url = "https://api.portalgpt.ru/v1"
Храните ключ на сервере или в защищённых переменных окружения. Не добавляйте API-ключ во фронтенд и публичные репозитории.
Chat Completions
POST /v1/chat/completions { "model": "anthropic/claude-sonnet-4-6", "messages": [{"role":"user","content":"Привет"}] }
Используйте этот формат для диалогов, ассистентов, Telegram-ботов, CRM и внутренних AI-сценариев.
Список моделей
GET /v1/models Authorization: Bearer ВАШ_КЛЮЧ { "data": [ {"id": "anthropic/claude-sonnet-4-6"} ] }
Доступные модели и их статусы смотрите в документации или личном кабинете. Модель передаётся в параметре model.
Embeddings
POST /v1/embeddings { "model": "embedding-model-id", "input": "Текст для поиска или классификации" }
Эмбеддинги подходят для поиска по базе знаний, классификации, похожих документов и retrieval-сценариев.
Параметры запросов
{ "model": "anthropic/claude-sonnet-4-6", "messages": [...], "temperature": 0.3, "max_tokens": 800, "stream": true }
Поддержка streaming, tools, vision, JSON mode и reasoning-параметров зависит от выбранной модели.
Ошибки API
401 Unauthorized // проверьте API-ключ 404 Not Found // проверьте endpoint или модель 429 Rate Limit // превышен лимит запросов 500 Server Error // повторите запрос позже
Проверяйте base URL, заголовок Authorization, id модели, формат JSON и лимиты ключа.
Лимиты
Проект: production Ключ: crm-backend Лимит: задаётся в личном кабинете Отчёт: потребление по ключу и аккаунту
Создавайте отдельные ключи для тестов, production и разных сервисов. Так проще видеть расход и управлять лимитами.
Примеры кода
# cURL, Python и Node.js base_url = "https://api.portalgpt.ru/v1" api_key = "ВАШ_КЛЮЧ" model = "anthropic/claude-sonnet-4-6"
Полные примеры для cURL, Python и Node.js показаны в блоке быстрого старта выше на странице.
Интеграции
OpenAI SDK: укажите baseURL LangChain: настройте custom OpenAI endpoint n8n / Dify: задайте Base URL и API key IDE-клиенты: проверьте поле OpenAI Base URL
Если инструмент поддерживает кастомный OpenAI endpoint, его обычно можно подключить через base URL и ключ.
Часто задаваемые вопросы
Короткие ответы на вопросы, которые обычно возникают перед подключением.
Что значит OpenAI-совместимый API?
Это формат, при котором ваш клиент отправляет запросы по логике OpenAI API. В большинстве случаев достаточно заменить base URL и API-ключ.
Как получить API-ключ?
Ключ создаётся в личном кабинете PortalGPT. Он используется для авторизации и учёта потребления.
Какие модели доступны через API?
Актуальный список моделей доступен в документации или личном кабинете. Модель указывается в параметре model.
От чего зависит стоимость запроса?
От выбранной модели, количества входных и выходных токенов, типа задачи и дополнительных параметров.
Можно ли ограничить расходы?
Да, используйте отдельные API-ключи и лимиты для проектов, тестов и production-среды.
Работает ли API без VPN?
Да, API PortalGPT ориентирован на подключение из России без необходимости использовать VPN.
Можно ли оплачивать от юридического лица?
Для компаний доступен сценарий оплаты с документами. Подробности можно уточнить через форму подключения.
Можно ли использовать OpenAI SDK?
Да, если SDK позволяет указать кастомный base URL.
Где посмотреть примеры кода?
В документации есть примеры для cURL, Python, Node.js и популярных инструментов.
Что делать, если нужной модели нет в списке?
Напишите в поддержку. Мы подскажем доступные альтернативы или уточним возможность подключения.
Заявка успешно отправлена
Мы свяжемся с вами в ближайшее время.