Pangram 4 移行ガイド

Pangram 4 移行ガイド

Pangram 4が当社のAPIで公開されました。

課金システムの一部の更新に伴い、Pangram 3.3.2 は引き続きデフォルトとして設定されており、2026年9月30日まで利用可能となります。

このガイドでは、Pangram 4 への移行に関して知っておくべきことをすべて解説しています。

Pangram 4の新機能とは？

Pangram 4 では、より精度の高い検出モデル、セグメントごとのヒューマナイザー検出、および簡素化された分類ラベルセットが導入されています。詳細については、「Pangram 4 モデル」カードをご覧ください！

レスポンスの全体的な構造は従来通りであるため、ほとんどの統合ではわずかな変更で済むはずです：

• 以下を明示的に使用して、パングラム 4 をリクエストしてください。 モデル: "pangram-4"
• バージョンへの更新 1.0.0 Python SDKの
• 新しい「Pangram 4」のウィンドウラベルをご活用ください
• 必要に応じて、新しいヒューマナイゼーションフィールドを使用してください
• 更新されたAPI課金メーターを反映する

「パングラム4」も再び登場します：

{
  "version": "4.0"
}

移行すべきでしょうか？

以下のいずれかに当てはまる場合は「はい」：

• Pangram 4 がデフォルトになる前に使い始めてみませんか
• アプリケーションや本番環境のワークフローでウィンドウラベルを活用する
• 新しいヒューマナイゼーション分野にアクセスしたいですか
• 9月30日までに、統合機能のテストを行う時間が必要です
• 通常のリクエストサイズを使用して、更新された課金モデルを評価したい

以下の場合は、まだです：

• ステージング環境で「パングラム4」の検証を行うために、追加の時間が必要です
• Pangram 3.3.2 の正確なラベル文字列に依存しており、統合を更新していません
• 「100ワードごとの課金」がご利用状況にどのような影響を与えるか、確認する必要があります

Pangram 3.3.2 は引き続きデフォルトのバージョンであり、2026年9月30日まで提供され続けます。

年表

特に、統合処理がウィンドウラベルの文字列に依存している場合は、9月30日までにPangram 4のテストを行うことをお勧めします。

REST API の移行

REST APIをご利用の方は、以下のリクエストを送信してください。 投稿 宛先：

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

リクエスト本文には、以下の内容を含める必要があります：

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

移行期間中は、Pangram 3.3.2 が引き続きデフォルトとなっているため、Pangram 4 を使用するには明示的にリクエストする必要があります。

リクエスト例

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

Python SDK の移行

Python SDKをご利用の方は、v1.0にアップデートしてください：

pip インストール --upgrade pangram-sdk==1.0.0

次に、Pangram 4 を明示的にリクエストします：

出典： パングラム import Pangram

client = パングラム()

結果 = client.predict(
    text,
    モデル="pangram-4",
)

REST APIと同様に、移行期間中はPangram 4を明示的に選択する必要があります。

レスポンススキーマの変更

全体的な回答の構成はこれまでと変わりませんが、すべてのパングラム4に2つの項目が追加されています。 windows[] 項目：

「パングラム4」も再び登場します：

{
  "version": "4.0"
}

ウィンドウラベルの移行

唯一、互換性を損なう可能性のある変更点は、Pangram 4 のウィンドウラベルが次のように変更されたことです：

• AI生成
• AIを活用した
• 人間が執筆

AIを活用した 以前のものを置き換えます AIによる軽微な支援 そして AIによる適度な支援 ラベル。

統合処理が特定のラベル文字列に基づいて分岐する場合は、移行前にその処理を更新してください。

たとえば、以前は2つのAI支援ラベルを別々に処理していたコードは、次のようなものでした：

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

次のように更新する必要があります：

もし ウィンドウ["label"] == "AI支援型":
    handle_ai_assisted(window)

完全な「Pangram 4」ラベルハンドラは、次のようなものになるでしょう：

ラベル = ウィンドウ["label"]

if ラベル == "AI生成":
    handle_ai_generated(window)
elif ラベル == "AI-Assisted":
    handle_ai_assisted(window)
elif ラベル == "Human Written":
    handle_human_written(window)
else:
    handle_unknown_label(window)

APIが常に現在ドキュメントに記載されている文字列のいずれかを返すとは限らないため、ラベル不明の場合のフォールバックを用意しておくことをお勧めします。

フィールド移行ガイド

Pangram 3.3.2 のレスポンスフィールドのほとんどは、Pangram 4 へ移行する際、変更の必要はありません。

互換性に関する主な懸念点は、 windows[].label. これまでの2つのAI支援カテゴリーは、1つのカテゴリーに統合されました。 AIを活用した ラベル。

請求に関する変更

最後にひとつお知らせです：APIの課金方法を更新いたします。

利用量の計測単位をより細かく見直しています。これに伴い、課金単位が1,000語ごとから100語ごとに変更されます。これにより、多くのお客様にとってメリットがあるものと考えております。

ただし、あらかじめお伝えしておきますが、Pangram 4はより大型で高性能なモデルであるため、価格を引き上げざるを得ませんでした。

最新の価格情報については、価格ページをご覧ください！

すべての本番トラフィックをPangram 4に移行する前に、更新された課金モデルを、アプリケーションの通常のリクエストの長さや処理量と照らし合わせて確認してください。

推奨される移行プロセス

1. クライアントを更新する

REST APIをご利用のお客様は、引き続き既存のタスクエンドポイントをご利用いただけます。

Python SDKをご利用の方は、バージョン 1.0.0:

pip インストール --upgrade pangram-sdk==1.0.0

2. パングラム4を明示的に要求する

すべてのリクエストにモデルパラメータを追加します：

{
  "model": "pangram-4"
}

3. ラベルの完全一致比較を更新する

以下のチェックを置き換える：

AIによる軽度の支援
AIによる中程度の支援

出演：

AIを活用した

また、ご利用の統合機能が、以下の4つのパングラムラベルを正確にサポートしているか確認してください：

AI生成
AI支援
人間による執筆

4. 新しい分野を支援する

以下の機能をサポートするために、レスポンスタイプ、検証スキーマ、データベースモデル、および分析パイプラインを更新します：

windows[].is_humanized
windows[].humanizer_score
version

アプリケーションでまだヒューマナイゼーション分析を使用していない場合は、新しいウィンドウのフィールドを当初はオプションとして扱うことができます。

5. 請求に関する前提条件の見直し

今後、リクエストの料金は1,000語ごとではなく、100語ごとに課金されるようになります。

代表的な本番トラフィックを用いて、その効果を検証してください。

移行チェックリスト

• Python SDK を次のバージョンに更新してください pangram-sdk==1.0.0（該当する場合）
• 追加 モデル: "pangram-4" APIリクエストに対して
• への依存関係を削除する AIによる軽微な支援
• への依存関係を削除する AIによる適度な支援
• サポート AIを活用した
• 以下の機能のサポートを追加する windows[].is_humanized
• 以下の機能のサポートを追加する windows[].humanizer_score
• レスポンスのバージョンが "4.0"
• 新しい「100語あたり」の課金メーターを確認してください
• 2026年9月30日までに移行のテストを行ってください

ご質問はありますか？

皆さんに「Pangram 4」をご利用いただけることを楽しみにしています。何か問題がございましたら、お気軽にお問い合わせください。今後数日間は、いつも以上に迅速に対応させていただきます！

移行に関するサポートについては、support@pangram.com までお問い合わせください。