API REST / detección de IA

API del detector de IA para señales listas para revisión

Envía texto a un endpoint HTTPS e incorpora el análisis de escritura con IA a tu producto. Detector v3 devuelve datos estructurados que tu equipo puede revisar, guardar y explicar en contexto.

Crear una clave de API Leer la documentación

Usa la clave de un entorno de servidor privado.

Solicitud cURL

curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

Solicitudes POST a /api/detect/

Autenticación mediante X-API-Key

Idempotency-Key del cliente para reintentos seguros

Detector v3 para nuevas integraciones

Solicitud y respuesta JSON

Diseñado para flujos de revisión reales

Un contrato de API sencillo que deja espacio al criterio humano

La integración es sencilla: tu servidor envía el texto, el detector lo analiza y tu interfaz decide cómo presentar el resultado. Esta separación facilita las pruebas y deja la decisión final en manos de una persona.

Un endpoint específico

Añade una cadena de texto y la versión del detector a una solicitud JSON. La integración básica no depende de un SDK que haya que mantener sincronizado.

Salida estructurada

Lee los detalles del detector, la versión y el número de palabras procesadas directamente en la respuesta, sin extraer datos de una página web.

La revisión humana sigue presente

Usa la señal para priorizar fragmentos y casos. No conviertas la puntuación de un modelo en una acusación ni en un rechazo automático.

Contrato de la solicitud

Dos campos son suficientes para comenzar

Envía texto UTF-8 como JSON y elige expresamente la versión del detector. Las nuevas integraciones deben usar v3.

Campo	Tipo	Requerido	Qué hace
text	string	Sí	El texto que quieres que analice el detector.
version	string	Sí	Versión del detector. Usa v3 para una nueva integración.

Conserva la respuesta completa durante el desarrollo

Empieza registrando la respuesta JSON completa en un entorno de prueba seguro. Cuando entiendas el contrato, asigna solo los campos que usa tu producto y conserva el número de palabras procesadas para tus registros de uso.

Ejemplo de respuesta

{
  "success": true,
  "data": {
    "details": {
      "result": "Detector analysis is returned here"
    },
    "version": "v3",
    "words_processed": 8
  }
}

Flujo de integración

De la clave de API a un resultado útil

Crea primero la solicitud en tu servidor. Añade la interfaz del producto cuando estén claros tanto el flujo correcto como los casos de error.

1
Prepara, guarda y activa la clave
Prepara una clave en el panel, copia el valor que se muestra una sola vez en un gestor de secretos del servidor, confirma que la clave esté guardada y actívala. El valor completo no vuelve a mostrarse después de la activación.
2
Envía una muestra representativa
Envía mediante POST un texto realista con la versión v3 y conserva un Idempotency-Key único antes del envío. Reutilízalo solo para repetir exactamente la misma solicitud.
3
Presenta las evidencias con cuidado
Convierte la respuesta estructurada en un estado de revisión claro y deja espacio para que una persona examine el texto y su contexto.

Casos de uso adecuados

Útil donde el texto ya pasa por una cola de revisión

La API funciona mejor como una señal dentro de un proceso de decisión existente. Debe ayudar a decidir dónde mirar, no decidir por las personas.

La detección no es prueba de autoría

Los modelos pueden equivocarse, sobre todo con textos breves, muy editados, traducidos o estereotipados. No dejes decisiones importantes en manos de flujos totalmente automáticos.

Recepción editorial

Añade una señal de autoría a los borradores recibidos y envía los casos atípicos a un editor para que los examine con más detalle.

Plataformas educativas

Devuelve una señal de revisión junto al contexto de la tarea, el historial de revisión, las citas y la política propia de la institución.

Moderación interna

Comprueba el texto recibido dentro de un flujo privado sin enviar tu clave de API al navegador.

Clasificación por lotes

Procesa documentos en cola desde el servidor y muestra los casos que merecen una segunda revisión manual.

Preguntas frecuentes sobre la API

Respuestas prácticas antes del lanzamiento

Empieza con una solicitud desde el servidor, registra la estructura de la respuesta y después añade el resultado a tu flujo de revisión.

¿Qué endpoint usa la API del detector de IA?+

Envía una solicitud POST a https://api.detecting-ai.com/api/detect/. El cuerpo de la solicitud es JSON, la autenticación usa X-API-Key y las nuevas integraciones deben conservar un Idempotency-Key estable para cada operación lógica.

¿Qué versión de detector debería utilizar una nueva integración?+

Usa v3 para nuevas integraciones. La versión se proporciona en el cuerpo de la solicitud JSON, por lo que el comportamiento es explícito y fácil de probar.

¿Puedo llamar a la API directamente desde JavaScript en el navegador?+

No expongas una clave privada de API en el código del navegador. Envía las solicitudes desde tu servidor, una función de edge u otro entorno de confianza y devuelve solo los datos que necesita tu interfaz.

¿Una puntuación de IA prueba quién escribió el texto?+

No. La detección de IA es una señal probabilística. Úsala para orientar la revisión hacia un texto concreto y después considera los borradores, las fuentes, el historial de edición y el contexto.

¿Dónde puedo consultar el uso de la API y el saldo de palabras?+

El panel de la API muestra el saldo asociado a tu suscripción. Cada solicitud correcta del detector indica cuántas palabras de entrada se procesaron.

Prepara la primera solicitud

Haz una solicitud de prueba antes de diseñar el flujo de trabajo

Usa Detector v3, conserva la clave en tu servidor e inspecciona la respuesta JSON completa con un texto parecido a tus datos reales.

Abrir la documentación de la API Comparar precios