경로 파라미터
string
필수
모델 이름 (예:
gemini-2.5-pro, gemini-3.5-flash).쿼리 파라미터
string
API 키 (헤더 인증의 대안).
인증
Gemini 엔드포인트는 여러 인증 방법을 지원합니다:?key=YOUR_API_KEY쿼리 파라미터x-goog-api-key: YOUR_API_KEY헤더Authorization: Bearer YOUR_API_KEY헤더
요청 본문
array
필수
대화 콘텐츠입니다.
role 값과 모든 parts를 보낸 그대로 유지하며 trim/lowercase, Base64 재작성, MIME 추론을 하지 않습니다. inlineData / inline_data와 fileData / file_data는 모두 공식 표기이며 TokenLab는 fileData.mimeType을 로컬 필수값으로 두지 않습니다. TokenLab에서 생성한 Files/Cache ID는 소유권을 확인하고 원래 upstream binding을 유지하며 나머지 미디어와 도구 규칙은 provider가 결정합니다.object
모델을 위한 시스템 지침.
object
네이티브 생성 설정입니다.
maxOutputTokens, candidateCount, thinkingConfig 같은 lowerCamelCase와 대응하는 snake_case 이름을 변경 없이 받습니다. 실패 후 thinkingConfig를 제거하거나 streaming candidateCount에 로컬 제한을 두지 않으며 범위와 조합은 upstream이 결정합니다.array
안전 필터 설정.
응답
array
생성된 콘텐츠 후보.
object
토큰 사용 정보.
멀티모달 입력 예시
Gemini 멀티모달 요청에서는 미디어를contents[].parts[] 안에 넣고, 인라인 바이트 또는 URL 기반 파일 참조 중 하나를 사용합니다.
현재 공개 Gemini 계약에서 지원하는 미디어 카테고리:
- 이미지
- 오디오
- 비디오
inlineData 또는 inline_data 를 사용하고 Base64 인코딩된 파일 바이트를 전달합니다.
URL 미디어는 fileData 또는 file_data 를 사용하고 공개적으로 접근 가능한 https URL을 전달합니다.