POST /v1/humanize
Un request, una respuesta clara: envías el texto y recibes la versión humanizada y los valores de IA. El mismo Humanizer que en el navegador, ahora en tu código.
El idioma se detecta y se mantiene automáticamente: español y más de 40 adicionales. Se factura el número exacto de palabras de entrada medidas.
Crear clave de APIConsultar la documentación
Regístrate gratis · Facturación por palabras de entrada · Sin permanencia mínima
curl https://api.studytexter.com/v1/humanize \
-H "Authorization: Bearer $STUDYTEXTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "La digitalización plantea a las empresas..."}'{
"humanized_text": "Las empresas se enfrentan, debido a la digitalización, a muy...",
"ai_detection": {
"original": { "ai_percent": 81.58, "human_mixed_percent": 18.42 },
"humanized": { "ai_percent": 3.83, "human_mixed_percent": 96.17 }
}
}
Valores de IA en cada llamada – Detectores conocidos de, entre otros:
Fundamentos
La Humanizer API es una interfaz REST a través de la cual se revisan programáticamente textos de ChatGPT, Claude, Gemini o DeepSeek para que suenen más naturales (conocida como AI Humanizer API en inglés o KI-Humanizer-API en alemán). Humanizar texto por API significa que envías un POST con tu texto a /v1/humanize y recibes la versión humanizada, además de los valores de detección de IA para ambas versiones como un valor medido. Detrás de esto se ejecuta el mismo reconocimiento de idioma, la misma medición de palabras y el mismo procesamiento que en el humanizador de IA del navegador; no existe una versión reducida para desarrolladores.
Integración
Sin SDK, sin entrevista de onboarding, sin especificar el idioma. La API REST solo necesita una clave, un endpoint y un campo obligatorio en el body.
Crear clave
Regístrate, ve a la página de claves en la app y crea una clave. El secreto completo se mostrará una sola vez.
Enviar texto
Haz un POST a /v1/humanize con Authorization: Bearer y un body JSON que solo contenga text. No envíes una especificación de idioma, ya que se detecta automáticamente.
Procesar la respuesta
Recibirás humanized_text y los valores de IA para el original y el resultado. En caso de error, error.retryable decide si se permite un segundo intento.
curl --request POST 'https://api.studytexter.com/v1/humanize' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"text":"La digitalización plantea a las empresas múltiples desafíos, ya que los procesos existentes deben ser revisados y reestructurados. Un uso responsable de la IA sigue exigiendo un trabajo de fuentes meticuloso y un juicio propio."}'El texto de ejemplo completo, el archivo OpenAPI y la versión en Markdown para agentes se encuentran en la documentación.
Agentes
Un agente que genera texto necesita el Humanizer como herramienta, no como sitio web. Hay tres cosas decisivas cuando ya no hay nadie supervisando.
Registrar como Tool
Un endpoint, un campo obligatorio, sin opciones. La definición de la herramienta cabe en unas pocas líneas y se puede configurar en LangChain, en el SDK de Anthropic, en n8n o en un loop propio.
En flujos de varios pasos
El agente genera texto con un modelo, lo envía a través de /v1/humanize y reenvía el resultado. El idioma sigue siendo el del borrador, sin que el flujo de trabajo necesite conocerlo.
Repetir sin doble facturación
Cada error indica a través de error.retryable si es seguro volver a intentarlo. Si la conexión se interrumpe sin respuesta, una Idempotency-Key se encarga de la deduplicación: la misma clave con el mismo texto devuelve la respuesta guardada en lugar de una segunda facturación.
{
"name": "humanize_text",
"description": "Revisa un borrador de IA para que suene más natural. El idioma se detecta y se mantiene. Los números, nombres, fuentes y términos técnicos se conservan.",
"input_schema": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "El texto a revisar. De 100 a 30.000 caracteres, máximo 3.000 palabras."
}
},
"required": ["text"]
}
}Un agente no necesita más. No hay campos de idioma, tono o intensidad que pueda configurar incorrectamente, y por lo tanto, no hay grados de libertad que puedan causar un fallo silencioso en la ejecución. La descripción completa está disponible adicionalmente como OpenAPI 3.1 y como llms.txt; ambos se pueden presentar directamente a un modelo.
Casos de uso
En todos los casos en que un modelo redacta el borrador, pero una persona figura como remitente.
Herramientas de escritura
Tu editor genera un borrador mediante un LLM y lo envía a través de la API antes de mostrarlo. Tus usuarios ven el resultado, no el paso intermedio.
Pipelines de contenido
Los flujos de redacción y publicación añaden la llamada después de la generación. El rendimiento se obtiene de 60 trabajos en paralelo, no de textos individuales más largos.
Frameworks de agentes
LangChain, CrewAI, el SDK de Anthropic o un loop propio: el endpoint es una herramienta más entre otras y no necesita un tratamiento especial.
SEO y marketing
Textos para blogs, descripciones de productos, newsletters. Lo que un modelo ha redactado se publica como texto corrido, sin que nadie tenga que pulirlo a mano.
Plataformas académicas
Entornos de aprendizaje y herramientas de escritura cuyos usuarios trabajan con fuentes. Las referencias, los números de página y los términos técnicos se mantienen palabra por palabra, que es precisamente el punto en el que la mayoría de los humanizadores fallan.
White-Label y SaaS
Humanizar como una función propia en tu producto, bajo tu nombre. La facturación se realiza a través de tu cuenta de StudyTexter; tus usuarios no ven nada de esto.
Diferencias
No porque sea más rápida que otras, sino porque tiene menos puntos en los que algo puede fallar silenciosamente.
El idioma se detecta, no se especifica
No envías ningún campo `language`. El idioma dominante del texto de entrada se detecta y se mantiene en la respuesta: más de 40 idiomas. Un parámetro mal configurado no puede estropearte nada.
Valores de IA para ambas versiones
La respuesta contiene las probabilidades del detector para el texto original y para el resultado. Puedes mostrar o registrar en tu producto lo que ha cambiado, sin necesidad de una segunda herramienta.
Las fuentes se mantienen palabra por palabra
Las citas, los números de página, los nombres de los autores y los años no se reformulan. Esta es la razón por la que la API se puede utilizar en productos académicos.
Facturación por palabras de entrada
Se cuenta el texto que envías, con segmentación ICU en una copia normalizada NFC. La longitud de la respuesta no afecta al precio.
El mismo motor que en el navegador
573,7 millones de palabras humanizadas y más de 63.573 usuarios pasan por el mismo procesamiento. Lo que la API entrega, puedes comprobarlo en la interfaz.
Actualizaciones del modelo incluidas
Las mejoras en el procesamiento llegan a la API al mismo tiempo que a la interfaz. No tienes que cambiar nada en tu integración para ello.
Precios
La API no tiene tarifas propias. Utiliza el mismo saldo que la herramienta en el navegador: suscripción o compra única, ambas opciones son válidas para las dos vías.
GPTZero clasifica nuestros textos como más humanos que los textos reales de estudiantes (Ø 84 % vs. 80 %).
Más de 573,7 mill. de palabras humanizadasStudent
14,99€al mes
5,00€ / 10.000 palabrasLa garantía se aplica al escáner de IA GPTZero: si tu texto humanizado es detectado allí como IA, te reembolsaremos las palabras consumidas. Basta con un breve mensaje al servicio de soporte.
Iniciar suscripciónO comprar una sola vez
Starter
9,99€pago único
12,49€ / 10.000 palabrasStandard
34,99€pago único
8,75€ / 10.000 palabrasPower
69,99€pago único
7,78€ / 10.000 palabrasA través de la API pública solo se utilizan palabras de pago: el cupo de la suscripción y los paquetes comprados. El cupo mensual gratuito solo es válido para la interfaz web.
Enterprise a partir de 150.000 palabras/mes
Precios personalizados para agencias, ghostwriters e integraciones de herramientas. Responde brevemente a cuatro puntos y nos pondremos en contacto en 24 horas.
Pago seguro a través de Stripe · cancelable en cualquier momento, sin permanencia mínima
Respuesta
Un campo con el resultado, un objeto con los valores medidos. No se necesita más estructura.
{
"humanized_text": "…",
"ai_detection": {
"original": {
"human_mixed_percent": 18.42,
"human_percent": 8.29,
"mixed_percent": 10.13,
"ai_percent": 81.58
},
"humanized": {
"human_mixed_percent": 96.17,
"human_percent": 83.04,
"mixed_percent": 13.13,
"ai_percent": 3.83
}
}
}humanized_text
La versión revisada en el idioma del texto de entrada. La estructura y la longitud se mantienen cercanas al original.
ai_detection.original
Las probabilidades para el texto que has enviado: ai_percent, human_percent, mixed_percent y human_mixed_percent.
ai_detection.humanized
Los mismos cuatro valores para el resultado. La comparación de ambos objetos es la comprobación de antes y después de la interfaz web.
X-Request-ID
Header que registras en el log. Con él, el equipo de soporte puede asociar una ejecución individual sin que tengas que volver a enviar tu texto.
Los valores de IA son probabilidades de clase, no proporciones de frases, y no constituyen una prueba. Los detectores también clasifican incorrectamente textos humanos. Algunos valores pueden ser nulos si no hay una medición disponible; tu integración debe estar preparada para ello.
Lo que se mantiene
Se modifican la sintaxis, las transiciones y la elección de palabras. El contenido del que tu producto es responsable se mantiene.
Significado
Las afirmaciones siguen siendo afirmaciones. No se añade nada que no estuviera en el texto de entrada.
Números e identificadores
Números de expediente, DOIs, ISBNs, números de artículo: las cadenas de caracteres se conservan, no se reescriben.
Nombres y nombres propios
Las personas, instituciones, productos y lugares conservan su ortografía.
Cifras, datos y unidades
Los valores medidos se mantienen sin redondear, sin convertir y en su lugar.
Términos técnicos y abreviaturas
La terminología no se sustituye por una palabra cotidiana solo porque suene más común.
Registro y tratamiento
Formal o informal, sobrio o narrativo: el nivel de lenguaje del texto de entrada se mantiene.
Facturación
La API no tiene tarifas propias. Utiliza el mismo saldo con el que también funciona la herramienta en el navegador.
Se facturan las palabras de entrada
Se cuenta exactamente el texto que envías. La longitud de la respuesta no influye en el precio.
A través de la API se utilizan palabras de pago
El cupo mensual gratuito es válido para la interfaz web. La API pública accede exclusivamente al saldo de pago.
Rechazado no significa facturado
Las solicitudes que fallan por un límite no se ponen en cola ni se cobran. En caso de errores repetibles, la reserva se libera de nuevo.
Sin segundo contrato
El saldo y la suscripción se gestionan a través de tu cuenta existente y se pueden cancelar allí. No hay ningún coste adicional por la API.
curl 'https://api.studytexter.com/v1/balance' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY"
{
"balance": {
"subscription": null,
"subscription_words_remaining": 0,
"purchased_words_remaining": 12000,
"total_api_words_available": 12000
}
}Seguridad
Cuatro puntos que deben aclararse antes de la integración.
La clave permanece en el lado del servidor
stx_live_… debe guardarse en un Secret-Manager, no en bundles de navegador, aplicaciones móviles, URL, prompts o logs. Edita el encabezado Authorization antes de registrar las solicitudes en el log.
Visible una vez, revocable en cualquier momento
El secreto completo se muestra una sola vez al crearlo. La creación, el listado y la revocación se realizan exclusivamente a través de la página de claves con la sesión iniciada.
Una clave, muchos trabajos
La misma clave autentica cualquier número de trabajos, de forma consecutiva o en paralelo. La Idempotency-Key es otra cosa: un identificador de trabajo, no un secreto.
No entrenamos con tus textos
Tus textos se procesan para el trabajo. No los utilizamos para entrenar modelos de IA.
Preguntas
Una interfaz REST que te permite revisar textos de IA de forma programática para que suenen más naturales. Un POST a /v1/humanize con tu texto, y recibes la versión humanizada y los valores de detección de IA para ambas versiones. Detrás funciona el mismo procesamiento que en el humanizador de IA del navegador.
En cuanto al contenido, sí. Detrás de la API del humanizador de IA se encuentran el mismo reconocimiento de idioma, la misma medición de palabras y el mismo procesamiento que en el humanizador de IA de la interfaz web. Las únicas diferencias son el acceso (token Bearer en lugar de inicio de sesión) y el saldo: a través de la API pública solo se utilizan palabras de pago.
Como herramienta. Registras una definición de herramienta con un único campo obligatorio (el texto) y el agente la llama cuando se necesita revisar una salida. Esto funciona igual en LangChain, CrewAI, el SDK de Anthropic o en un loop propio. Para los modelos, las descripciones también están disponibles como OpenAPI 3.1, como Markdown y como llms.txt.
Regístrate gratis o inicia sesión, abre la página de claves en la app y crea una clave. Verás el secreto completo una sola vez; cópialo inmediatamente en tu Secret-Manager. Puedes revocarla allí en cualquier momento.
A través de un token Bearer en el encabezado Authorization: Authorization: Bearer stx_live_… La misma clave es válida para /v1/humanize y /v1/balance y puede autenticar muchos trabajos de forma consecutiva o en paralelo. Debe usarse exclusivamente en código del lado del servidor.
Con texto de todos los modelos habituales: ChatGPT, Claude, Gemini, DeepSeek, Llama, Mistral y otros. La API recibe texto, no el nombre de un modelo: lo que cuenta son los patrones en el borrador, no su origen.
No lo prometemos. La API proporciona una formulación más natural y, además, los valores de IA medidos para el original y el resultado. Estos valores son probabilidades de clase de un detector, no una prueba ni una garantía. Los detectores cambian sus modelos, llegan a conclusiones diferentes según el proveedor y también clasifican incorrectamente textos puramente humanos. Lo que obtienes es una comparación comprensible del antes y el después que puedes mostrar o registrar en tu producto.
No, y tampoco puedes. El idioma dominante del texto de entrada se detecta y se mantiene en la respuesta (alemán y más de 40 otros). La API no acepta un campo `language`.
Sí. Se factura el número exacto de palabras de entrada medidas, independientemente de la longitud de la respuesta. A través de la API pública solo se utilizan palabras de pago; el cupo mensual gratuito es válido para la interfaz web. Puedes consultar el estado actual con GET /v1/balance.
Sí, por usuario: 60 nuevos trabajos por cada 60 segundos, 60 en procesamiento simultáneo y 30 consultas de saldo por minuto. Las solicitudes que superen estos límites serán rechazadas con un 429, no se pondrán en cola ni se facturarán. Si está disponible, Retry-After indica el tiempo de espera.
En caso de un error con error.retryable=true, la reserva ha sido liberada, por lo que un nuevo intento es seguro. Si la conexión se interrumpe por completo sin respuesta, no conoces el resultado: para este caso existe la Idempotency-Key opcional. Con la misma clave y el mismo texto, obtendrás la respuesta guardada en lugar de una segunda facturación.
El uso se gestiona y factura a través de tu cuenta de StudyTexter, incluso si son tus propios usuarios quienes activan la llamada. Las condiciones contractuales aplicables se encuentran en nuestros Términos y Condiciones; para volúmenes mayores o preguntas sobre el uso, contáctanos previamente.
Crea tu clave y envía el primer request
POST /v1/humanize · Facturación por palabras de entrada · Sin permanencia mínima