Integración por API
API HTTP para análisis y optimización de prompts
Integra el análisis y la optimización de prompts directamente en tus aplicaciones. Endpoints JSON sin estado, sin clave, sin almacenamiento y con el mismo motor que el resto de productos de PromptFlowEngine.
- En producción
- Sin clave API
- 60 solicitudes / minuto
Qué hace
La API HTTP expone el motor en https://promptflowengine.com/api/v1. Envías JSON y recibes JSON. No hay registro ni clave, porque la API no guarda datos de usuarios: cada respuesta se calcula a partir del cuerpo de la solicitud y después se olvida.
Los endpoints cubren todo el motor: analyze, validate, optimize, restructure, compare, tokens, scan y sanitize, además de catálogos de solo lectura de reglas y modelos. Los recuentos de tokens de los modelos de OpenAI son exactos.
La API tiene un límite de 60 solicitudes POST por minuto por cliente. Para trabajo masivo o texto sensible, ejecuta el mismo motor en local con la CLI, sin red y sin límite.
Ejemplo práctico
Una solicitud
Una llamada al endpoint analyze. Los valores de respuesta mostrados los calculó el motor al construir esta página, para el prompt de la solicitud. Los hallazgos del motor y los prompts generados se muestran en inglés, tal como los devuelven el motor y la 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"
}
]
}Calculado por el motor al construir esta página. La respuesta completa incluye además el mensaje, la explicación y la corrección sugerida de cada hallazgo, junto con los detalles de seguridad y requisitos.
Ventajas principales
Nada que aprovisionar
Sin cuenta, rotación de claves ni facturación. Con CORS abierto, un navegador puede llamarla directamente.
Sin estado
El texto del prompt se procesa en memoria y nunca se almacena ni se registra.
Errores tipados
Un formato de error coherente con un tipo, un mensaje y un ID de solicitud.
Las mismas respuestas que en local
La API ejecuta la misma versión del motor que el espacio de trabajo y la CLI.
Funciones
POST /analyze
Hallazgos, calidad, tokens, seguridad, requisitos e intención.
POST /optimize
El candidato seleccionado, todos los candidatos con su verificación, los cambios y un diff.
POST /restructure
Un prompt por secciones con cada línea etiquetada como tuya o como orientación añadida.
POST /compare
Diferencias de tokens, coste y calidad entre dos prompts.
POST /scan y /sanitize
Riesgo de inyección y posiciones de datos sensibles, y texto con los datos ocultos.
GET /rules y /models
El catálogo de reglas con sus penalizaciones y los modelos con precios de referencia.
Para quién es
- Desarrolladores de aplicacionesAñade una comprobación de prompts a un backend, un formulario o una herramienta interna con una sola llamada HTTP.
- Creadores de automatizaciones y no-codeLlámala desde una herramienta de flujos de trabajo o un script sin instalar nada.
- Equipos que hacen prototiposPrueba el motor con curl antes de decidir si integrar el paquete.
Casos de uso
- 01
Valida prompts escritos por usuarios
Revisa los prompts que los usuarios guardan en tu producto y muéstrales los hallazgos.
- 02
Comprobación previa en un pipeline
Busca secretos en el texto antes de que un job lo envíe a un proveedor de modelos.
- 03
Estimaciones de tokens en una interfaz
Muestra un recuento exacto de tokens y el coste estimado junto a un editor de prompts.
- 04
Reestructuración en el servidor
Convierte peticiones breves de usuarios en prompts estructurados antes de llamar a tu modelo.
Preguntas frecuentes
¿Necesito una clave API?
No. La API no acepta clave, token ni cookie. El abuso se limita con un máximo de 60 solicitudes POST por minuto por IP de cliente.
¿Se almacena o registra mi prompt?
No. Las solicitudes se procesan en memoria. Los registros guardan la ruta, el estado, la duración y un rango de tamaño, nunca el texto del prompt ni los resultados.
¿Puedo llamar a la API desde un navegador?
Sí. CORS está abierto sin credenciales, así que el código de front-end puede llamarla directamente.
¿Cuáles son los límites de tamaño?
El cuerpo de la solicitud puede ocupar hasta 256 KB, y cada campo de texto hasta 100.000 caracteres.
Otras capacidades de PromptFlowEngine
Todos los productos ejecutan el mismo motor, así que se combinan sin sorpresas.
- IntegraciónMCPConecta PromptFlowEngine con agentes de IA y flujos compatibles con MCP.
- HerramientaPruebas de promptsUn control de CI para archivos de prompts: umbral de calidad, presupuesto de tokens y nivel de gravedad.
- HerramientaAnalizador de promptsEncuentra ambigüedades, contexto faltante, conflictos y tokens desperdiciados en cualquier prompt.
- DocumentaciónReferencia de la API HTTPReferencia y detalles de configuración.
- DocumentaciónCLI para uso local y masivoReferencia y detalles de configuración.
Aprende la técnica que hay detrás
Guías del centro de conocimiento de ingeniería de prompts que explican las ideas que aplica este producto.
- GuíaIngeniería de prompts para desarrolladoresPrompts de código que producen cambios correctos y cómo tratar los prompts de producción como código.
- GuíaOptimización de tokens: coste, ventanas de contexto y compresiónCómo funcionan los tokens y las ventanas de contexto, cómo contarlos y cómo reducirlos con seguridad.
- GuíaGestión y versionado de promptsAlmacenar, versionar, revisar, probar y desplegar prompts en equipo.
Un solo motor, dondequiera que trabajes con IA.
Gratis, determinista y privado. Sin registro.