AI Humanizer API
Humaniza texto con IA en tu producto con una sola llamada REST. La API de humanización con IA expone a tu backend el motor que impulsa TextPulse: entra JSON, sale prosa reescrita, en más de 60 idiomas.
Realizar tu primera solicitud
Autentícate con un encabezado Authorization: Bearer y envía tu texto. La versión reescrita se devuelve como outputText junto con las cifras de medición de esa llamada.
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}Qué gestiona por ti la API de humanización con IA
El enrutamiento de idioma, el control de registro, la medición y la seguridad ante reintentos forman parte del endpoint, de modo que tu integración sigue siendo una sola función.
Una sola ruta cubre más de 60 idiomas
El inglés usa el motor de humanización ajustado. Pasa un valor de idioma y la solicitud se enruta a la vía multilingüe, de modo que una página de producto en otro idioma llega al mismo endpoint sin una segunda integración.
El registro y la intensidad son parámetros
Cinco modos de escritura cubren los registros Academic, Corporate, Creative, Blog/SEO y General. El valor intensityScalar establece cuán distinta es la reescritura respecto al original y toma uno de 0, 0.25, 0.5, 0.75 o 1, desde Mild, pasando por el valor predeterminado Balanced en 0.5, hasta Aggressive.
Una sola POST por documento
No hay una cola de trabajos que consultar ni un webhook que registrar. La llamada humanize mantiene la conexión hasta que el modelo responde y devuelve el texto reescrito, de modo que una sola solicitud completa el trabajo.
Los reintentos no se cobran dos veces
Envía un requestId y el resultado se almacena en caché durante aproximadamente diez minutos. Repetir el mismo identificador dentro de esa ventana reproduce la respuesta almacenada en lugar de ejecutar el modelo de nuevo, y cualquier solicitud que el motor no logre completar devuelve sus palabras automáticamente a tu saldo.
Referencia del endpoint
Authorization: Bearer. Las claves comienzan por tp_live_ y se emiten por proyecto./api/v1/humanize/api/v1/balanceUna sola llamada humanize acepta hasta 1,000 palabras dentro de un límite de 10,000 caracteres, y cada clave puede emitir 60 solicitudes por minuto. Los documentos más largos se envían como una secuencia de llamadas.
Parámetros de solicitud
Solo text es obligatorio. Todo lo demás tiene un valor predeterminado razonable, así que la integración mínima es un solo campo.
| Parámetro | Type | Presencia | Notas |
|---|---|---|---|
text | string | Obligatorio | El texto que se va a humanizar. Hasta 1,000 palabras dentro de un límite de 10,000 caracteres por solicitud. |
writingMode | string | Predeterminado: Academic | Uno de Academic, Corporate, Creative, Blog/SEO o General. Establece el registro que mantiene la reescritura. |
intensityScalar | number | Predeterminado: 0.5 | Uno de 0, 0.25, 0.5, 0.75 o 1. Hasta qué punto la reescritura se aleja de la fuente, desde Mild hasta Balanced y Aggressive. |
language | string | Opcional | Dirige el texto no inglés a la ruta multilingüe. Omítalo, o envíe inglés, para el motor de inglés ajustado con precisión. |
englishVariant | string | Opcional | Americano o británico. Mantiene la ortografía y el vocabulario a un lado del Atlántico. |
freezeTerms | string[] | Opcional | Hasta 10 términos o frases conservados literalmente durante la reescritura: nombres de constructos, instrumentos, nombres de productos. |
removeEmDashes | boolean | Opcional | Reescribe las construcciones con guion largo en puntuación convencional. |
requestId | string | Recomendado | Su token de idempotencia. Repetirlo dentro de unos diez minutos reproduce la respuesta almacenada en lugar de cobrar de nuevo. |
Campos de respuesta
outputTextEl texto humanizado.metrics.inputWords / outputWordsPalabras recibidas y palabras devueltas. Las reescrituras suelen ser ligeramente más largas que la fuente.metrics.wordsChargedLo que costó la llamada. Siempre equivale al recuento de entrada, nunca al recuento de salida.metrics.balanceRemainingCréditos de palabras restantes en la clave después de esta llamada, para que pueda medir sin una segunda solicitud.metrics.modelLatencyMs / routeTiempo del motor para la reescritura y la ruta que la atendió.Errores y reintentos
Cada error devuelve JSON con un error.code estable y un mensaje legible por humanos. La regla en torno a la cual conviene diseñar: solo se le cobra por una reescritura que se haya entregado, y reintentar con el mismo requestId siempre es seguro.
UNAUTHORIZEDClave de API ausente o no reconocida. Compruebe el encabezado Authorization: Bearer.INSUFFICIENT_BALANCENo hay suficientes créditos de palabras en la clave. La respuesta incluye el saldo disponible.REQUEST_IN_PROGRESSUna solicitud con este requestId aún está en proceso. Espere en lugar de competir con ella.TOO_LONG / VALIDATION_FAILEDLa entrada supera el límite de 1,000 palabras o un parámetro tiene un formato incorrecto. La respuesta enumera los problemas exactos.ENGINE_ERROREl motor falló o agotó el tiempo de espera. Las palabras ya se han devuelto a su saldo; vuelva a intentarlo con el mismo requestId.El motor detrás del endpoint
Cada llamada ejecuta el motor publicado de TextPulse, medido en un corpus académico de 2.000 documentos y vuelto a ejecutar a medida que se actualizan los modelos de detección. Tasas de baja puntuación por detector:
Cifras medidas por el proveedor, publicadas con su corpus. Ningún humanizador puede prometer el resultado de un detector en un documento específico, así que construya la mensajería de su producto sobre la medición, nunca sobre una garantía.
En qué se apoyan los equipos con la API de humanización
EdTech y plataformas de escritura
Añada una acción de humanizar junto a sus funciones existentes de gramática o paráfrasis. El modo Académico mantiene intactas las citas, de modo que las herramientas orientadas a estudiantes no tienen que eliminar las referencias antes de enviar el texto.
Herramientas de documentación y corrección
Procese documentos completos en fragmentos de 1.000 palabras y vuelva a ensamblarlos. Freeze terms mantiene estables los nombres y la terminología entre fragmentos, y los reintentos idempotentes hacen que los flujos por lotes puedan ejecutarse de nuevo con seguridad.
Productos de contenido y SEO
El modo Blog/SEO reescribe los borradores en prosa publicable mientras freeze terms bloquea las palabras clave objetivo, de modo que el texto conserva su intención de búsqueda y pierde el ritmo mecánico.
Socios de marca blanca
El endpoint se ejecuta de forma invisible dentro de su producto: su interfaz, su facturación, nuestro motor. Los acuerdos de colaboración se cotizan según el volumen mensual a través del formulario de acceso.
Precios de la API de humanización con IA
Los créditos se pagan por adelantado y se consumen por palabra. La facturación cuenta lo que usted envía, nunca lo que devuelve el motor, y cualquier llamada que no produzca una reescritura se acredita de nuevo a la clave.
Los créditos son válidos durante 12 meses desde la compra y cubren todos los idiomas, modos de escritura y variantes del inglés que admite el endpoint. Para un volumen sostenido o un acuerdo de marca blanca dentro de su propio producto, solicite acceso y le cotizaremos en función de su cifra mensual.
Obtenga su clave de API
Las claves se emiten por proyecto. Describa lo que está construyendo y le responderemos en un plazo de 24 horas.