> ## 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.

# Override de la clasificación de un audio

> Envía un override para la clasificación de un audio. El parámetro hash identifica de forma unívoca el archivo de audio enviado. Si el mismo audio (por tanto, el mismo hash) se sube varias veces, el override se aplica a todos los envíos que comparten este hash.



## OpenAPI

````yaml es/api-reference/api-swagger-dev-documentation.json POST /api/classification_audio/{hash}/override
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/classification_audio/{hash}/override:
    post:
      tags:
        - Classification
      summary: Override de la clasificación de un audio
      description: >-
        Envía un override para la clasificación de un audio. El parámetro hash
        identifica de forma unívoca el archivo de audio enviado. Si el mismo
        audio (por tanto, el mismo hash) se sube varias veces, el override se
        aplica a todos los envíos que comparten este hash.
      parameters:
        - name: hash
          in: path
          required: true
          schema:
            type: string
          description: El hash del audio.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                classification:
                  type: string
                  enum:
                    - human
                    - artificial
                  description: La clasificación correcta.
              required:
                - classification
      responses:
        '201':
          description: Override creado correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  classification:
                    type: string
                    enum:
                      - human
                      - artificial
                    description: La clasificación del override.
                  type:
                    type: string
                    enum:
                      - audio
                    description: El tipo de contenido.
                  hash:
                    type: string
                    description: El hash del audio.
                required:
                  - classification
                  - type
                  - hash
              example:
                classification: human
                type: audio
                hash: >-
                  89ff6bc9ec8ed4b9fe5489353432b1553ac8efe5e26f247f71d75e0da181870f
        '400':
          description: >-
            El usuario no tiene créditos suficientes para realizar la operación,
            la solicitud contiene parámetros incorrectos o el medio no ha
            superado los controles de validación.
          content:
            application/json:
              examples:
                validation_required:
                  summary: El campo de clasificación es obligatorio
                  value:
                    classification:
                      - The classification field is required.
                validation_invalid:
                  summary: Valor de clasificación no válido
                  value:
                    classification:
                      - The selected classification is invalid.
                no_request:
                  summary: Ninguna solicitud asociada a este hash
                  value:
                    error: You haven't got any request for this content.
                already_submitted:
                  summary: Override ya enviado
                  value:
                    error: You have already submitted a report for this content.
                not_classified:
                  summary: Contenido aún no clasificado
                  value:
                    error: This audio was not classified yet.
                no_longer_possible:
                  summary: Override ya no aceptado
                  value:
                    error: Is no longer possible to send a report for this audio.
        '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:
  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.