Explorar documentación

Documentación de API de TurnitPass

Empieza con claves de API y llama a los endpoints del Humanizer, paráfrasis, AI Detector, Citation Generator y Bibliography para integrar TurnitPass en tu propio producto de escritura.

REST API v1

One request

Quick example

Envía texto al endpoint humanizer con una clave API Bearer. La respuesta devuelve el resultado transformado, las palabras usadas y el saldo restante del titular de la clave.

curl

POST /api/v1/humanize

1curl -X POST https://turnitpass.com/api/v1/humanize \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'

response

200 OK

1{
2  "output": "Your humanized text...",
3  "words_used": 6,
4  "words_remaining": 249994
5}

TurnitPass también expone los endpoints paraphrase, rewrite, detector, citation, bibliography y status con el mismo flujo de clave API.

Route map

Explore the docs

Inicio rápido

Crea una clave de API en tu espacio de trabajo y luego llama a los endpoints de revisión, detección y citas con esa clave.

Autenticación

Las solicitudes de desarrollo utilizan claves de API generadas desde el espacio de trabajo de TurnitPass.

Referencia de API

Referencia de los endpoints autenticados del Humanizer, paráfrasis, AI Detector, Citation Generator, Bibliography y estado de la clave de API.

Historial

Cambios recientes en la revisión de textos, comprobación de señales, herramientas de escritura, facturación y API.

Realiza tu primera solicitud de revisión

Crea una clave y envía la primera solicitud.

API REST de TurnitPass

Revisa endpoints, parámetros, límites y formas de respuesta.

Siguiente paso

Request lifecycle

Cada llamada a la API de TurnitPass sigue el mismo recorrido: autenticar la clave, validar el payload, ejecutar el flujo de escritura o citas, medir el uso y devolver una forma de respuesta que tu producto pueda almacenar.

Autenticar la clave API

Envía una clave generada en el espacio de trabajo. Las claves revocadas, malformadas o ausentes fallan antes de procesar el texto.

Validar texto, idioma y límites

Las solicitudes de transformación aplican rangos de palabras, las de detector aplican límites de escaneo más largos y las de citation validan estilo y fuente.

Ejecutar el flujo

Las rutas humanize, paraphrase, rewrite, detect, citation y bibliography reutilizan el mismo comportamiento de servidor que las herramientas públicas.

Registrar el uso y devolver el resultado

Las llamadas correctas devuelven la salida más metadatos de uso: palabras usadas, saldo restante, estado o exportaciones de citas formateadas.

API

Endpoints principales

Revisar

POST/api/v1/humanize

Reduce patrones de escritura tipo IA conservando el significado.

Parafrasear

POST/api/v1/paraphrase

Reescribe y perfecciona texto en múltiples modos.

Comprobar

POST/api/v1/detect

Devuelve puntuaciones estimadas, nivel de riesgo y patrones de escritura.

Citas

POST/api/v1/citation

Formatea metadatos de fuentes DOI, URL o ingresados manualmente.

Production checklist

Llamadas en el servidor

Nunca expongas claves API en el clienteLlama a TurnitPass desde tu backend, worker, cola o server action protegida.

Reintentos

Reintenta fallos de red, no de validaciónTrata las respuestas 4xx como problemas de usuario o payload y reserva los reintentos para errores 5xx o de red transitorios.

Presupuesto de palabras

Muestra el saldo antes de flujos pesadosUsa el endpoint status para decidir si poner en cola, pedir una mejora o dividir el documento.

Facturación

Los secretos de Stripe son la configuración finalCheckout, portal y webhook ya están conectados; las claves live y los price ID se dejan para el despliegue.

En integraciones de producto, usa una clave TurnitPass por entorno. Producción, staging y desarrollo local deben poder revocarse por separado.

Después, intégralo en tu flujo de trabajo.Seguir leyendo