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

# Obtén los resultados de varias clasificaciones de audio

> Obtiene los resultados de varias clasificaciones de audio a partir de una lista de identificadores.



## OpenAPI

````yaml es/api-reference/api-swagger-dev-documentation.json GET /api/classifications_audio
openapi: 3.0.0
info:
  title: API de identifAI
  version: 1.0.0
  description: >-
    API para integrar las funcionalidades de clasificación de imágenes y vídeos
    de identifAI.<br><details><summary>**Cómo obtener tu API key**</summary>Para
    obtener tu API key, sigue estos sencillos pasos:   <ol><li><p>**Crea un
    perfil de usuario y accede a la plataforma**</p>Si todavía no tienes una
    cuenta, visita nuestra plataforma y crea un perfil de usuario. Después de
    completar el registro y verificar tu correo electrónico, accede con tus
    credenciales.</li><li><p>**Abre el menú de usuario**</p>Después de acceder,
    haz clic en tu nombre o en el icono de usuario en la esquina superior
    derecha de la pantalla.</li><li><p>**Selecciona la opción API key**</p>En el
    menú desplegable que aparece, selecciona la opción "Api-Key". Desde allí
    puedes ver o generar tu API key.</li></ol>¡Ya puedes usar tu API key con
    nuestra API!</details><details><summary>**Cómo usar la API**</summary>Para
    usar la API, realiza primero una solicitud **POST** para iniciar la
    clasificación. Después usa el ***identificador*** devuelto por la solicitud
    **POST** para obtener los resultados.

    <details>

    <summary>**1. Clasificación de imágenes**</summary>
      * Para clasificar una imagen, realiza una solicitud **POST** a `/api/classification` con los parámetros obligatorios (para más detalles sobre los parámetros, consulta la sección *"Clasificación"* más abajo).
      * En la respuesta recibirás el ***identificador*** de la imagen clasificada.
      * Usa el ***identificador*** recibido para obtener los resultados de la clasificación con una solicitud **GET** a `/api/classification/{identifier}` (para más detalles sobre cómo estructurar la solicitud, consulta la sección *"Clasificación"* más abajo).
      * La respuesta contiene los resultados de la clasificación de la imagen en formato JSON.<br>En la respuesta encontrarás un array ***results***, con los resultados de la clasificación de cada modelo usado, y un array ***verdicts***, con los resultados de cada heurística aplicada.<br>Si la clasificación aún no se ha completado, sigue enviando la solicitud **GET** hasta que el resultado esté disponible.</details><details><summary>**2. Clasificación de vídeos**</summary>
        * Para clasificar un vídeo, realiza una solicitud **POST** a `/api/classification_video` con los parámetros obligatorios (para más detalles sobre los parámetros, consulta la sección *"Clasificación"* más abajo).
        * En la respuesta recibirás el ***identificador*** del vídeo clasificado.
        * Usa el ***identificador*** recibido para obtener los resultados de la clasificación con una solicitud **GET** a `/api/classification_video/{identifier}` (para más detalles sobre cómo estructurar la solicitud, consulta la sección *"Clasificación"* más abajo).
        * La respuesta contiene los resultados de la clasificación del vídeo en formato JSON. Para la clasificación, el vídeo se divide en *frames*.<br> En la respuesta encontrarás un array ***results***, con el resultado de la clasificación de cada modelo aplicado a cada frame analizado, y un array ***verdicts***, con los resultados de cada heurística usada.<br> Si la clasificación no se ha completado, sigue enviando la solicitud **GET** hasta que se devuelvan los resultados finales.</details><details><summary>**3. Todas las clasificaciones**</summary>El endpoint `/api/classifications` devuelve todas las clasificaciones de imágenes realizadas por un usuario, con los resultados de todas las solicitudes de clasificación de imágenes anteriores.</details><details><summary>**4. Gestión de usuarios**</summary>  El endpoint **POST** `/api/user` permite crear un usuario, mientras que el endpoint **DELETE** `/api/user` sirve para eliminar un usuario (para la estructura de las solicitudes, consulta la sección de usuarios más abajo).</details></details>
servers:
  - url: https://backend.identifai.net
security: []
tags:
  - name: Classification
    description: Rutas de clasificación
  - name: Infrastructure
    description: Rutas de infraestructura
  - name: User
    description: Acciones del usuario
  - name: Partner
    description: Acciones de los partners
paths:
  /api/classifications_audio:
    get:
      tags:
        - Classification
      summary: Obtén los resultados de varias clasificaciones de audio
      description: >-
        Obtiene los resultados de varias clasificaciones de audio a partir de
        una lista de identificadores.
      parameters:
        - name: identifiers[]
          in: query
          required: true
          schema:
            type: array
            items:
              type: string
            maxItems: 100
          description: >-
            Lista de los identificadores cuyas clasificaciones se quieren
            obtener.
      responses:
        '200':
          description: Lista de clasificaciones de audio.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AudioResponse'
        '400':
          description: Faltan los identificadores o hay demasiados.
          content:
            application/json:
              examples:
                missing_identifiers:
                  value:
                    error:
                      identifiers:
                        - The identifiers field is required
                too_many_identifiers:
                  value:
                    error:
                      identifiers:
                        - The identifiers may not have more than 100 items
        '401':
          description: API key no válida o ausente.
          content:
            application/json:
              example:
                error: Unauthorized
        '403':
          description: >-
            El usuario no está autorizado a acceder a esta API o no ha aceptado
            los Términos del servicio.
          content:
            application/json:
              example:
                error: Forbidden
        '429':
          description: Demasiadas solicitudes.
          content:
            application/json:
              example:
                error: Too Many Attempts.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    AudioResponse:
      type: object
      description: La respuesta de la clasificación de un audio
      properties:
        hash:
          type: string
          description: Hash SHA-256 del archivo de audio clasificado
        identifier:
          type: string
          description: El identificador del audio clasificado
        api_version:
          type: string
          nullable: true
          description: >-
            La versión de la API en el momento del análisis (disponible desde la
            **v1.1.0**). El valor se establece cuando termina el análisis.
        status:
          $ref: '#/components/schemas/Status'
          description: >-
            El estado de procesamiento de la solicitud de clasificación
            (disponible desde la **v1.1.0**)
        deferred_status:
          type: string
          enum:
            - pending
            - inprogress
            - done
            - errored
            - skipped
            - expired
          description: >-
            Estado de los **resultados diferidos** (pasos ejecutados después de
            los resultados principales, p. ej., las explicaciones textuales de
            los mapas XAI y de la heatmap). Solo está presente cuando el envío
            tiene resultados diferidos: `pending` (el análisis principal sigue
            en curso), `inprogress`, `done`, `errored` (al menos un paso
            diferido ha fallado, los resultados principales siguen siendo
            válidos), `skipped` (el análisis principal ha fallado), `expired`
            (no completados a tiempo; aún pueden pasar a `done` o `errored` más
            tarde). Nunca cambia `status`: un envío está en `done` antes que sus
            resultados diferidos.
        deferred_progress:
          type: object
          nullable: true
          description: >-
            Progreso de los resultados diferidos, presente junto con
            `deferred_status`.
          properties:
            current_idx:
              type: integer
              description: Pasos diferidos completados hasta ahora
            total:
              type: integer
              description: Total de pasos diferidos
        deferred_errors:
          type: array
          items:
            type: string
          description: >-
            Mensajes públicos de los pasos diferidos que han fallado, presentes
            junto con `deferred_status`.
        errors:
          type: string
          nullable: true
          description: >-
            Los mensajes de error si el estado es 'errored' (disponible desde la
            **v1.1.0**)
        name:
          type: string
          description: El nombre del archivo de audio clasificado
        ref_id:
          type: string
          description: >-
            ID de referencia opcional que se asocia a la solicitud de
            clasificación.
        result_url:
          type: string
          format: uri
          description: >-
            URL en la que se encuentran los resultados de la clasificación en la
            dashboard
        verdict:
          $ref: '#/components/schemas/Verdict'
          description: >-
            El veredicto de clasificación principal, calculado con la heurística
            predeterminada del usuario
        verdicts:
          type: array
          items:
            $ref: '#/components/schemas/Verdict'
          description: Array de los veredictos de todas las heurísticas disponibles
        force_classification:
          type: string
          enum:
            - human
            - artificial
          nullable: true
          description: >-
            Si está presente, indica que el usuario ha forzado la clasificación
            al valor indicado
        results:
          type: array
          items:
            $ref: '#/components/schemas/Result'
          description: >-
            Resultados detallados de la clasificación de cada modelo de
            detección de IA
        details:
          $ref: '#/components/schemas/MediaDetails'
          description: >-
            Detalles del análisis del audio por segmento: cada entrada
            representa un clip extraído del audio enviado
    Status:
      type: string
      enum:
        - new
        - done
        - errored
    Verdict:
      type: object
      description: La respuesta final de la clasificación para la heurística considerada
      properties:
        models:
          type: array
          items:
            type: string
            description: Nombre del modelo
          description: Array de los modelos usados
        heuristic:
          type: string
          description: >-
            Nombre de la heurística usada (p. ej., 'Majority', 'Average',
            'AverageExcludeObsolete', 'TopRelevant')
        confidence:
          type: number
          description: La confianza del resultado de la clasificación de 0 a 1
        classification:
          type: string
          enum:
            - human
            - artificial
          description: El resultado final de la clasificación con la heurística indicada
      required:
        - heuristic
        - confidence
        - classification
    Result:
      type: object
      description: >-
        La puntuación obtenida en cada categoría (humano o artificial) por el
        modelo usado
      properties:
        model:
          type: string
          description: El nombre del modelo de detección de IA usado para la clasificación
        unknown:
          type: boolean
          description: >-
            Indica si el modelo no ha podido clasificar la imagen con seguridad
            (se ha detectado incertidumbre)
        elapsed_time:
          type: number
          description: El tiempo empleado en la clasificación, en segundos
        classification:
          type: array
          items:
            type: object
            properties:
              label:
                type: string
                description: Categoría
                enum:
                  - human
                  - artificial
              score:
                type: number
                description: Puntuación de 0 a 1
          description: Array de las puntuaciones de clasificación de cada categoría
        classification_details:
          type: object
          description: Detalles adicionales sobre el proceso de clasificación
    MediaDetails:
      type: object
      description: Contenedor de los detalles del análisis por segmento
      properties:
        clips:
          type: array
          items:
            $ref: '#/components/schemas/ClipDetail'
          description: >-
            Array de los resultados del análisis de cada segmento (clip)
            extraído del archivo multimedia enviado
      required:
        - clips
    ClipDetail:
      type: object
      description: >-
        Información detallada sobre el análisis de un clip concreto (segmento de
        audio o de vídeo)
      properties:
        index:
          type: integer
          description: El índice del clip en la secuencia
        start:
          type: number
          description: Inicio del clip, en segundos
        end:
          type: number
          description: Fin del clip, en segundos
        results:
          type: array
          items:
            $ref: '#/components/schemas/Result'
          description: >-
            Resultados detallados de la clasificación de cada modelo de
            detección de IA para este clip
        verdict:
          $ref: '#/components/schemas/Verdict'
          description: El veredicto de clasificación de este clip concreto
      required:
        - index
        - start
        - end
        - results
        - verdict
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: X-Api-Key
      in: header
      description: Tu API key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.