AGTCloud API Docs
文件指南API Reference整合與資源更新與幫助
結構化決策

Gemini Decisions

對共用文字、圖片、音訊、影片和 PDF 進行判斷、分類與評分。

提交共用的 input 和具名的 questions,同步取得各問題的判斷機率、分類或評分。將 MODEL_ID 替換為平台提供的完整決策模型 ID。

POST/v1beta/decisions

授權

bearerAuth
授權Bearer <token>

平台 API Key。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

同步評估共用輸入。共用輸入及全部問題合計不超過 262144 Token;JSON 巢狀深度不超過 100 層。

回應主體

application/json

application/json

問題類型與結果讀取

類型傳回內容與讀法
noul · 判斷noul 為判斷成立的機率,範圍 0.01~0.99;confidence 為 max(noul, 1 - noul)
choice · 分類或工具選擇choice 是選中的選項 ID,probabilities 是各選項機率,confidence 是最高機率
score · 評分score 是從 0 開始的等級索引的機率加權值,可以為小數;搭配 probabilities 和 legend 讀取各等級及說明

從 answers.<question_id> 讀取結果。各問題獨立評估同一輸入,不能讀取其他問題的答案;有先後依賴時,由應用程式根據結果決定下一步。工具選擇只傳回動作名稱,實際操作由應用程式執行。

輸入與媒體規則

設定使用方式
input接受文字、單一內容區塊或內容區塊陣列;文字、圖片、音訊、影片與 PDF 可組合輸入。業務 JSON 物件或陣列先序列化為文字
問題指令instructions 必填,僅支援字串或 text 內容區塊;媒體放在共用 input 中
data / uri媒體使用 Base64 位元組或公開/簽章 HTTPS URL、可用的 Files API URI;不支援 YouTube URL 或 gs:// URI
媒體大小內嵌媒體合計最多 100 MB,PDF 最多 50 MB;單一外部 URL 資源最多 15 MB。mime_type 必須與檔案真實格式一致
resolution圖片支援 low/medium/high/ultra_high,影片支援前三項;音訊和 PDF 不使用此欄位
問題與標準每請求 1~1000 個問題;問題 ID 為 1~64 個字母、數字、底線或連字號。分類為 2~255 個選項;評分為 2~255 級,通常建議 2~10 級
文字串接相鄰文字區塊直接串接;需要分隔時在文字中加入空格或換行

Token 用量

usage.total_input_tokens 為輸入總量,input_tokens_by_modality 按模態統計;影片影格及 PDF 頁面圖片計入圖片 Token。total_output_tokens 為 0,total_tokens 表示本次總用量。

Google Gemini Decisions 官方文件查看請求、回應、媒體輸入及限制的完整定義。