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

# Valida un archivo multimedia

> Comprueba si un archivo de imagen, vídeo o audio puede analizarse, **sin enviarlo a clasificación**: el archivo no se guarda, no se inicia ninguna clasificación y **no se consumen créditos**.

El archivo se comprueba frente a los requisitos de los modelos que lo analizarían. Estos modelos se determinan exactamente igual que en los endpoints de clasificación, a partir de tu plan de precios y de las opciones enviadas con la solicitud: para obtener un resultado significativo, envía las mismas opciones (p. ej., `with_morphing`, `with_heatmap`, `with_audio`) que vayas a usar en el envío real.

Las comprobaciones realizadas son:

- **Tipo y tamaño del archivo**: los mismos formatos y límites del endpoint de clasificación correspondiente ([imagen](./submit-an-image-for-classification), [vídeo](./submit-a-video-for-classification), [audio](./submit-a-speech-for-classification)).
- **Resolución mínima** (imágenes y vídeos): el lado corto del medio debe cumplir el tamaño mínimo exigido por cada modelo seleccionado.
- **Resolución mínima de vídeo** (solo vídeo): la altura del vídeo debe cumplir la resolución mínima admitida por la plataforma (p. ej., 720p).

El resultado se indica siempre en el campo `valid` de la respuesta: `true` con estado `200` cuando el medio puede analizarse, `false` con estado `422` o `413` cuando no, junto con un `detail` que explica el motivo.



## OpenAPI

````yaml es/api-reference/api-swagger-dev-documentation.json POST /api/validate
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/validate:
    post:
      tags:
        - Classification
      summary: Valida un archivo multimedia
      description: >-
        Comprueba si un archivo de imagen, vídeo o audio puede analizarse, **sin
        enviarlo a clasificación**: el archivo no se guarda, no se inicia
        ninguna clasificación y **no se consumen créditos**.


        El archivo se comprueba frente a los requisitos de los modelos que lo
        analizarían. Estos modelos se determinan exactamente igual que en los
        endpoints de clasificación, a partir de tu plan de precios y de las
        opciones enviadas con la solicitud: para obtener un resultado
        significativo, envía las mismas opciones (p. ej., `with_morphing`,
        `with_heatmap`, `with_audio`) que vayas a usar en el envío real.


        Las comprobaciones realizadas son:


        - **Tipo y tamaño del archivo**: los mismos formatos y límites del
        endpoint de clasificación correspondiente
        ([imagen](./submit-an-image-for-classification),
        [vídeo](./submit-a-video-for-classification),
        [audio](./submit-a-speech-for-classification)).

        - **Resolución mínima** (imágenes y vídeos): el lado corto del medio
        debe cumplir el tamaño mínimo exigido por cada modelo seleccionado.

        - **Resolución mínima de vídeo** (solo vídeo): la altura del vídeo debe
        cumplir la resolución mínima admitida por la plataforma (p. ej., 720p).


        El resultado se indica siempre en el campo `valid` de la respuesta:
        `true` con estado `200` cuando el medio puede analizarse, `false` con
        estado `422` o `413` cuando no, junto con un `detail` que explica el
        motivo.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - image
                    - video
                    - audio
                  description: >-
                    El tipo de medio que se va a validar. La validación de vídeo
                    y audio requiere la misma habilitación que los endpoints de
                    clasificación correspondientes.
                file:
                  type: string
                  format: binary
                  description: >-
                    El archivo multimedia que se va a validar. Los formatos
                    admitidos y el tamaño máximo dependen de `type` y son los
                    mismos del endpoint de clasificación correspondiente:
                    [imagen](./submit-an-image-for-classification),
                    [vídeo](./submit-a-video-for-classification),
                    [audio](./submit-a-speech-for-classification).
                with_morphing:
                  type: boolean
                  description: >-
                    Solo imágenes y vídeos. Establécelo en true para validar el
                    archivo también frente a los modelos usados para analizar
                    las caras de las personas (morphing).
                with_tampering:
                  type: boolean
                  description: >-
                    Solo imágenes y vídeos. Establécelo en true para validar el
                    archivo también frente a los modelos usados para analizar
                    signos de manipulación.
                with_heatmap:
                  type: boolean
                  description: >-
                    Solo imágenes. Establécelo en true para validar el archivo
                    también frente a los modelos usados para generar la heatmap
                    de contenidos generados por IA.
                with_nsfw:
                  type: boolean
                  description: >-
                    Solo imágenes y vídeos. Establécelo en true para validar el
                    archivo también frente a los modelos usados para detectar
                    contenidos NSFW (Not Safe For Work).
                with_audio:
                  type: boolean
                  description: >-
                    **[BETA]** Solo vídeo. Establécelo en true para validar el
                    archivo también frente a los modelos usados para analizar la
                    pista de audio del vídeo. **Para usarlo debe estar
                    habilitado en tu plan de precios**; si no, el parámetro se
                    ignora.
              required:
                - type
                - file
      responses:
        '200':
          description: >-
            El medio es válido y puede enviarse a clasificación con las opciones
            indicadas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaValidation'
              examples:
                image:
                  summary: Imagen válida
                  value:
                    valid: true
                    filesize: 1048576
                    mimetype: image/jpeg
                    width: 1920
                    height: 1080
                    models:
                      - image_model_a
                      - image_model_b
                audio:
                  summary: Audio válido
                  value:
                    valid: true
                    filesize: 524288
                    mimetype: audio/mpeg
                    width: null
                    height: null
                    models:
                      - audio_model_a
        '400':
          description: >-
            La solicitud contiene parámetros incorrectos: `type` ausente o no
            admitido, `file` ausente, o un archivo cuyo formato o tamaño no se
            acepta para el `type` indicado.
          content:
            application/json:
              examples:
                invalid_type:
                  value:
                    error:
                      type:
                        - The selected type is invalid.
                missing_file:
                  value:
                    error:
                      file:
                        - The file field is required.
                invalid_image_format:
                  value:
                    error:
                      file:
                        - >-
                          The file must be a file of type: png, jpg, jpeg, gif,
                          webp, tif, tiff.
                not_a_video:
                  value:
                    error:
                      file:
                        - The file must be a video file.
        '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, no ha aceptado
            los Términos del servicio o no está habilitado para la clasificación
            del `type` de medio solicitado (vídeo o audio).
          content:
            application/json:
              example:
                error: Unauthorized
        '413':
          description: >-
            El medio no es válido: el tamaño del archivo supera el máximo
            permitido para el `type` solicitado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaValidationError'
              example:
                valid: false
                detail: >-
                  The image file size (73400320 bytes) exceeds the maximum
                  allowed size of 52428800 bytes.
        '422':
          description: >-
            El medio no es válido y no puede analizarse con las opciones
            indicadas (p. ej., archivo dañado, resolución demasiado baja para
            los modelos seleccionados), o en tu plan de precios no hay modelos
            disponibles para las opciones seleccionadas.
          content:
            application/json:
              examples:
                corrupted_file:
                  summary: Archivo dañado
                  value:
                    valid: false
                    detail: >-
                      Invalid or corrupted image file: cannot identify image
                      file
                quality_requirements:
                  summary: Resolución demasiado baja para los modelos seleccionados
                  value:
                    valid: false
                    detail: >-
                      Media does not meet the quality requirements for the
                      requested models: 'image_model_a' requires a minimum size
                      of 256px, got 128px.
                video_resolution:
                  summary: Resolución de vídeo demasiado baja
                  value:
                    valid: false
                    detail: >-
                      Video resolution too low: got 640x360, minimum required
                      height is 720px (720p).
                not_an_audio:
                  summary: No es un archivo de audio
                  value:
                    valid: false
                    detail: >-
                      Invalid file type. Must be an audio file: sample.mp3,
                      application/octet-stream
                no_models:
                  summary: No hay modelos disponibles para las opciones seleccionadas
                  value:
                    message: No available models for the selected options
        '429':
          description: Demasiadas solicitudes.
          content:
            application/json:
              example:
                message: Too Many Attempts.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    MediaValidation:
      type: object
      properties:
        valid:
          type: boolean
          description: >-
            Siempre `true` en una validación correcta: el medio puede enviarse a
            clasificación con las opciones indicadas.
        filesize:
          type: integer
          description: Tamaño del archivo validado, en bytes.
        mimetype:
          type: string
          description: >-
            Tipo MIME detectado a partir del contenido del archivo (p. ej.,
            `image/jpeg`, `video/mp4`, `audio/mpeg`).
        width:
          type: integer
          nullable: true
          description: Anchura del medio en píxeles. `null` para los archivos de audio.
        height:
          type: integer
          nullable: true
          description: Altura del medio en píxeles. `null` para los archivos de audio.
        models:
          type: array
          description: >-
            Identificadores de los modelos frente a los que se ha validado el
            medio, determinados a partir de tu plan de precios y de las opciones
            seleccionadas.
          items:
            type: string
      required:
        - valid
        - filesize
        - mimetype
        - models
    MediaValidationError:
      type: object
      properties:
        valid:
          type: boolean
          description: >-
            Siempre `false`: el medio no puede analizarse con las opciones
            indicadas.
        detail:
          type: string
          description: Motivo legible por el que el medio no es válido.
      required:
        - valid
        - detail
  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.