Saltar al contenido
TurnitPass
DesarrolladoresAPI v1Obtener una clave API
Explorar documentación

DesarrolladoresDocumentación técnica

Documentación de API de TurnitPass

Comienza con claves de API y llama a los endpoints para revisar, parafrasear, comprobar señales, crear citas y generar bibliografías dentro de tu propio software.

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
curl -X POST https://turnitpass.com/api/v1/humanize \
  -H "Authorization: Bearer tp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'
response
200 OK
{
  "output": "Your humanized text...",
  "words_used": 6,
  "words_remaining": 249994
}
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

01

Inicio rápido

Crea una clave de API en la consola y luego llama a los endpoints de redacción, comprobación y citas con la misma clave.

02

Autenticación

Las solicitudes de desarrollo utilizan claves de API generadas desde la consola de control de TurnitPass.

03

Referencia de API

Referencia para los endpoints autenticados de revisión, paráfrasis, comprobación de señales, citas, bibliografía y estado de claves.

04

Historial

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

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.

1

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.

2

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.

3

Ejecutar el flujo

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

4

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

Disminuye 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 puntajes estimados, 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