Criar conta
Somente para empresas e profissionais autônomos

Menu

Dados por pessoa, separados e excluíveis.

Com external_identifier, você associa histórico, memórias e arquivos a uma pessoa da sua aplicação. Ao excluí-la, você recebe um comprovante que continua disponível depois.

Como um usuário final é criado.

Você mesmo define o identificador. Ele é uma sequência estável de até 255 caracteres e fica dentro da sua equipe. A primeira chamada com um identificador desconhecido cria o usuário final; com POST /v1/end-users, isso também funciona antes.

Chamada com identificador de usuário final
curl https://api.flowmodels.one/v1/chat/completions \
  -H "Authorization: Bearer $FLOWMODELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-fable-5-1",
    "external_identifier": "customer-42",
    "messages": [{ "role": "user", "content": "Qual é mesmo o meu plano?" }]
  }'
Criar usuário final antes
curl https://api.flowmodels.one/v1/end-users \
  -H "Authorization: Bearer $FLOWMODELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_identifier": "customer-42",
    "metadata": { "plan": "pro" }
  }'

O que o identificador muda.

external_identifier

  • O histórico fica no FlowModels; você envia apenas as novas mensagens e o conversation da última resposta.
  • Memórias e trechos de arquivos relevantes da mesma pessoa entram no contexto.
  • Históricos longos são resumidos. Essas chamadas de modelo também fazem parte do consumo pago.

Sem identificador

  • O histórico é seu; você o envia em cada chamada.
  • O FlowModels não resume nada por conta própria.
  • Nenhuma memória é buscada e nenhuma é armazenada.

O que é armazenado por pessoa.

DadosLimitesAcesso
Metadados No máximo 50 entradas, valores de até 1.000 caracteres PATCH /v1/end-users/{uuid}
Memórias Texto de até 10.000 caracteres por memória, detecção automática pode ser desligada POST, GET, PATCH, DELETE /v1/memories
Arquivos 32 MB por arquivo, 100 arquivos por usuário final, 5 GB por equipe POST, GET, DELETE /v1/end_users/{uuid}/files

Os arquivos são avaliados como texto. São permitidos pdf, docx, doc, rtf, xlsx, pptx, txt, md e csv.

As memórias automáticas vêm ligadas para novos usuários finais. Com memory_extraction_enabled: false, você as desliga por pessoa.

Gravar uma memória
curl https://api.flowmodels.one/v1/memories \
  -H "Authorization: Bearer $FLOWMODELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_identifier": "customer-42",
    "text": "Prefere respostas em português."
  }'

Exclusão com comprovante.

DELETE /v1/end-users/{uuid} remove os dados de trabalho dessa pessoa: histórico, memórias, arquivos e registros. Arquivos privados são excluídos em segundo plano, e o comprovante mostra quando isso terminou. As linhas de cobrança e consumo são mantidas.

O comprovante contém apenas contagens, nenhum conteúdo. Ele continua disponível pelo identificador depois da exclusão, porque é justamente aí que você precisa dele.

Excluir usuário final
DELETE https://api.flowmodels.one/v1/end-users/018f1234-5678-7abc-9def-0123456789ab
Authorization: Bearer $FLOWMODELS_API_KEY
Consultar comprovantes
GET https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/erasures
Authorization: Bearer $FLOWMODELS_API_KEY
Comprovante de exclusão Exemplo
Status
completed
Solicitado
2026-11-09T08:15:00+01:00
Concluído
2026-11-09T08:15:40+01:00
ÁreaAntesDepois
memories 12 0
end_user_files 3 0
conversations 7 0
messages 86 0
stored_objects 3 0

objects_remaining 0

O FlowModels não tem orçamento por usuário final. Como acompanhar o consumo por pessoa mesmo assim está em Orçamentos.

Crie uma chave, escolha um modelo e comece.

O FlowModels é destinado exclusivamente a empresas e profissionais autônomos.