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

# Clasifica un vídeo

> Envía un vídeo para su clasificación

🔁 El formato de la respuesta depende del header `Accept`:

`Accept: application/json` → `{ "identifier": "..." }`

 Otros valores (p. ej., `text/plain`) → texto plano con solo la cadena del identificador.



## OpenAPI

````yaml es/api-reference/api-swagger-dev-documentation.json POST /api/classification_video
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_video:
    post:
      tags:
        - Classification
      summary: Clasifica un vídeo
      description: |-
        Envía un vídeo para su clasificación

        🔁 El formato de la respuesta depende del header `Accept`:

        `Accept: application/json` → `{ "identifier": "..." }`

         Otros valores (p. ej., `text/plain`) → texto plano con solo la cadena del identificador.
      parameters:
        - name: Accept
          in: header
          description: >-
            Tipo de contenido de la respuesta. Valores admitidos:
            application/json, text/plain.
          required: false
          schema:
            type: string
            enum:
              - application/json
              - text/plain
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                video:
                  type: string
                  format: binary
                  description: >-
                    El vídeo que se va a clasificar. **Formatos admitidos:**
                    cualquier formato de vídeo (MP4, AVI, MOV, etc.). **Tipos
                    MIME:** cualquier tipo MIME que empiece por 'video/' (p.
                    ej., video/mp4, video/avi, video/quicktime). **Tamaño máximo
                    del archivo:** 50MB.
                ref_id:
                  type: string
                  description: >-
                    ID de referencia opcional que se asocia a la solicitud de
                    clasificación.
                frames:
                  type: integer
                  enum:
                    - 5
                    - 10
                    - 30
                  description: Elige clasificar como máximo 5, 10 o 30 frames.
                key_frames:
                  type: boolean
                  description: >-
                    Si se establece en true, extrae los keyframes y los usa para
                    la clasificación en lugar de imágenes a una distancia de
                    tiempo fija. Los keyframes extraídos pueden ser menos que
                    los `frames` solicitados. Se ignora cuando se indica
                    `ensure_face_per_frame` o `frames_timestamps`.
                key_frames_method:
                  type: string
                  enum:
                    - iframes
                    - flow
                    - color
                  description: >-
                    Algoritmo de identificación de keyframes. Los valores
                    posibles son **iframes** (predeterminado), **flow** y
                    **color**.
                     - `iframes` : extrae los iframes del vídeo; 
                     - `color` : devuelve el frame medio, según el color, de cada secuencia de plano. Las *secuencias de plano* son grupos de frames que empiezan con un iframe; 
                     - `flow` : devuelve el frame más estático respecto al frame anterior de cada secuencia de plano.
                with_tampering:
                  type: boolean
                  description: >-
                    Establécelo en true si también quieres analizar en la imagen
                    signos de manipulación realizados sin la ayuda de una IA
                    generativa.
                with_morphing:
                  type: boolean
                  description: >-
                    Establécelo en true si también quieres analizar las caras de
                    las personas de la imagen con morphing.
                with_audio:
                  type: boolean
                  description: >-
                    **[BETA]** Establécelo en true si también quieres analizar
                    la pista de audio del vídeo. **Para usar esta opción debe
                    estar habilitada en tu plan de precios**.
                with_smart_analysis:
                  type: boolean
                  description: >-
                    Establécelo en true para activar la **Smart Full Analysis**
                    en cada frame analizado: un algoritmo de scoring propietario
                    selecciona las áreas más informativas del frame, que se
                    clasifican como recortes separados con el modelo más
                    avanzado de la familia Revelio y luego se combinan en un
                    veredicto global. Al ser una versión avanzada e inteligente
                    de ambos, **sustituye al análisis completo estándar y al
                    análisis con heatmap de los frames**. **Para usarla debe
                    estar habilitada en tu plan de precios**; si no, el
                    parámetro se ignora. Consulta [Smart Full
                    Analysis](/es/classification/classify-video#smart-full-analysis)
                    para más detalles.
                webhook_url:
                  type: string
                  description: >-
                    Si se indica, el resultado de la clasificación también se
                    envía automáticamente a la URL introducida. Si no, el
                    resultado se obtiene mediante polling del [endpoint
                    correspondiente](./get-classification-result-video). Ten en
                    cuenta que para usar una URL de callback del webhook **debes
                    solicitar una habilitación específica**; si no, el parámetro
                    se ignora. Además, el sistema puede guardar en caché los
                    resultados de los análisis de envíos repetidos, es decir,
                    envíos del mismo archivo con las mismas opciones: en este
                    caso no se llama al webhook y los resultados solo están
                    accesibles mediante polling del [endpoint
                    correspondiente](./get-classification-result-video).
                with_xai:
                  type: boolean
                  description: >-
                    Establécelo en true para activar el scope **XAI –
                    eXplainable AI**: además del veredicto, los modelos Revelio
                    devuelven información sobre las áreas de cada frame
                    analizado en las que se centraron durante la clasificación
                    (attention map y attention graph). XAI se aplica a cada
                    frame analizado. **Para usarlo debe estar habilitado en tu
                    plan de precios**; si no, el parámetro se ignora. Consulta
                    [XAI – eXplainable
                    AI](/es/classification/classify-video#xai-explainable-ai)
                    para más detalles. **Aviso sobre la transferencia de
                    datos:** al activar esta funcionalidad, los datos de tus
                    imágenes se transfieren a nuestra infraestructura cloud en
                    la UE para la inferencia de los modelos.
                with_llm_xai:
                  type: boolean
                  description: >-
                    Establécelo en true, junto con `with_xai`, para obtener
                    también las **explicaciones impulsadas por IA**: una
                    descripción en lenguaje natural de las regiones que
                    recibieron más atención, devuelta en el campo `description`
                    de las `explanations` de los resultados por modelo cuando
                    los [resultados
                    diferidos](/es/api-reference/deferred-results) están listos.
                    Las explicaciones se generan para cada frame analizado. Se
                    ignora si `with_xai` no está activado. Si XAI está incluido
                    en tu plan de precios pero las explicaciones impulsadas por
                    IA no, una solicitud con `with_llm_xai=true` se rechaza con
                    un error `403`. Los créditos de las explicaciones que no se
                    pueden generar se reembolsan. Las explicaciones impulsadas
                    por IA se generan con modelos no desarrollados por
                    identifAI.
                llm_xai_language:
                  type: string
                  enum:
                    - english
                    - italian
                    - spanish
                    - german
                  description: >-
                    Idioma de las explicaciones impulsadas por IA (sin
                    distinguir entre mayúsculas y minúsculas). Si se omite, se
                    usa el idioma predeterminado de tu plan de precios. Solo se
                    aplica junto con `with_llm_xai`; un valor no admitido se
                    rechaza con un error `400`.
                deferred_webhook_url:
                  type: string
                  description: >-
                    Si se indica, la URL se notifica una sola vez cuando los
                    **resultados diferidos** del envío están completos (p. ej.,
                    las explicaciones textuales de los mapas XAI y de la
                    heatmap), después de los resultados principales enviados a
                    `webhook_url`. La notificación lleva el evento
                    `submission.deferred.completed`: consulta [Resultados
                    diferidos](/es/api-reference/deferred-results) para ver el
                    payload. Se aplican la misma habilitación, las mismas
                    restricciones de dominio y la misma autenticación que en
                    `webhook_url`. La entrega es *at least once*: deduplica por
                    `identifier`, y ten en cuenta que una notificación `expired`
                    puede ir seguida de una segunda con el resultado real, que
                    la sustituye. Si se omite o está vacía, no se envía ninguna
                    notificación de resultados diferidos.
                no_cache:
                  type: boolean
                  description: >-
                    Establécelo en true para obligar al sistema a volver a
                    procesar la imagen aunque ya se haya enviado con las mismas
                    opciones. Esto puede suponer costes adicionales.
                prevent_c2pa_forces:
                  type: boolean
                  description: >-
                    Si es true, la firma C2PA no fuerza el origen a artificial.
                    Si es false o no está definido, la firma C2PA fuerza el
                    origen a artificial (comportamiento actual).
                with_nsfw:
                  type: boolean
                  description: >-
                    Establécelo en true si también quieres activar la detección
                    de contenidos NSFW (Not Safe For Work).
                ensure_face_per_frame:
                  type: boolean
                  description: >-
                    **[Funcionalidad del plan]** Establécelo en true para elegir
                    la estrategia de extracción de frames con **caras**: a
                    partir del muestreo a intervalos regulares, el sistema busca
                    en el vídeo frames que contengan al menos una cara, hasta el
                    número de frames que hay que analizar (`frames`). Úsalo
                    junto con la opción `with_morphing` para detectar posibles
                    face swaps o morphing en el vídeo. Es una alternativa a las
                    demás estrategias: cuando está activado, `key_frames` y
                    `key_frames_method` se ignoran, mientras que él mismo se
                    ignora cuando se indica `frames_timestamps`. La búsqueda
                    tiene un límite de tiempo, así que en los vídeos en los que
                    las caras son escasas o no aparecen es posible que se
                    analicen menos frames: los frames no analizados se
                    reembolsan al terminar el análisis. Esta opción **puede
                    aumentar el tiempo de procesamiento** y, según tu plan de
                    precios, el coste de cada frame. **Para usar esta opción
                    debe estar habilitada en tu plan de precios**; si no, el
                    parámetro se ignora.
                frames_timestamps:
                  type: string
                  example: 00:00:05.000,00:01:12.500
                  description: >-
                    **[Funcionalidad del plan]** Momentos específicos del vídeo
                    que se van a analizar. Lista de timecodes separados por
                    comas en formato `HH:MM:SS.mmm`, medidos desde el inicio del
                    archivo (p. ej., `00:00:05.000,00:01:12.500`). Cuando se
                    indica, se extrae exactamente un frame en cada momento
                    indicado y las demás estrategias de extracción de frames se
                    desactivan: `frames`, `key_frames`, `key_frames_method` y
                    `ensure_face_per_frame` se ignoran. Los momentos duplicados
                    se cuentan una sola vez. Puedes indicar hasta **30**
                    momentos si tu plan de precios te permite elegir el número
                    de frames; si no, hasta el número de frames predeterminado
                    (**10**). **Se cobra un frame por cada momento distinto.**
                    Los momentos posteriores al final del vídeo se omiten: si
                    ninguno cae dentro del vídeo, la clasificación termina con
                    un error. **Para usar esta opción debe estar habilitada en
                    tu plan de precios**; si no, el parámetro se ignora.
                audio_timestamps:
                  type: string
                  example: 00:00:05.000,00:01:12.500
                  description: >-
                    **[Funcionalidad del plan]** Momentos específicos de la
                    pista de audio del vídeo que se van a analizar. Lista de
                    timecodes separados por comas en formato `HH:MM:SS.mmm`,
                    medidos desde el inicio del archivo (p. ej.,
                    `00:00:05.000,00:01:12.500`). Solo se usa junto con
                    `with_audio`. Cuando se indica, en lugar de dividir el audio
                    en segmentos a lo largo de toda su duración, el sistema
                    analiza un breve segmento de audio centrado en cada momento
                    indicado; los momentos lo bastante cercanos como para caer
                    en el mismo segmento se analizan juntos en un único
                    segmento. Los momentos duplicados se cuentan una sola vez.
                    Puedes indicar hasta **30** momentos si tu plan de precios
                    te permite elegir el número de segmentos de audio; si no,
                    hasta **5**. **Se cobra un segmento de audio por cada
                    momento distinto**: los segmentos que no se generan
                    (momentos agrupados, momentos posteriores al final del
                    audio) se reembolsan al terminar el análisis. Si ningún
                    momento cae dentro del audio, la clasificación termina con
                    un error. **Para usar esta opción debe estar habilitada en
                    tu plan de precios**; si no, el parámetro se ignora.
              required:
                - video
            encoding:
              video:
                contentType: video/*
      responses:
        '200':
          description: >-
            El identificador de la clasificación. El formato depende del header
            Accept.
          content:
            application/json:
              schema:
                type: object
                properties:
                  identifier:
                    type: string
                    example: >-
                      8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0
              example:
                identifier: >-
                  8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0
            text/plain:
              schema:
                type: string
                example: >-
                  8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0
              example: 8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0
        '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:
                invalid_llm_xai_language:
                  summary: Idioma de las explicaciones impulsadas por IA no admitido
                  value:
                    error:
                      llm_xai_language:
                        - The selected llm xai language is invalid.
                invalid_timestamps:
                  summary: Timestamps no válidos
                  value:
                    error:
                      frames_timestamps:
                        - >-
                          The frames timestamps must be a comma-separated list
                          of timecodes in HH:MM:SS.mmm format.
                validation_error:
                  summary: Ejemplo de error de validación
                  value:
                    video:
                      - The video field is required.
                unsupported_format:
                  summary: Formato de archivo no compatible
                  value:
                    error: The uploaded file format is not supported.
                file_too_large:
                  summary: Archivo demasiado grande
                  value:
                    error: The uploaded file exceeds the maximum allowed size of 5GB.
        '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, o `with_llm_xai` se estableció en true
            pero las explicaciones impulsadas por IA de XAI no están incluidas
            en tu plan.
          content:
            application/json:
              examples:
                forbidden:
                  summary: Acceso denegado
                  value:
                    error: Forbidden
                llm_xai_not_enabled:
                  summary: Explicaciones impulsadas por IA no habilitadas
                  value:
                    error: >-
                      LLM explanations (with_llm_xai) are not enabled for your
                      plan
        '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.