Integração por API
API HTTP para análise e otimização de prompts
Integre a análise e a otimização de prompts diretamente nas suas aplicações. Endpoints JSON sem estado, sem chave, sem armazenamento e com o mesmo motor de todos os outros produtos do PromptFlowEngine.
- No ar
- Sem chave de API
- 60 requisições / minuto
O que faz
A API HTTP expõe o motor em https://promptflowengine.com/api/v1. Você envia JSON e recebe JSON. Não há cadastro nem chave, porque a API não guarda dados de usuários: cada resposta é calculada a partir do corpo da requisição e depois esquecida.
Os endpoints cobrem todo o motor: analyze, validate, optimize, restructure, compare, tokens, scan e sanitize, além de catálogos somente leitura de regras e modelos. As contagens de tokens dos modelos da OpenAI são exatas.
A API tem limite de 60 requisições POST por minuto por cliente. Para trabalho em massa ou texto sensível, rode o mesmo motor localmente com a CLI, sem rede e sem limite.
Exemplo prático
Uma requisição
Uma chamada ao endpoint analyze. Os valores de resposta mostrados foram calculados pelo motor quando esta página foi construída, para o prompt da requisição. Os resultados do motor e os prompts gerados aparecem em inglês, exatamente como o motor e a API os retornam.
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 pelo motor quando esta página foi construída. A resposta completa também traz a mensagem, a explicação e a correção sugerida de cada achado, além dos detalhes de segurança e de requisitos.
Principais benefícios
Nada para provisionar
Sem conta, rotação de chaves nem cobrança. Com CORS aberto, um navegador pode chamá-la diretamente.
Sem estado
O texto do prompt é processado em memória e nunca é armazenado nem registrado em log.
Erros tipados
Um envelope de erro consistente com tipo, mensagem e ID da requisição.
As mesmas respostas que localmente
A API roda a mesma versão do motor que o workspace e a CLI.
Recursos
POST /analyze
Achados, qualidade, tokens, segurança, requisitos e intenção.
POST /optimize
O candidato selecionado, todos os candidatos com verificação, as mudanças e um diff.
POST /restructure
Um prompt por seções com cada linha identificada como sua ou como orientação acrescentada.
POST /compare
Diferenças de tokens, custo e qualidade entre dois prompts.
POST /scan e /sanitize
Risco de injeção e posições de dados sensíveis, e texto ocultado.
GET /rules e /models
O catálogo de regras com as penalidades e os modelos com preços de referência.
Para quem é
- Desenvolvedores de aplicaçõesAcrescente uma verificação de prompts a um backend, formulário ou ferramenta interna com uma única chamada HTTP.
- Criadores de automações e no-codeChame a API de uma ferramenta de fluxos de trabalho ou de um script sem instalar nada.
- Equipes prototipandoExperimente o motor com curl antes de decidir se vale embutir o pacote.
Casos de uso
- 01
Valide prompts escritos por usuários
Verifique os prompts que os usuários salvam no seu produto e mostre a eles os achados.
- 02
Verificação prévia em um pipeline
Procure segredos em um texto antes que um job o envie a um provedor de modelos.
- 03
Estimativas de tokens em uma interface
Mostre uma contagem exata de tokens e o custo estimado ao lado de um editor de prompts.
- 04
Reestruturação no servidor
Transforme pedidos curtos de usuários em prompts estruturados antes de chamar o seu modelo.
Perguntas frequentes
Preciso de uma chave de API?
Não. A API não aceita chave, token nem cookie. O abuso é contido por um limite de 60 requisições POST por minuto por IP de cliente.
Meu prompt é armazenado ou registrado em log?
Não. As requisições são processadas em memória. Os logs registram a rota, o status, a duração e uma faixa de tamanho, nunca o texto do prompt nem os resultados.
Posso chamar a API de um navegador?
Sim. O CORS é aberto sem credenciais, então o código de front-end pode chamá-la diretamente.
Quais são os limites de tamanho?
O corpo da requisição pode ter até 256 KB, e cada campo de texto até 100.000 caracteres.
Outros recursos do PromptFlowEngine
Todos os produtos rodam o mesmo motor, então se combinam sem surpresas.
- IntegraçãoMCPConecte o PromptFlowEngine a agentes de IA e fluxos compatíveis com MCP.
- FerramentaTestes de promptsUma verificação de CI para arquivos de prompts: padrão de qualidade, orçamento de tokens e limite de gravidade.
- FerramentaAnalisador de promptsEncontre ambiguidades, contexto ausente, conflitos e tokens desperdiçados em qualquer prompt.
- DocumentaçãoReferência da API HTTPReferência e detalhes de configuração.
- DocumentaçãoCLI para uso local e em massaReferência e detalhes de configuração.
Aprenda a técnica por trás
Guias da central de conhecimento de engenharia de prompts que explicam as ideias que este produto aplica.
- GuiaEngenharia de prompts para desenvolvedoresPrompts de código que produzem mudanças corretas e como tratar prompts de produção como código.
- GuiaOtimização de tokens: custo, janelas de contexto e compressãoComo funcionam tokens e janelas de contexto, como contá-los e como reduzi-los com segurança.
- GuiaGerenciamento e versionamento de promptsArmazenar, versionar, revisar, testar e implantar prompts em equipe.
Um único motor, onde quer que você trabalhe com IA.
Gratuito, determinístico e privado. Sem cadastro.