Guía de migración de la API de Pangram 3.0
Cómo migrar de los puntos finales de la versión 2 de Pangram a la nueva API v3: qué ha cambiado, los nuevos campos de respuesta y todo lo que necesitas para una actualización sin problemas.
Índice
- ¿Qué hay de nuevo en la versión 3?
- Cambios clave en el esquema
- Análisis a nivel de ventana
- ¿Debería migrar?
- Cronología
- Terminales V2 (disponibles hasta el 1 de abril de 2026)
- Guía de migración sobre el terreno
- De text.api.pangram.com
- De text-batch.api.pangram.com
- De text-sliding.api.pangram.com
- De text-extended.api.pangram.com
- Documentación
- ¿Alguna pregunta?
¡La API 3.0 de Pangram ya está disponible! En esta guía encontrarás todo lo que necesitas saber sobre la migración de nuestros puntos de conexión de la versión 2 a la nueva API 3.0.
¿Qué hay de nuevo en la versión 3?
Hemos introducido una tercera categoría de clasificación para los textos generados con ayuda de la IA. Los textos que entran en esta categoría suelen estar redactados con una combinación significativa de aportaciones de la IA y de personas, 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 mediante tres campos fraccionarios que indican qué porcentaje del documento corresponde a cada categoría:
fracción_humana— parte clasificada como escrita por personasfracción_asistida_por_IA— parte clasificada como asistida por IAfracción_ai— parte clasificada como generada por IA
Estos tres campos son mutuamente excluyentes y, en conjunto, exhaustivos; su suma siempre será igual a 1.
Además, cada documento incluye tres cadenas de predicción con distintos niveles de detalle:
titular— p. ej., «Escrito íntegramente por humanos», «Con ayuda de IA», «Detectado por IA»predicción— una 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 elaborado con la ayuda de la IA, pero no ha sido generado íntegramente por ella».predicción_breve— p. ej., «Humano», «Misto», «IA»
Análisis a nivel de ventana
Cada documento de entrada se divide en ventanas. Cada ventana lleva la siguiente etiqueta:
etiqueta— cadena de clasificación («Humano», «Con asistencia moderada de IA», «Generado por IA», etc.)confianza— Nivel de confianza del modelo de detección de Pangram («Alto», «Medio», «Bajo»)puntuación_de_asistencia_de_IA— un valor escalar comprendido entre 0 y 1 que indica el nivel de asistencia de la IA
Nota: En un futuro próximo se introducirán etiquetas adicionales («Con asistencia ligera de IA», «Con asistencia intensa de IA»).
¿Debería migrar?
SÍ, si:
- Utilización de los resultados de Pangram en un entorno de producción
- ¿Quieres mejorar la precisión de los resultados de los últimos modelos de IA?
- Si tiene previsto seguir utilizando la API de Pangram después del 1 de abril de 2026
NO, si:
- ¿Eres un investigador que necesita una API estática para garantizar 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 |
Terminales V2 (disponibles hasta el 1 de abril de 2026)
Los siguientes puntos de conexión de la versión 2 seguirán estando disponibles durante el periodo de transición:
text.api.pangram.comtext-batch.api.pangram.comtext-sliding.api.pangram.comtext-extended.api.pangram.comdashboard-text.api.pangram.com
Guía de migración sobre el terreno
De text.api.pangram.com
Resultado: https://text.api.pangram.com → https://text.api.pangram.com/v3
Para comprender mejor las predicciones de Pangram, utiliza 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 de IA | 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. |
Imitar el comportamiento del punto final original: El punto final original solo utilizaba la primera ventana del texto para realizar su predicción. Para imitar este comportamiento:
| v2 Campo | v3 Campo |
|---|---|
predicción | ventanas[0].etiqueta y ventanas[0].confianza |
probabilidad de IA | ventanas[0].puntuación_asistencia_ai |
Importante: La interpretación de
puntuación_de_asistencia_de_IAse diferencia deprobabilidad de IA. Estos campos no tienen una relación uno a uno. Se esperan más predicciones en el rango medio (0–1). Utilizaetiquetapara comprender nuestra interpretación recomendada.
De text-batch.api.pangram.com
Actualmente no existe ningún punto final de procesamiento por lotes para la API v3. Utiliza un bucle para procesar cada elemento por separado, siguiendo las text.api.pangram.com la guía de migración anterior.
De text-sliding.api.pangram.com
Resultado: 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_breve | predicción_breve | Sin cambios |
probabilidad de IA, 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 la ventana:
- En
desplazamiento de texto, las ventanas son superpuesto - 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 |
De text-extended.api.pangram.com
Resultado: https://text-extended.api.pangram.com → https://text.api.pangram.com/v3
La mayoría de los campos no han cambiado:
| Campo | Estado |
|---|---|
titular | Sin cambios |
predicción | Sin cambios |
predicción_breve | 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í.
¿Alguna pregunta?
Si tienes alguna pregunta sobre la migración a la versión 3, ponte en contacto con nosotros en support@pangram.com.

Max es un ingeniero con amplia experiencia en aprendizaje automático. Recientemente ha trabajado en el ámbito de los vehículos autónomos en Nuro, donde ha dirigido el proyecto de aprendizaje activo. Cuenta con una dilatada trayectoria en la implementación de productos de aprendizaje automático de éxito en Google, Two Sigma y Yelp.
Max es licenciado en Informática Teórica y tiene un máster en Inteligencia Artificial por la Universidad de Stanford. Además de su pasión por la construcción, también es un miembro activo de la comunidad del «cubo» de Magic: The Gathering.
Lecturas relacionadas

¿Pueden los detectores de IA identificar el GPT-4.5?

¿Funciona Pangram en Claude Fable 5?

Presentación de las etiquetas y los grupos

Pangram 3.0: Cuantificación del alcance de la edición mediante IA en los textos

Presentamos Pangram 4
