Guida alla migrazione di Pangram 4

Guida alla migrazione di Pangram 4

Pangram 4 è ora disponibile nella nostra API.

A causa di alcuni aggiornamenti relativi alla fatturazione, Pangram 3.3.2 rimane la versione predefinita e resterà attiva fino al 30 settembre 2026.

Questa guida illustra tutto ciò che occorre sapere sulla migrazione a Pangram 4.

Cosa c'è di nuovo in Pangram 4?

Pangram 4 introduce un modello di rilevamento più accurato, il rilevamento "humanizer" per segmento e un insieme semplificato di etichette di classificazione. Per ulteriori informazioni, consulta la scheda del modello Pangram 4!

La struttura generale delle risposte rimane la stessa, quindi la maggior parte delle integrazioni dovrebbe richiedere solo poche modifiche:

• Richiedi il Pangram 4 in modo esplicito utilizzando modello: "pangram-4"
• Aggiornamento alla versione 1.0.0 dell'SDK di Python
• Sostieni le nuove etichette per finestre Pangram 4
• Se lo si desidera, è possibile utilizzare i nuovi campi di umanizzazione
• Tieni conto del contatore di fatturazione API aggiornato

Torna anche il Pangram 4:

{
  "version": "4.0"
}

Dovrei migrare?

SÌ, se:

• Vuoi iniziare a usare Pangram 4 prima che diventi l'impostazione predefinita?
• Utilizza le etichette delle finestre nei flussi di lavoro delle tue applicazioni o di produzione
• Vuoi accedere ai nuovi campi di umanizzazione?
• Hai bisogno di tempo per testare la tua integrazione prima del 30 settembre?
• Vuoi valutare il modello di fatturazione aggiornato utilizzando le dimensioni standard delle tue richieste?

NON ANCORA se:

• È necessario più tempo per verificare il Pangram 4 in un ambiente di staging
• Ti basi sulle stringhe esatte dell'etichetta Pangram 3.3.2 e non hai aggiornato la tua integrazione
• È necessario valutare in che modo la fatturazione per ogni 100 parole influirà sul tuo utilizzo

Pangram 3.3.2 è ancora la versione predefinita e rimarrà attiva fino al 30 settembre 2026.

Cronologia

Consigliamo di testare Pangram 4 prima del 30 settembre, soprattutto se la vostra integrazione si ramifica in base a stringhe esatte delle etichette delle finestre.

Migrazione dell'API REST

Per chi utilizza l'API REST, inviare un POST richiesta a:

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

Il corpo della richiesta dovrebbe ora includere:

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

Poiché Pangram 3.3.2 rimane l'impostazione predefinita durante il periodo di transizione, è necessario richiedere esplicitamente Pangram 4.

Esempio di richiesta

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"
  }'

Migrazione dell'SDK Python

Per chi utilizza l'SDK di Python, è necessario effettuare l'aggiornamento alla versione 1.0:

pip installa --upgrade pangram-sdk==1.0.0

Quindi richiedere esplicitamente Pangram 4:

da pangramma import Pangram

client = Pangram()

risultato = client.previsione(
    testo,
    modello="pangram-4",
)

Come per l'API REST, durante il periodo di transizione è necessario selezionare esplicitamente Pangram 4.

Modifiche allo schema di risposta

La struttura generale delle risposte rimane la stessa, con due aggiunte a ogni Pangram 4 windows[] voce:

Torna anche il Pangram 4:

{
  "version": "4.0"
}

Migrazione delle etichette delle finestre

L'unica modifica che potrebbe comportare problemi di compatibilità è che le etichette delle finestre di Pangram 4 ora sono:

• Generato dall'intelligenza artificiale
• Assistito dall'intelligenza artificiale
• Scritto da una persona

Assistito dall'intelligenza artificiale sostituisce il precedente Con un leggero supporto dell'intelligenza artificiale e Con un supporto moderato dell'intelligenza artificiale etichette.

Se la tua integrazione si ramifica in base a stringhe di etichetta esatte, aggiornala prima della migrazione.

Ad esempio, il codice che in precedenza gestiva separatamente le due etichette assistite dall'IA:

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

Dovrebbe essere aggiornato come segue:

se finestra["etichetta"] == "Assistito dall'IA":
    handle_ai_assisted(finestra)

Un gestore completo delle etichette Pangram 4 potrebbe presentarsi così:

etichetta = finestra["etichetta"]

se etichetta == "Generato dall'IA":
    handle_ai_generated(finestra)
elif etichetta == "Assistito dall'IA":
    handle_ai_assisted(finestra)
elif etichetta == "Scritto da una persona":
    handle_human_written(finestra)
altrimenti:
    gestisci_etichetta_sconosciuta(finestra)

Si consiglia di prevedere un'opzione di ripiego per le etichette sconosciute, anziché dare per scontato che l'API restituisca sempre una delle stringhe attualmente documentate.

Guida alla migrazione sul campo

La maggior parte dei campi di risposta di Pangram 3.3.2 non richiede modifiche in occasione del passaggio a Pangram 4.

Il principale problema di compatibilità è windows[].label. Le due precedenti categorie assistite dall'intelligenza artificiale sono state accorpate in un'unica Assistito dall'intelligenza artificiale etichetta.

Modifiche alla fatturazione

Un'ultima nota: stiamo aggiornando le modalità di fatturazione della nostra API.

Stiamo migliorando la granularità del nostro contatore di utilizzo. Le richieste verranno ora addebitate ogni 100 parole anziché ogni 1.000 parole. Ciò rappresenterà un vantaggio per molti di voi.

Ma vi avverto: il Pangram 4 è un modello più grande e più performante e, di conseguenza, abbiamo dovuto aumentare il prezzo.

Per le informazioni più aggiornate sui prezzi, consulta la pagina dedicata!

Prima di trasferire tutto il traffico di produzione su Pangram 4, verifica che il modello di fatturazione aggiornato sia adeguato alla durata e al volume tipici delle richieste della tua applicazione.

Procedura di migrazione consigliata

1. Aggiorna il tuo client

Gli utenti dell'API REST possono continuare a utilizzare l'endpoint delle attività esistente.

Gli utenti dell'SDK Python devono installare la versione 1.0.0:

pip installa --upgrade pangram-sdk==1.0.0

2. Richiedere esplicitamente il Pangram 4

Aggiungi il parametro "model" a ogni richiesta:

{
  "model": "pangram-4"
}

3. Aggiornamento dei confronti esatti delle etichette

Sostituire i controlli relativi a:

Con un leggero supporto dell'IA
Con un moderato supporto dell'IA

Con:

Assistito dall'intelligenza artificiale

Verifica inoltre che la tua integrazione supporti esattamente le 4 etichette Pangram:

Generato dall'IA
Con l'ausilio dell'IA
Scritto da un essere umano

4. Sostenere i nuovi settori

Aggiornare i tipi di risposta, gli schemi di convalida, i modelli di database e le pipeline di analisi per supportare:

windows[].is_humanized
windows[].humanizer_score
versione

I campi della nuova finestra possono essere considerati facoltativi in una prima fase, qualora la vostra applicazione non utilizzi ancora l'analisi di umanizzazione.

5. Verifica delle ipotesi di fatturazione

Le richieste verranno ora addebitate ogni 100 parole anziché ogni 1.000 parole.

Verificare l'effetto utilizzando un traffico di produzione rappresentativo.

Lista di controllo per la migrazione

• Aggiornare l'SDK Python a pangram-sdk==1.0.0, se del caso
• Aggiungi modello: "pangram-4" alle richieste API
• Rimuovere le dipendenze da Con un leggero supporto dell'intelligenza artificiale
• Rimuovere le dipendenze da Con un supporto moderato dell'intelligenza artificiale
• Assistenza Assistito dall'intelligenza artificiale
• Aggiungere il supporto per windows[].is_humanized
• Aggiungere il supporto per windows[].humanizer_score
• Verificare che la versione della risposta sia "4.0"
• Esamina il nuovo sistema di fatturazione basato su 100 parole
• Effettuare un test della migrazione entro il 30 settembre 2026

Domande?

Non vediamo l'ora che iniziate a usare Pangram 4. Contattateci se avete qualche problema. Nei prossimi giorni saremo ancora più disponibili a rispondervi!

Per assistenza in materia di migrazione, contattare support@pangram.com.