> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Utilisation des appels

> Calcule l’utilisation agrégée pour plusieurs appels racine, avec agrégation des descendants.



## OpenAPI

````yaml /fr/weave/reference/service-api/openapi.json post /calls/usage
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security: []
paths:
  /calls/usage:
    post:
      tags:
        - Calls
      summary: Utilisation des appels
      description: >-
        Calcule l’utilisation agrégée pour plusieurs appels racine, avec
        agrégation des descendants.
      operationId: calls_usage_calls_usage_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CallsUsageReq'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallsUsageRes'
          description: Réponse réussie
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Erreur de validation
      security:
        - HTTPBasic: []
        - HTTPBearer: []
components:
  schemas:
    CallsUsageReq:
      additionalProperties: false
      description: "Requête pour calculer l’utilisation agrégée de plusieurs appels racine.\n\nCet endpoint renvoie les métriques d’utilisation pour chaque appel racine demandé, où les métriques de chaque racine incluent la somme de sa propre utilisation et de celle de tous ses descendants.\n\nRemarque\_: tous les appels correspondants sont chargés en mémoire pour l’agrégation. Pour des ensembles de résultats très volumineux (>10k appels), envisagez de traiter les ID des appels racine par lots ou d’utiliser des filtres plus restrictifs au niveau de l’application."
      properties:
        call_ids:
          description: >-
            ID des appels racine à agréger. Chaque clé de résultat correspond à
            un ID d’appel en entrée.
          items:
            type: string
          title: Call Ids
          type: array
        include_costs:
          default: false
          description: >-
            Si la valeur est true, inclure les calculs de coût dans
            l’utilisation.
          title: Include Costs
          type: boolean
        limit:
          default: 10000
          description: >-
            Nombre maximal d’appels à traiter sur l’ensemble des traces. Sert de
            limite de sécurité pour éviter une utilisation de mémoire non
            bornée.
          title: Limit
          type: integer
        project_id:
          title: Project Id
          type: string
      required:
        - project_id
        - call_ids
      title: CallsUsageReq
      type: object
    CallsUsageRes:
      description: Réponse contenant les métriques d’utilisation agrégées par appel racine.
      properties:
        call_usage:
          additionalProperties:
            additionalProperties:
              $ref: '#/components/schemas/LLMAggregatedUsage'
            type: object
          title: Call Usage
          type: object
        unfinished_call_ids:
          items:
            type: string
          title: Unfinished Call Ids
          type: array
      title: CallsUsageRes
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    LLMAggregatedUsage:
      description: Métriques d'utilisation agrégées pour un LLM donné.
      properties:
        cache_creation_input_tokens:
          default: 0
          title: Cache Creation Input Tokens
          type: integer
        cache_creation_input_tokens_total_cost:
          anyOf:
            - type: number
            - type: 'null'
          title: Cache Creation Input Tokens Total Cost
        cache_read_input_tokens:
          default: 0
          title: Cache Read Input Tokens
          type: integer
        cache_read_input_tokens_total_cost:
          anyOf:
            - type: number
            - type: 'null'
          title: Cache Read Input Tokens Total Cost
        completion_tokens:
          default: 0
          title: Completion Tokens
          type: integer
        completion_tokens_total_cost:
          anyOf:
            - type: number
            - type: 'null'
          title: Completion Tokens Total Cost
        prompt_tokens:
          default: 0
          title: Prompt Tokens
          type: integer
        prompt_tokens_total_cost:
          anyOf:
            - type: number
            - type: 'null'
          title: Prompt Tokens Total Cost
        requests:
          default: 0
          title: Requests
          type: integer
        total_tokens:
          default: 0
          title: Total Tokens
          type: integer
      title: LLMAggregatedUsage
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    HTTPBasic:
      scheme: basic
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````