Guía de migración a Pangram 4

Guía de migración a Pangram 4

Pangram 4 ya está disponible en nuestra API.

Debido a algunas actualizaciones en la facturación, Pangram 3.3.2 sigue siendo la versión predeterminada y permanecerá activa hasta el 30 de septiembre de 2026.

Esta guía recoge todo lo que necesitas saber sobre la migración a Pangram 4.

¿Qué novedades hay en Pangram 4?

Pangram 4 introduce un modelo de detección más preciso, la detección de «humanizer» por segmentos y un conjunto simplificado de etiquetas de clasificación. ¡Consulta la ficha del modelo Pangram 4 para obtener más información!

La estructura general de las respuestas sigue siendo la misma, por lo que la mayoría de las integraciones solo deberían requerir unos pocos cambios:

• Solicita el Pangram 4 de forma explícita utilizando modelo: «pangram-4»
• Actualización a la versión 1.0.0 del SDK de Python
• Apoya las nuevas etiquetas para ventanas «Pangram 4»
• Si lo deseas, puedes utilizar los nuevos campos de humanización
• Contabilizar el contador de facturación actualizado de la API

También vuelve el Pangram 4:

{
  "version": "4.0"
}

¿Debería migrar?

SÍ, si:

• ¿Quieres empezar a usar Pangram 4 antes de que se convierta en la opción predeterminada?
• Utiliza las etiquetas de ventana en tu aplicación o en tus flujos de trabajo de producción
• ¿Quieres acceder a los nuevos campos de humanización?
• Necesitas tiempo para probar tu integración antes del 30 de septiembre
• ¿Quieres evaluar el modelo de facturación actualizado utilizando los volúmenes habituales de tus solicitudes?

AÚN NO, si:

• Necesito más tiempo para validar el Pangram 4 en un entorno de pruebas.
• Dependes de las cadenas de etiqueta exactas de Pangram 3.3.2 y no has actualizado tu integración
• Es necesario analizar cómo afectará a tu consumo la facturación por cada 100 palabras

Pangram 3.3.2 sigue siendo la versión predeterminada y permanecerá activa hasta el 30 de septiembre de 2026.

Cronología

Te recomendamos que pruebes Pangram 4 antes del 30 de septiembre, sobre todo si tu integración se ramifica en función de cadenas exactas de etiquetas de ventanas.

Migración de la API REST

Para quienes utilicen la API REST, envíen una PUBLICAR solicitud dirigida a:

https://text.external-api.pangram.com/task

El cuerpo de la solicitud debería incluir ahora:

{
  "text": "...",
  "model": "pangram-4"
}

Dado que Pangram 3.3.2 sigue siendo la versión predeterminada durante el periodo de transición, debes solicitar Pangram 4 de forma explícita.

Ejemplo de solicitud

curl --request POST \
  --url https://text.external-api.pangram.com/task \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data '{
    "text": "Your text goes here.",
    "model": "pangram-4"
  }'

Migración del SDK de Python

Para quienes utilicen el SDK de Python, actualicen a la versión 1.0:

pip instalar --upgrade pangram-sdk==1.0.0

A continuación, solicita Pangram 4 de forma explícita:

de pangrama importar Pangram

client = Pangram()

resultado = cliente.predicción(
    texto,
    modelo="pangram-4",
)

Al igual que con la API REST, es necesario seleccionar Pangram 4 de forma explícita durante el periodo de transición.

Cambios en el esquema de respuesta

La estructura general de las respuestas sigue siendo la habitual, con dos elementos añadidos a cada Pangram 4 windows[] elemento:

También vuelve el Pangram 4:

{
  "version": "4.0"
}

Migración de etiquetas de ventana

El único cambio que podría afectar al funcionamiento es que las etiquetas de las ventanas de Pangram 4 ahora son:

• Generado por IA
• Con asistencia de IA
• Escrito por una persona

Con asistencia de IA sustituye al anterior Con una ligera ayuda de la IA y Con asistencia moderada de la IA etiquetas.

Si tu integración se ramifica en función de cadenas de texto exactas, actualízala antes de realizar la migración.

Por ejemplo, el código que antes gestionaba por separado las dos etiquetas asistidas por IA:

if window["label"] in {
    "Lightly AI-Assisted",
    "Moderately AI-Assisted",
}:
    handle_ai_assisted(window)

Debería actualizarse a:

si la ventana[«etiqueta»] == «Asistido por IA»:
    handle_ai_assisted(ventana)

Un gestor completo de etiquetas «Pangram 4» podría tener este aspecto:

etiqueta = ventana[«etiqueta»]

si etiqueta == "Generado por IA":
    handle_ai_generated(ventana)
elif etiqueta == «Asistido por IA»:
    handle_ai_assisted(ventana)
elif etiqueta == "Escrito por una persona":
    handle_human_written(ventana)
else:
    handle_unknown_label(ventana)

Recomendamos mantener una opción alternativa para etiquetas desconocidas, en lugar de dar por sentado que la API siempre devolverá una de las cadenas documentadas actualmente.

Guía de migración sobre el terreno

La mayoría de los campos de respuesta de Pangram 3.3.2 no requieren modificaciones al pasar a Pangram 4.

El principal problema de compatibilidad es ventanas[].etiqueta. Las dos categorías anteriores asistidas por IA se han fusionado en una sola Con asistencia de IA etiqueta.

Cambios en la facturación

Una última nota: estamos actualizando la forma en que facturamos nuestra API.

Estamos mejorando la precisión de nuestro contador de uso. A partir de ahora, las solicitudes se facturarán por cada 100 palabras, en lugar de por cada 1.000 palabras. Esto supondrá una ventaja para muchos de vosotros.

Pero te lo advertimos: el Pangram 4 es un modelo más grande y con mayores prestaciones, por lo que nos hemos visto obligados a subir el precio.

¡Consulta la página de precios para ver la información más actualizada!

Antes de trasladar todo el tráfico de producción a Pangram 4, comprueba el modelo de facturación actualizado en función de la duración y el volumen habituales de las solicitudes de tu aplicación.

Proceso de migración recomendado

1. Actualiza tu cliente

Los usuarios de la API REST pueden seguir utilizando el punto final de tareas existente.

Los usuarios del SDK de Python deben instalar la versión 1.0.0:

pip instalar --upgrade pangram-sdk==1.0.0

2. Solicitar el pangram 4 de forma explícita

Añade el parámetro «model» a cada solicitud:

{
  "model": "pangram-4"
}

3. Actualizar las comparaciones exactas de etiquetas

Sustituir las comprobaciones de:

Con asistencia ligera de la IA
Con asistencia moderada de la IA

Con:

Con asistencia de IA

Comprueba también que tu integración sea compatible con las cuatro etiquetas exactas de Pangram:

Generado por IA
Con ayuda de IA
Escrito por personas

4. Apoyar los nuevos campos

Actualizar los tipos de respuesta, los esquemas de validación, los modelos de base de datos y los flujos de análisis para dar soporte a:

windows[].is_humanized
windows[].humanizer_score
versión

Los nuevos campos de la ventana pueden considerarse opcionales en un primer momento si tu aplicación aún no utiliza el análisis de humanización.

5. Revisar las hipótesis de facturación

A partir de ahora, las solicitudes se facturarán por cada 100 palabras, en lugar de por cada 1.000 palabras.

Comprueba el efecto utilizando tráfico de producción representativo.

Lista de comprobación para la migración

• Actualiza el SDK de Python a pangram-sdk==1.0.0, si procede
• Añadir modelo: «pangram-4» a las solicitudes de API
• Eliminar las dependencias de Con una ligera ayuda de la IA
• Eliminar las dependencias de Con asistencia moderada de la IA
• Asistencia Con asistencia de IA
• Añadir compatibilidad con windows[].is_humanized
• Añadir compatibilidad con windows[].humanizer_score
• Comprueba que la versión de la respuesta sea "4.0"
• Revisa el nuevo contador de facturación por cada 100 palabras
• Prueba la migración antes del 30 de septiembre de 2026

¿Alguna pregunta?

Estamos deseando que empecéis a usar Pangram 4. No dudéis en poneros en contacto con nosotros si tenéis algún problema. ¡Estaremos más atentos que nunca en los próximos días!

Para obtener ayuda con la migración, ponte en contacto con support@pangram.com.