API REST / reescritura de texto

API del Humanizador de IA para reescrituras naturales y editables

Envía un borrador, elige un modelo de humanización y recibe una nueva versión dentro de tu flujo de trabajo. Puedes editarla, compararla y aprobarla antes de publicarla.

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/humanize/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: humanizer-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to rewrite.",
    "model": "cognia"
  }'

Solicitudes POST a /api/humanize/

Autenticación mediante X-API-Key

Idempotency-Key del cliente para reintentos seguros

Cuatro modelos compatibles

Uso de palabras en cada respuesta

Un paso de reescritura que tú controlas

Mantén el texto original, la reescritura y la edición final en un solo flujo

Una integración útil no oculta lo que ha cambiado. Guarda el original, solicita una reescritura y ofrece al editor un lugar claro donde comparar ambas versiones antes de aprobar el resultado.

Entrada JSON simple

Envía el borrador y el nombre de un modelo compatible. La respuesta devuelve texto sin formato, el modelo utilizado y el número de palabras procesadas.

La elección del modelo permanece explícita

Selecciona cognia, lexi, cognia_v2 o huma_v2 según el comportamiento que tu equipo haya probado con su propio contenido.

Editable por diseño

Devuelve el texto obtenido a un editor, una cola de revisión o un sistema de contenidos, en lugar de tratarlo como un resultado definitivo.

Contrato de la solicitud

Envía el borrador e indica el modelo

Ambos campos son obligatorios en el endpoint REST. Conserva la selección del modelo en la configuración para probarla y cambiarla sin reescribir la integración.

Campo	Tipo	Requerido	Qué hace
text	string	Sí	El texto que quieres que reescriba el servicio.
model	string	Sí	Uno de cognia, lexi, cognia_v2 o huma_v2.

Tres campos facilitan el seguimiento del resultado

Usa humanized_text como resultado editable. Guarda también model_used y words_processed para que los equipos de soporte, facturación y contenido entiendan cómo se procesó la solicitud.

Ejemplo de respuesta

{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 8,
  "model_used": "cognia"
}

Flujo de integración

Trata la humanización como una fase de edición

El flujo de trabajo más sólido mantiene visible el original y solicita a una persona que apruebe la nueva versión.

1
Protege la clave de API
Guarda la clave en tu servidor o en un gestor de secretos. No la incluyas en el código público del navegador ni en un documento compartido.
2
Envía el texto con un modelo probado
Elige un modelo compatible, conserva un Idempotency-Key único antes del envío y reutiliza esa clave solo para repetir exactamente la misma solicitud.
3
Revisa y aprueba
Verifica la exactitud, el significado, el tono y la terminología requerida del texto reescrito antes de guardarlo o publicarlo.

Casos de uso adecuados

Una opción práctica para productos que ya tienen un editor

La humanización resulta más útil cuando el borrador ya está en revisión. La API añade una opción de reescritura sin sustituir a las personas responsables del texto final.

Una reescritura puede cambiar el significado

Los nombres, citas, cifras, lenguaje legal y términos técnicos merecen una revisión cuidadosa. Mantén esos detalles visibles para el revisor.

Gestión de contenidos

Ofrece una acción de reescritura dentro de un CMS y devuelve el resultado al mismo borrador para compararlo y aprobarlo.

Operaciones de soporte

Reescribe material original aprobado como texto de ayuda más claro y somételo después a la revisión habitual de hechos y políticas.

Colas editoriales

Añade una versión alternativa junto al original para que un editor pueda conservar, combinar o rechazar cambios concretos.

Herramientas de escritura privadas

Llama al servicio desde un backend de confianza y muestra únicamente el texto devuelto que necesita la persona autenticada.

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 Humanizador de IA?+

Envía una solicitud POST a https://api.detecting-ai.com/api/humanize/. Usa JSON, pasa tu clave en X-API-Key y conserva un Idempotency-Key estable por cada operación lógica para que puedas reintentarla de forma segura.

¿Qué modelos de humanización están disponibles?+

Los valores admitidos son cognia, lexi, cognia_v2 y huma_v2. La API REST espera el campo model en cada solicitud.

¿Qué contiene la respuesta?+

Una respuesta correcta contiene humanized_text, words_processed y model_used. El texto reescrito sigue siendo editable dentro de tu producto.

¿Debe publicarse la respuesta de la API sin revisarla?+

No. Revisa el significado, los datos, el tono, los nombres, los enlaces y cualquier expresión que deba ser exacta. Una reescritura puede mejorar la fluidez y aun así necesitar un editor.

¿Cómo se cuenta el uso del humanizador?+

El uso se calcula a partir del número de palabras de entrada y se descuenta del saldo del humanizador asociado a la suscripción de la API. Las respuestas correctas incluyen words_processed.

Prepara la primera solicitud

Prueba la reescritura de un texto que conoces bien

Empieza con un modelo, compara el resultado con el texto original y decide qué comprobaciones necesitan tus editores antes de lanzar la función.

Abrir la documentación de la API Comparar precios