Pangram 3.0 API 移行ガイド

Pangramのv3 APIが公開されました！このガイドでは、v2エンドポイントから新しいv3 APIへの移行について、知っておくべきすべての情報を解説しています。

v3の新機能

AI支援テキストの分類に、3つ目のカテゴリーを追加しました。このカテゴリーに該当するテキストは、通常、AIと人間の双方が大きく関与して作成されており、これは現代において人々が実際にAIツールをどのように活用しているかを反映したものです。

主なスキーマの変更点

v3 API では、各ドキュメントを 3 つの割合フィールドで分類し、ドキュメントのどの程度の部分が各カテゴリに該当するかを示します：

• fraction_human — 人間が作成したと分類された部分
• fraction_AI_支援 — AI支援型に分類される部分
• fraction_ai — AI生成と分類された部分

これら3つの領域は互いに排他的であり、かつ全体として網羅的である。それらの合計は常に1となる。

さらに、すべてのドキュメントには、詳細度の異なる3つの予測文字列が含まれています：

• 見出し — 例：「完全な人間による執筆」、「AIによる支援」、「AIによる検出」
• 予測 — 分類に関する詳細な説明。例えば、「この文書は完全にAIによって生成されたものであると確信しています」や、「この文書はAIの支援を受けているものの、完全にAIによって生成されたものではないと考えています」といった具合です。
• 予測（短文） — 例：「人間」、「混血」、「AI」

ウィンドウレベル分析

各入力文書はウィンドウに分割されます。各ウィンドウには以下のラベルが付いています：

• ラベル — 分類文字列（「人間によるもの」、「AIによる適度な支援」、「AI生成」など）
• 自信 — パングラムの検出モデルによる信頼度出力（「高」、「中」、「低」）
• ai_assistance_score — AIによる支援の度合いを示す0から1までの数値

注：近い将来、「AIによる軽微な支援」、「AIによる大幅な支援」といった新たなラベルが導入される予定です。

---

移行すべきでしょうか？

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

• 本番環境でのパングラム結果の利用
• 最新のAIモデルの出力精度を向上させたい
• 2026年4月1日以降もPangram APIをご利用になる場合は、事前の準備をお願いします

以下の場合は「いいえ」を選択してください：

• 再現性を確保するために静的APIを必要としている研究者の方

---

年表

---

V2エンドポイント（2026年4月1日まで利用可能）

移行期間中、以下のv2エンドポイントは引き続き利用可能です：

• text.api.pangram.com
• text-batch.api.pangram.com
• text-sliding.api.pangram.com
• text-extended.api.pangram.com
• dashboard-text.api.pangram.com

---

フィールド移行ガイド

差出人 text.api.pangram.com

エンドポイント： https://text.api.pangram.com → https://text.api.pangram.com/v3

パングラムの予測を最も包括的に理解するには、最上位のフィールドを使用してください：

元のエンドポイントの動作に合わせる：元のエンドポイントは、予測を行う際にテキストの最初のウィンドウのみを使用していました。この動作に合わせるには：

重要： の解釈 ai_assistance_score ～とは異なる ai_尤度. これらのフィールドは1対1の関係ではありません。中間範囲（0～1）の予測が多くなることを想定してください。使用 ラベル 当社の推奨する解釈をご理解いただくために。

---

差出人 text-batch.api.pangram.com

現在、v3 API にはバッチエンドポイントはありません。以下の手順に従い、ループを使用して各アイテムを個別に処理してください。 text.api.pangram.com 上記の移行ガイド。

---

差出人 text-sliding.api.pangram.com

エンドポイント： https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3

ウィンドウの変更：

• で テキストのスライド、窓は 重複
• バージョン3では、ウィンドウは重なりません

---

差出人 text-extended.api.pangram.com

エンドポイント： https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

ほとんどの項目は変更ありません：

変更されたフィールド：

---

ドキュメント

APIの完全なドキュメントはこちらでご覧いただけます。

---

ご質問はありますか？

v3への移行についてご質問がある場合は、support@pangram.com までご連絡ください。