AGTCloud API Docs
가이드API 레퍼런스통합 및 리소스업데이트 및 도움말
구조화된 의사결정

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 / uriBase64 바이트, 공개/서명된 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 공식 문서요청, 응답, 미디어 입력 및 제한의 전체 정의를 확인하세요.