Reports
Obter Custos por Host
Obter Custos por Host
Retorna estatísticas detalhadas sobre custos por modelo para um host específico, incluindo informações de precificação, tokens utilizados e custos totais.
Endpoint: POST /api/externalAPIs/public/tolkyReasoning/reports/getCostByHostId
Propriedade | Tipo | Descrição |
---|---|---|
hostId | string (UUID) | Identificador único do host (obrigatório) |
avatarId | string (UUID) | Identificador único do avatar |
startDate | string (date-time) | Data inicial para filtrar os custos (obrigatório) |
endDate | string (date-time) | Data final para filtrar os custos (obrigatório) |
Exemplo cURL:
curl -X POST \
'{BASE_URL}/api/externalAPIs/public/tolkyReasoning/reports/getCostByHostId' \
-H 'Content-Type: application/json' \
-d '{
"hostId": "uuid-do-host",
"avatarId": "uuid-do-avatar",
"startDate": "2025-01-01",
"endDate" : "2025-01-31",
}'
Resposta de Exemplo:
{
"code": 200,
"message": "OK",
"data": {
"costs": [
{
"model": "ft:gpt-4o-mini-2024-07-18:tolky:easy-capture-from-schema:AgX1LcUg",
"input_token_pricing": 0.3,
"output_token_pricing": 1.2,
"total_input_tokens": "8916417",
"total_output_tokens": 338036,
"input_cost_brl": "15.12",
"output_cost_brl": "2.29",
"total_cost_brl": "17.41"
},
{
"model": "gpt-4o-mini-2024-07-18",
"input_token_pricing": 0.15,
"output_token_pricing": 0.6,
"total_input_tokens": "137458554",
"total_output_tokens": 778722,
"input_cost_brl": "116.51",
"output_cost_brl": "2.64",
"total_cost_brl": "119.15"
}
],
"host_info": {
"total_contracted_services": 1000,
"service_pricing_contracted": 1.95
}
}
}
Códigos de Erro:
400
: Campos obrigatórios ausentes ou inválidos401
: Token de autenticação inválido ou ausente404
: Dados não encontrados500
: Erro interno do servidor
Notas:
- Requer autenticação válida através do
tolkyAuthMiddleware
- O parâmetro
hostId
é automaticamente extraído das credenciais de autenticação - Os custos são detalhados por modelo, incluindo precificação de tokens de entrada e saída
- Inclui informações sobre serviços contratados e preço por serviço