Guía de migración de la API Pangram 3.0

¡La API 3.0 de Pangram ya está disponible! Esta guía cubre todo lo que necesitas saber sobre la migración de nuestros puntos finales v2 a la nueva API v3.

¿Qué hay de nuevo en la versión 3?

Hemos introducido una tercera categoría de clasificación para los textos asistidos por IA. Los textos que entran en esta categoría suelen estar escritos con una importante aportación de IA y humana, lo que refleja cómo se utilizan realmente las herramientas de IA en la actualidad.

Cambios clave en el esquema

La API v3 clasifica cada documento con tres campos fraccionarios que indican qué parte del documento pertenece a cada categoría:

• fracción_humana — parte clasificada como escrita por humanos
• fracción_asistida_por_IA — parte clasificada como asistida por IA
• fracción_ai — parte clasificada como generada por IA

Estos tres campos son mutuamente excluyentes y colectivamente exhaustivos; su suma siempre será igual a 1.

Además, cada documento incluye tres cadenas de predicción con diferentes niveles de detalle:

• titular — Por ejemplo, «Escrito íntegramente por humanos», «Con ayuda de IA», «Detectado por IA».
• predicción — Explicación detallada de la clasificación. Por ejemplo, «Estamos seguros de que este documento ha sido generado íntegramente por IA» o «Creemos que este documento ha sido creado con ayuda de IA, pero no íntegramente por IA».
• predicción_corta — Por ejemplo, «Humano», «Mixto», «IA».

Análisis a nivel de ventana

Cada documento de entrada se divide en ventanas. Cada ventana está etiquetada con:

• etiqueta — cadena de clasificación («Humano», «Asistido moderadamente por IA», «Generado por IA», etc.)
• confianza — Confianza del modelo de detección de Pangram («Alta», «Media», «Baja»).
• puntuación_de_asistencia_ai — escalar de 0 a 1 que indica la magnitud de la asistencia de la IA

Nota: Es de esperar que en un futuro próximo se introduzcan etiquetas adicionales («Ligeramente asistido por IA», «Fuertemente asistido por IA»).

---

¿Debería migrar?

SÍ, si usted:

• Utilizar los resultados de Pangram en un entorno de producción.
• ¿Desea mejorar la precisión de los resultados de los últimos modelos de IA?
• Planea utilizar la API de Pangram más allá del 1 de abril de 2026.

NO si usted:

• ¿Es usted un investigador que necesita una API estática para la reproducibilidad?

---

Cronología

Fecha	Evento
11 de diciembre de 2025	Pangram 3.0 lanzado a través del panel de control
23 de diciembre de 2025	Pangram 3.0 disponible a través de la API
Finales de enero de 2026	Lanzamiento de Pangram 3.1 (panel de control + API). Todos los usuarios de la API 3.0 se han actualizado automáticamente.
1 de abril de 2026	API de Pangram 2.0: fin de la vida útil

---

Puntos finales V2 (disponibles hasta el 1 de abril de 2026)

Los siguientes puntos finales v2 seguirán estando disponibles durante el periodo de transición:

• texto.api.pangram.com
• texto-lote.api.pangram.com
• text-sliding.api.pangram.com
• text-extended.api.pangram.com
• panel-de-control-texto.api.pangram.com

---

Guía de migración de campo

Desde texto.api.pangram.com

Punto final: https://text.api.pangram.com → https://text.api.pangram.com/v3

Para comprender mejor las predicciones de Pangram, utilice los campos de nivel superior:

v2 Campo	v3 Campo	Notas
predicción	titular	Valores como «Escrito íntegramente por humanos», «Asistido por IA», «Detectado por IA».
probabilidad_ai	fracción_ai	Cantidad de texto que se cree que ha sido generado por IA.
—	fracción_asistida_por_IA	Nuevo: Cantidad que se cree que ha sido asistida por IA.
—	fracción_humana	Cantidad que se cree que ha sido escrita por humanos.

Coincidencia con el comportamiento del punto final original: El punto final original solo utilizaba la primera ventana del texto para realizar su predicción. Para coincidir con este comportamiento:

v2 Campo	v3 Campo
predicción	ventanas[0].etiqueta y ventanas[0].confianza
probabilidad_ai	ventanas[0].puntuación_asistencia_ai

Importante: La interpretación de puntuación_de_asistencia_ai difiere de probabilidad_ai. Estos campos no son uno a uno. Espera más predicciones en el rango medio (0-1). Utiliza etiqueta para comprender nuestra interpretación recomendada.

---

Desde texto-lote.api.pangram.com

Actualmente no hay ningún punto final por lotes para la API v3. Utilice un bucle para procesar cada elemento individualmente, siguiendo el texto.api.pangram.com Guía de migración arriba.

---

Desde text-sliding.api.pangram.com

Punto final: https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3

v2 Campo	v3 Campo	Notas
predicción	titular o predicción	Diferentes niveles de detalle disponibles
predicción_corta	predicción_corta	Sin cambios
probabilidad_ai, probabilidad_media_de_IA	fracción_ai, fracción_asistida_por_IA, fracción_humana	Utilice campos de cantidad en lugar de puntuaciones de confianza agregadas.
probabilidad máxima de IA	fracción_ai (recomendado)	Campos de cantidad preferidos

Cambios en las ventanas:

• En deslizamiento de texto, las ventanas son superposición
• En la versión 3, las ventanas no se superponen.

Campo de ventana v2	Campo de ventana v3
ventanas[].predicción	ventanas[].etiqueta + ventanas[].confianza
ventanas[].probabilidad_ai	ventanas[].puntuación_de_asistencia_ai

---

Desde text-extended.api.pangram.com

Punto final: https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

La mayoría de los campos permanecen sin cambios:

Campo	Estado
titular	Sin cambios
predicción	Sin cambios
predicción_corta	Sin cambios
fracción_humana	Sin cambios
fracción_ai	Sin cambios
ventanas[].etiqueta	Sin cambios
ventanas[].confianza	Sin cambios
windows[].start_index	Sin cambios
windows[].end_index	Sin cambios

Campos que han cambiado:

v2 Campo	v3 Campo	Notas
fracción_mixta	fracción_asistida_por_IA	Campo renombrado para mayor claridad.
tablero	enlace_panel_público	Campo renombrado para mayor claridad.
probabilidad_media_de_IA	fracción_ai, fracción_asistida_por_IA, fracción_humana	Utilice campos de cantidad en lugar de puntuaciones de confianza agregadas.
probabilidad máxima de IA	fracción_ai, fracción_asistida_por_IA, fracción_humana	Utilice campos de cantidad en lugar de puntuaciones de confianza agregadas.
ventanas[].probabilidad_ai	ventanas[].puntuación_de_asistencia_ai	Las puntuaciones de probabilidad y asistencia de IA no son uno a uno. Uso etiqueta para orientación.

---

Documentación

La documentación completa de la API está disponible aquí.

---

¿Preguntas?

Si tiene alguna pregunta sobre la migración a la versión 3, póngase en contacto con nosotros en support@pangram.com.