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

DesarrolladoresReferencia de API

API REST de TurnitPass

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

REST API v1

Consola de referencia

Empieza por la ruta, el payload y la forma de la respuesta.

La referencia completa cubre todos los endpoints de abajo. La consola muestra el contrato que el desarrollador necesita primero: auth Bearer, entrada JSON, salida medida y comprobaciones de status.

request
POST
fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})
response
200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}
medidoregistradoJSON
POST/api/v1/humanize
POST/api/v1/paraphrase
POST/api/v1/rewrite
POST/api/v1/detect
POST/api/v1/citation
AuthBearer API key
TransformPOST /humanize
RevisiónPOST /detect
StatusGET /status
POST/api/v1/humanize
v1

Revisa el texto enviado y reduce señales de escritura tipo IA. Modos: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase
v1

Reescribe y pule el texto con modos estándar, fluidez, formal, académico, simple, creativo, expandir o acortar.

POST/api/v1/rewrite
v1

Endpoint de revisión académica para una mejor estructura, tono y fluidez.

POST/api/v1/detect
v1

Devuelve puntaje, nivel de riesgo, metadatos y señales de escritura para el texto pegado o documentos extraídos.

POST/api/v1/citation
v1

Formatea un DOI, URL o cita manual en APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA o Bluebook. La respuesta incluye HTML, texto plano, BibTeX y RIS.

POST/api/v1/bibliography
v1

Ordena y formatea una lista de citas en el estilo solicitado, con salida HTML/texto y exportación en BibTeX y RIS.

GET/api/v1/status
v1

Verifica el nombre de la clave, saldo de palabras restante, límites de solicitud y último uso.

Parámetros y opciones

Autenticación
Authorization: Bearer tp_your_api_key
Términos protegidos
El campo opcional personal_terms conserva nombres propios, términos técnicos y marcas.
Límites
Los endpoints de revisión aceptan hasta 1.000 palabras de entrada. La comprobación acepta hasta 5.000 palabras. Las citas tienen límites de uso propios.
Errores
Las respuestas JSON incluyen error, code y message.

Límites de ritmo y de solicitud

Entrada de transformación
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
Entrada de detección
Hasta 5.000 palabrasLos escaneos detector más largos deben fragmentarse antes de enviarse.
Claves API
Hasta 5 claves activasLas claves pueden revocarse de forma independiente desde el espacio de trabajo.
Herramientas de citas
Límite de ritmo aparteLas llamadas citation y bibliography no gastan créditos de palabras.

Manejo de errores

Las respuestas de error usan JSON con los campos error, code y un message legible cuando es posible.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Las credenciales de Stripe y Google siguen siendo configuración. Las superficies API, el flujo de auth y la persistencia ya están implementados para que las credenciales live se añadan sin rediseñar el producto.

Ejemplos

Ejemplo humanize
JSON
POST /api/v1/humanize
{
  "text": "Pega el texto que quieres revisar",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "El texto humanizado...",
  "words_used": 142,
  "words_remaining": 2858
}
Ejemplo de varios endpoints
JSON
POST /api/v1/paraphrase
{
  "text": "Pega el borrador que quieres reescribir",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Pega el texto que quieres comprobar",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "Cita formateada...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Siguientes pasos

Inicio rápido

Prepara la primera solicitud.

Autenticación

Revisa el manejo de claves API.

Historial

Consulta los cambios recientes de la plataforma.

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