Gemini
Gemini 3.1 Pro Preview · 채팅 완성
텍스트 / Gemini / Gemini 3.1 Pro Preview / 채팅 완성
POST
/v1/chat/completions요청 파라미터
Authorization
Header에 Authorization을 추가하고 값은 Bearer 뒤에 API 키를 붙입니다.
Authorization: Bearer ****************
Header 파라미터
Content-Typestring선택
application/json
Acceptstring선택
application/json
Body 파라미터application/json필수
modelstring필수
모델 ID, `gemini-3.1-pro-preview` 로 고정
messagesarray[object]필수
대화 메시지 목록이며, 각 항목은 `role`(system / user / assistant)과 `content` 를 포함합니다
streambool선택
응답을 스트리밍(SSE)할지 여부, 기본값 `false`
temperaturenumber선택
샘플링 온도, 클수록 무작위
top_pnumber선택
뉴클리어스 샘플링; `temperature`의 대안. 범위 `0`–`1`
max_tokensint선택
생성 토큰 최대 수
nint선택
생성할 후보 응답 수, 기본값 `1`
stoparray선택
정지 시퀀스. 하나라도 일치하면 출력을 멈춤
presence_penaltynumber선택
이미 등장한 토큰에 페널티를 주어 새로움을 높임. 범위 `-2`–`2`
frequency_penaltynumber선택
빈도에 따라 토큰에 페널티를 주어 반복을 줄임. 범위 `-2`–`2`
reasoning_effortstring선택
사고형 모델의 추론 깊이: `low` / `medium` / `high`
toolsarray선택
도구 / 함수 정의(function calling)
tool_choicestring/object선택
도구 호출 여부와 대상: `auto` / `none` / 지정 도구
response_formatobject선택
출력 형식 제약, 예: JSON 객체 강제
extra_bodyobject선택
`thinking_config` 등 공급사 전용 옵션을 `extra_body`로 전달
예시
{ "model": "gemini-3.1-pro-preview", "messages": [ { "role": "user", "content": "안녕하세요, 자기소개를 해주세요" } ]}요청 코드 예시
curl https://api.hotrouter.ai/v1/chat/completions \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3.1-pro-preview", "messages": [ { "role": "user", "content": "안녕하세요, 자기소개를 해주세요" } ] }'응답
200 · 성공
idstring필수
이 응답의 고유 id
objectstring필수
객체 유형
createdinteger필수
생성 타임스탬프(초)
modelstring필수
실제 사용된 모델
choicesarray[object]필수
생성 결과 목록
usageobject필수
이번 호출의 토큰 사용량
예시
{ "id": "chatcmpl-xxx", "object": "chat.completion", "created": 1730000000, "model": "gemini-3.1-pro-preview", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "안녕하세요! 반갑습니다……" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36 }}