Esquema
| Campo | Tipo | Descrição |
|---|
tokenId | UUIDv7 | Identificador único |
name | string | Nome do token, máx 255 |
description | text | Descrição |
type | enum | Veja TokenType abaixo |
value | decimal | Preço por unidade |
currency | enum | USD, BRL, EUR |
status | enum | ACTIVE, INACTIVE |
createdBy | UUIDv7 | Criador |
createdAt | datetime | Criação |
updatedBy | UUIDv7 | Último atualizador |
updatedAt | datetime | Última atualização |
deletedBy | UUIDv7? | Quem deletou |
deletedAt | datetime? | Soft delete |
Enum TokenType
AUDIO_TO_TEXT, IMAGE_TO_TEXT, MEMORY, PLANNING, RESPONSE, RETRIEVAL, SUMMARY, TOOLS, TRANSCRIPTION, WEBSCRAPING
Cada TokenType corresponde a uma capacidade específica de IA. Por exemplo, RESPONSE é o token de saída do LLM, PLANNING é usado na etapa de planejamento do agente, e TOOLS representa chamadas a ferramentas externas. Isso permite precificação granular por tipo de operação.
Relacionamentos
- Has many Fees via FeeToken (M2M)
- Has many Costs
Regras de Negócio
- Único por combinação (name, type, currency)
- Fees vinculadas não podem ter moedas duplicadas
- Status padrão ACTIVE
O value do token é precificado na moeda de origem (geralmente USD, já que provedores de IA cobram em dólar). A conversão para a moeda da organização acontece no momento de criação do Cost, usando a taxa de câmbio do dia.
Tokens com status INACTIVE não geram novos custos, mas custos existentes permanecem válidos para faturamento. Desativar um token não afeta invoices já emitidas.
Exemplo
[
{
"tokenId": "019527b1-5d60-7a7e-c6b4-1c2e8a4b6d9f",
"name": "GPT-4o Output Token",
"description": "Token de saída do modelo GPT-4o para respostas de agentes",
"type": "RESPONSE",
"value": 0.00001,
"currency": "USD",
"status": "ACTIVE",
"createdBy": "019525fc-1234-7a1b-8c2d-3e4f5a6b7c8d",
"createdAt": "2026-01-10T08:00:00Z",
"updatedBy": "019525fc-1234-7a1b-8c2d-3e4f5a6b7c8d",
"updatedAt": "2026-01-10T08:00:00Z"
},
{
"tokenId": "019527b1-6e70-7b8f-d7c5-2d3f9a5b7c0e",
"name": "GPT-4o Input Token",
"description": "Token de entrada do modelo GPT-4o para contexto e prompts",
"type": "PLANNING",
"value": 0.0000025,
"currency": "USD",
"status": "ACTIVE",
"createdBy": "019525fc-1234-7a1b-8c2d-3e4f5a6b7c8d",
"createdAt": "2026-01-10T08:00:00Z",
"updatedBy": "019525fc-1234-7a1b-8c2d-3e4f5a6b7c8d",
"updatedAt": "2026-01-10T08:00:00Z"
}
]
