Gemini 3.5 Flash · 채팅 완성

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.5-flash` 로 고정

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.5-flash",
  "messages": [
    {
      "role": "user",
      "content": "안녕하세요, 자기소개를 해주세요"
    }
  ]
}

{  "model": "gemini-3.5-flash",  "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.5-flash",
    "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.5-flash",    "messages": [      {        "role": "user",        "content": "안녕하세요, 자기소개를 해주세요"      }    ]  }'

응답

200 · 성공

idstring필수

이 응답의 고유 id

objectstring필수

객체 유형

createdinteger필수

생성 타임스탬프(초)

modelstring필수

실제 사용된 모델

choicesarray[object]필수

생성 결과 목록

usageobject필수

이번 호출의 토큰 사용량

예시

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gemini-3.5-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "안녕하세요! 반갑습니다……"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 24,
    "total_tokens": 36
  }
}

{  "id": "chatcmpl-xxx",  "object": "chat.completion",  "created": 1730000000,  "model": "gemini-3.5-flash",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": "안녕하세요! 반갑습니다……"      },      "finish_reason": "stop"    }  ],  "usage": {    "prompt_tokens": 12,    "completion_tokens": 24,    "total_tokens": 36  }}

Gemini 3.5 Flash · 채팅 완성

요청 파라미터

요청 코드 예시

응답

On this page