Интеграция через API
HTTP API для анализа и оптимизации промптов
Встраивайте анализ и оптимизацию промптов прямо в свои приложения. JSON-эндпоинты без состояния, без ключа, без хранения данных и с тем же движком, что и во всех продуктах PromptFlowEngine.
- Работает
- Без API-ключа
- 60 запросов в минуту
Что он делает
HTTP API предоставляет движок по адресу https://promptflowengine.com/api/v1. Вы отправляете JSON и получаете JSON. Регистрация и ключ не нужны, потому что API не хранит пользовательских данных: каждый ответ вычисляется из тела запроса и затем забывается.
Эндпоинты охватывают весь движок: analyze, validate, optimize, restructure, compare, tokens, scan и sanitize, а также каталоги правил и моделей только для чтения. Количество токенов для моделей OpenAI точное.
API ограничен 60 POST-запросами в минуту на клиента. Для массовой обработки или конфиденциального текста запускайте тот же движок локально через CLI — без сети и без ограничений.
Практический пример
Один запрос
Вызов эндпоинта analyze. Показанные значения ответа движок вычислил при сборке этой страницы для промпта из запроса. Результаты проверки и сгенерированные промпты показаны на английском — так, как их возвращают движок и API.
curl -s https://promptflowengine.com/api/v1/analyze \
-H 'content-type: application/json' \
-d '{"prompt":"Write something about our product.","model":"gpt-4.1"}'{
"quality": {
"overall": 84,
"grade": "good"
},
"tokens": {
"tokens": 6,
"method": "exact"
},
"findings": [
{
"code": "vague_language",
"severity": "warning"
},
{
"code": "missing_output_format",
"severity": "info"
},
{
"code": "missing_length_guidance",
"severity": "info"
}
]
}Рассчитано движком при сборке этой страницы. Полный ответ также содержит сообщение, объяснение и предлагаемое исправление для каждой находки, а также сведения о безопасности и требованиях.
Главные преимущества
Нечего настраивать
Ни аккаунта, ни ротации ключей, ни оплаты. Открытый CORS позволяет вызывать его прямо из браузера.
Без состояния
Текст промпта обрабатывается в памяти и никогда не сохраняется и не логируется.
Типизированные ошибки
Единый формат ошибки с типом, сообщением и идентификатором запроса.
Те же ответы, что и локально
API работает на той же версии движка, что и рабочая область и CLI.
Возможности
POST /analyze
Находки, качество, токены, безопасность, требования и намерение.
POST /optimize
Выбранный кандидат, все кандидаты с результатами проверки, изменения и сравнение.
POST /restructure
Промпт с разделами, где каждая строка помечена как ваша или как добавленная рекомендация.
POST /compare
Разница в токенах, стоимости и качестве между двумя промптами.
POST /scan и /sanitize
Риск инъекции и позиции конфиденциальных данных, а также замаскированный текст.
GET /rules и /models
Каталог правил со штрафами и модели со справочными ценами.
Для кого
- Разработчикам приложенийДобавьте проверку промптов в бэкенд, форму или внутренний инструмент одним HTTP-запросом.
- Создателям автоматизаций и no-codeВызывайте его из инструмента для процессов или скрипта, ничего не устанавливая.
- Командам на этапе прототипаПопробуйте движок через curl, прежде чем решать, встраивать ли пакет.
Сценарии использования
- 01
Проверять промпты, написанные пользователями
Проверяйте промпты, которые пользователи сохраняют в вашем продукте, и показывайте им находки.
- 02
Предварительная проверка в конвейере
Сканируйте текст на секреты, прежде чем задание отправит его провайдеру модели.
- 03
Оценка токенов в интерфейсе
Показывайте точное количество токенов и оценку стоимости рядом с редактором промптов.
- 04
Реструктуризация на сервере
Превращайте короткие запросы пользователей в структурированные промпты перед вызовом модели.
Частые вопросы
Нужен ли API-ключ?
Нет. API не принимает ни ключей, ни токенов, ни cookie. Злоупотребления сдерживаются ограничением в 60 POST-запросов в минуту на IP клиента.
Сохраняется ли мой промпт или попадает ли он в логи?
Нет. Запросы обрабатываются в памяти. В логи попадают маршрут, статус, длительность и диапазон размера, но никогда текст промпта или результаты.
Можно ли вызывать API из браузера?
Да. CORS открыт без учётных данных, поэтому фронтенд-код может вызывать его напрямую.
Каковы ограничения размера?
Тело запроса — до 256 КБ, каждое текстовое поле — до 100 000 символов.
Другие возможности PromptFlowEngine
Все продукты работают на одном движке, поэтому сочетаются без сюрпризов.
- ИнтеграцияMCPПодключите PromptFlowEngine к ИИ-агентам и MCP-совместимым процессам.
- ИнструментТестирование промптовПроверка в CI для файлов промптов: планка качества, бюджет токенов и порог серьёзности.
- ИнструментАнализатор промптовНаходит неоднозначности, недостающий контекст, противоречия и лишние токены в любом промпте.
- ДокументацияСправочник HTTP APIСправка и настройка.
- ДокументацияCLI для локальной и массовой работыСправка и настройка.
Техника, лежащая в основе
Руководства из базы знаний по промпт-инжинирингу, объясняющие идеи, которые применяет этот продукт.
- РуководствоПромпт-инжиниринг для разработчиковПромпты для кода, дающие корректные изменения, и как относиться к промптам в продакшене как к коду.
- РуководствоОптимизация токенов: стоимость, контекстные окна и сжатиеКак работают токены и контекстные окна, как их считать и как безопасно сокращать.
- РуководствоУправление промптами и версионированиеХранение, версионирование, проверка, тестирование и выкатывание промптов в команде.
Один движок — везде, где вы работаете с ИИ.
Бесплатно, детерминированно и приватно. Без регистрации.