公式SDK4種に変更案、Googleは未発表
米Googleが開発者向けの「Gemini API」に、選択や判定の答えだけを返す「Decisions API」を加えようとしていることが分かった。同社の公式SDK（開発用の部品集）のPython、JavaScript、Go、Javaの4種のGitHubに11月11日（日本時間同日23時56〜57分）、client.decisions.create を追加する変更案（プルリクエスト）が出された。題名はいずれも「feat: add the Decisions API (client.decisions.create) to the GenAI SDKs」で、Googleがコードの同期に使う自動化のアカウント（copybara-service）が投稿した。
APIの変更を検知するbotの@aitrackerbotが、日本時間11日23時59分にXで伝えた。ORIENSは12日、4本の変更案の差分を読み、内容を確かめた。
4本はいずれも未マージで、SDKにはまだ取り込まれていない。マージ前の変更案のため、内容が変わったり、取り込まれずに閉じられたりする可能性がある。Googleは発表しておらず、Gemini APIの更新履歴（12日時点の最新は11月10日分）、公式ドキュメント、APIの構造を機械向けに公開する「Discovery文書」にも、Decisions APIの記載はない。
質問はnoul、choice、scoreの3種類
Python版の変更案によると、呼び出しに必須の項目は、判定の材料になる共有の入力 input、使うモデル model、質問の一覧 questions の3つ。質問には呼び出す側が自由に付けたIDをキーにし、1回の呼び出しで1つ以上の質問をまとめて判定する。非同期の呼び出しは client.aio.decisions.create になる。
質問の種類は3つある。noulは真（true）か偽（false）かを問う形式で、真である確率を0.01〜0.99で返す。choiceは2〜255の選択肢から1つを選ぶ形式で、最も確率の高い選択肢と、各選択肢の確率を返す。scoreは2〜255段階の評価基準（ルーブリック）で採点する形式で、確率で重み付けした点数と各段階の確率を返す。どの形式も、各質問に判断の基準を文章で書いた instructions が必須になる。
回答の型の説明文は、いずれも「Calibrated result」（較正された結果）となっている。JavaScript、Go、Javaの変更案にも、質問の種類と選択肢や段階の数について同じ説明文がある。
| 形式 | 問い方 | 返す値 |
|---|---|---|
| noul | 真（true）か偽（false）か | 真である確率（0.01〜0.99） |
| choice | 2〜255の選択肢から1つ | 最も確率の高い選択肢、各選択肢の確率 |
| score | 2〜255段階の評価基準で採点 | 確率で重み付けした点数、各段階の確率 |
入力は文字に加え画像や音声も
Python版の型の定義では、入力 input に文字、文書、画像、音声、動画を渡せる。応答には、入力が安全上の理由などで遮られた場合の理由と、トークンの使用量が含まれる。
PythonとJavaScriptの試験用のコードは、APIの POST /v1beta/decisions に要求を送る形になっている。試験は模擬のサーバーを相手にしたもので、実際のAPIが要求を受け付けるかは確かめられていない。試験のモデル名は仮の値で、どのモデルが対応するかは変更案に書かれていない。
Go版のファイルは、モデルやエージェントを呼び出す「Interactions API」（client.interactions.create）用のフォルダーの下に置かれている。ただし Decisions は別のサービスとして定義され、要求の送り先も /decisions で、Interactions APIとは別の機能だ。
OpenAIは10月に一般公開
「Decisions API」という名前の機能は、米OpenAIが10月22日（日本時間23日）に一般公開している。OpenAIの公式ガイドによると、必須の項目はモデル、入力、質問の3つで、質問の種類は条件に当てはまる確率を返すpredicate、選択肢から選ぶchoice、2〜10段階で評価するscoreの3つ。対応モデルは軽量の「GPT-6 Luna」（gpt-6-luna）だけとしている。
Googleの変更案とは、必須の3項目の名前（model、input、questions）と、質問を3種類に分ける点が共通する。真偽を問う形式の名前（noulとpredicate）や、段階の上限（255段階と10段階）は異なる。OpenAIは料金と速さを公表しているが、Googleの変更案には料金、応答の速さ、対応モデルの記載がない。
料金、対応モデル、提供時期は不明
変更案にも公式の資料にも、料金、応答の速さ、対応モデル、提供の時期は書かれていない。ORIENSはAPIキーを使った試験をしておらず、Decisions APIを今呼び出せるかは分かっていない。説明文にある「Calibrated」の語についても、Googleは精度の検証結果を示していない。
11月12日追記：Googleは判定専用のモデル「Gemini Decision」（gemini-decision-1）とDecisions APIを公開し、Gemini APIの更新履歴の米国時間11月11日付の項に「Released」と記した。本記事で伝えた公式SDK4種の変更案は、日本時間12日2時11〜12分にそろってマージされた。料金や対応モデルを含む詳細は続報で伝えている。
