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.
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?" }]
}'
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
conversationda ú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.
| Dados | Limites | Acesso |
|---|---|---|
| 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.
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.
DELETE https://api.flowmodels.one/v1/end-users/018f1234-5678-7abc-9def-0123456789ab
Authorization: Bearer $FLOWMODELS_API_KEY
GET https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/erasures
Authorization: Bearer $FLOWMODELS_API_KEY
| Área | Antes | Depois |
|---|---|---|
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.