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/getCostByHostId

PropriedadeTipoDescrição
hostIdstring (UUID)Identificador único do host (obrigatório)
avatarIdstring (UUID)Identificador único do avatar
startDatestring (date-time)Data inicial para filtrar os custos (obrigatório)
endDatestring (date-time)Data final para filtrar os custos (obrigatório)

Exemplo cURL:

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/tolkyReasoning/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álidos
  • 401: Token de autenticação inválido ou ausente
  • 404: Dados não encontrados
  • 500: 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