パングラム 3.0 API 移行ガイド

Pangramの3.0 APIが公開されました！このガイドでは、v2エンドポイントから新しいv3 APIへの移行に必要なすべての情報を網羅しています。

v3の新機能

AI支援テキスト向けに第三の分類カテゴリーを導入しました。このカテゴリーに該当するテキストは、通常、AIと人間の双方の入力が大幅に組み合わされて作成されます。これは現代において人々が実際にAIツールをどのように利用しているかを反映したものです。

主要なスキーマ変更

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

• フラクション・ヒューマン — 人間が書いた部分として分類された箇所
• フラクションAI支援型 — AI支援と分類された部分
• フラクションAI — AI生成と分類された部分

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

さらに、すべての文書には、異なる詳細レベルで3つの予測文字列が含まれています：

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

ウィンドウレベル分析

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

• ラベル — 分類文字列（「人間」、「AIが中程度に支援」、「AI生成」など）
• 自信 — Pangramの検出モデルからの信頼度出力（「高」、「中」、「低」）
• AIアシスタンススコア — 0から1までのスカラー値で、AI支援の強度を示す

注：近い将来、「AIによる軽度の支援」「AIによる重度の支援」といった追加のラベルが導入される予定です。

---

移行すべきでしょうか？

はい、もしあなたが：

• パングラムの結果を本番環境で使用する
• 最新のAIモデルからの出力精度を向上させたい
• 2026年4月1日以降もPangram APIの利用を計画しています

以下の場合はNO：

• 再現性のために静的APIを必要とする研究者です

---

タイムライン

日付	イベント
2025年12月11日	Pangram 3.0 がダッシュボードを通じてリリースされました
2025年12月23日	パングラム3.0がAPI経由で利用可能
2026年1月下旬	Pangram 3.1 リリース（ダッシュボード + API）。3.0 API ユーザーは全員自動的にアップグレードされました。
2026年4月1日	Pangram 2.0 APIの廃止

---

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

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

• text.api.pangram.com
• text-batch.api.pangram.com
• テキストスライド.api.パングラム.com
• text-extended.api.pangram.com
• ダッシュボードテキスト.api.パングラム.com

---

フィールド移行ガイド

From text.api.pangram.com

終点: https://text.api.pangram.com → https://text.api.pangram.com/v3

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

v2 フィールド	v3 フィールド	注記
予測	見出し	「完全に人間が執筆」「AI支援」「AI検出」などの値
ai_尤度	フラクションAI	AI生成と推定されるテキストの量
—	フラクションAI支援型	新着：AI支援によるものと見られる数量
—	フラクション・ヒューマン	人間が書いたと思われる量

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

v2 フィールド	v3 フィールド
予測	windows[0].label そして windows[0].confidence
ai_尤度	windows[0].AIアシスタンススコア

重要： 解釈 AIアシスタンススコア 異なる ai_尤度これらのフィールドは一対一対応ではありません。中間範囲（0～1）での予測が増加する可能性があります。 ラベル 当社の推奨する解釈を理解するために。

---

From text-batch.api.pangram.com

v3 APIには現在バッチ処理用のエンドポイントが存在しません。各アイテムを個別に処理するため、ループを使用してください。 text.api.pangram.com 上記の移行ガイド

---

From テキストスライド.api.パングラム.com

終点: https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3

v2 フィールド	v3 フィールド	注記
予測	見出し または 予測	異なる詳細レベルが利用可能です
予測_短	予測_短	変更なし
ai_尤度, 平均AI尤度	フラクションAI, フラクションAI支援型, フラクション・ヒューマン	集計された信頼スコアの代わりに数量フィールドを使用する
最大AI尤度	フラクションAI (推奨)	数量フィールドを推奨

ウィンドウの変更:

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

v2 ウィンドウフィールド	v3 ウィンドウフィールド
windows[].予測	windows[].label + windows[].confidence
windows[].ai_likelihood	windows[].ai_assistance_score

---

From text-extended.api.pangram.com

終点: https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

ほとんどのフィールドは変更されません：

フィールド	ステータス
見出し	変更なし
予測	変更なし
予測_短	変更なし
フラクション・ヒューマン	変更なし
フラクションAI	変更なし
windows[].label	変更なし
windows[].confidence	変更なし
windows[].start_index	変更なし
windows[].end_index	変更なし

変更されたフィールド：

v2 フィールド	v3 フィールド	注記
分数混合	フラクションAI支援型	明確化のためフィールド名を変更しました
ダッシュボード	パブリックダッシュボードリンク	明確化のためフィールド名を変更しました
平均AI尤度	フラクションAI, フラクションAI支援型, フラクション・ヒューマン	集計された信頼スコアの代わりに数量フィールドを使用する
最大AI尤度	フラクションAI, フラクションAI支援型, フラクション・ヒューマン	集計された信頼スコアの代わりに数量フィールドを使用する
windows[].ai_likelihood	windows[].ai_assistance_score	AIの信頼度スコアとAI支援スコアは一対一対応ではありません。ご利用ください。 ラベル ご指導のため。

---

ドキュメント

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

---

質問はありますか？

v3への移行に関するご質問がございましたら、support@pangram.com までお問い合わせください。