> ## 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 una imagen desde una URL

> Envía una imagen para clasificarla como humana o artificial.

🔁 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. Consulta [Clasifica una imagen](/es/api-reference/classification/submit-an-image-for-classification) para ver la lista de tipos MIME admitidos y los límites de tamaño.



## OpenAPI

````yaml es/api-reference/api-swagger-dev-documentation.json POST /api/image_fromurl
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/image_fromurl:
    post:
      tags:
        - Classification
      summary: Clasifica una imagen desde una URL
      description: |-
        Envía una imagen para clasificarla como humana o artificial.

        🔁 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. Consulta [Clasifica una imagen](/es/api-reference/classification/submit-an-image-for-classification) para ver la lista de tipos MIME admitidos y los límites de tamaño.
      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:
                file_url:
                  type: string
                  description: La URL de la imagen que se va a clasificar.
                ref_id:
                  type: string
                  description: >-
                    ID de referencia opcional que se asocia a la solicitud de
                    clasificación.
                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_tampering:
                  type: boolean
                  description: >-
                    Establécelo en true si también quieres analizar signos de
                    manipulación realizados sin la ayuda de una IA generativa
                with_heatmap:
                  type: boolean
                  description: >-
                    Establécelo en true si también quieres obtener una heatmap
                    de los contenidos generados por IA.
                with_smart_analysis:
                  type: boolean
                  description: >-
                    Establécelo en true para activar la **Smart Full Analysis**:
                    un algoritmo de scoring propietario selecciona las áreas más
                    informativas de la imagen, 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**: no se puede
                    combinar con `with_heatmap`, y enviar ambas opciones en true
                    devuelve un error `422`. **Para usarla debe estar habilitada
                    en tu plan de precios**; si no, el parámetro se ignora.
                    Consulta [Smart Full
                    Analysis](/es/classification/classify-image#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). 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).
                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 la imagen en las
                    que se centraron durante la clasificación (attention map y
                    attention graph). **Para usarlo debe estar habilitado en tu
                    plan de precios**; si no, el parámetro se ignora. Consulta
                    [XAI – eXplainable
                    AI](/es/classification/classify-image#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.
                    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).
              required:
                - file_url
      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, la validación de la
            URL ha fallado, la descarga ha fallado o el tipo de archivo no es
            compatible.
          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.
                validation_error:
                  summary: Ejemplo de error de validación
                  value:
                    error: The file_url 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
                      50Mb.
        '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
        '422':
          description: >-
            La solicitud contiene opciones incompatibles: `with_smart_analysis`
            y `with_heatmap` no pueden estar ambas en true, porque la Smart Full
            Analysis ya sustituye al análisis con heatmap.
        '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.