gemini-3.6-flash 채팅 API

API 상태

24시간 상태: 100%
24시간 평균 소요 시간: 11.20 s

양호 / 정상
사용 가능
제한적
대부분 작동 중단

양호

최근 24시간

최근 30일

EveryInfra AI API의 기본 모델은 gemini-3.6-flash입니다. model 필드가 없는 요청에는 이 모델이 사용됩니다. 이 API는 OpenAI Chat Completions와 호환되므로 기존 OpenAI SDK에서 base_url과 api_key만 바꾸면 됩니다. 더 가벼운 모델이 필요하면 gemini-flash-lite 모델을 사용하세요.

금액과 관계없이 충전한 적이 있는 계정은 무료로 사용할 수 있으며, 호출에 과금되지 않습니다. 한 번도 충전하지 않은 계정은 호출할 수 없습니다.

요청 파라미터

이름	위치	타입	필수	기본값	설명
`Authorization`	header	`string`	예	-	Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
`model`	body	`string`	아니요	`gemini-3.6-flash`	모델 이름입니다. 지정하지 않으면 기본 모델(gemini-3.6-flash)이 사용됩니다. GET /api/v1/models로 모델 목록을 조회할 수 있으며 키가 필요하지 않습니다.
`messages`	body	`array`	예	-	OpenAI 형식(role + content)의 대화 메시지입니다. 전체 메시지 합계는 최대 45,000자까지 허용되며, 이를 초과하면 422가 반환되므로 여러 요청으로 나누어 보내세요.
`stream`	body	`boolean`	아니요	`false`	true이면 응답이 SSE로 전송되며 data: [DONE]으로 끝납니다. 기본값은 false입니다.
`stream_options`	body	`object`	아니요	-	OpenAI 형식의 스트리밍 옵션입니다. include_usage를 true로 설정하면 마지막 청크에 토큰 사용량이 포함됩니다.

그 밖의 OpenAI Chat Completions 파라미터(temperature, max_tokens, response_format 등)는 변경 없이 모델에 그대로 전달됩니다.

코드 샘플

bash

curl https://api.everyinfra.com/api/v1/chat/completions \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this review in one sentence: ..."
    }
  ]
}'

샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.

응답 예시

필드 미리보기

실제 호출이 아닌 예시 구조입니다. choices[0].message.content는 모델의 응답이고 usage는 토큰 수입니다. 형식은 OpenAI와 동일합니다.

json

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": …,
  "model": "gemini-3.6-flash",
  "choices": [
    {
      "index": …,
      "message": {
        "role": "assistant",
        "content": "…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": …,
    "completion_tokens": …,
    "total_tokens": …
  }
}

요청 속도 제한

등급은 계정의 누적 충전액을 기준으로 하며, 계정의 모든 키에 공통으로 적용됩니다. 건당 $1를 초과하는 크레딧 코드와 보너스 크레딧은 충전으로 계산되지만, 체험용 크레딧과 $1 이하 금액은 계산되지 않습니다. 이 값은 제한이며 보장된 처리량이 아닙니다.

충전액 금액 무관: 분당 요청 50건, 동시 요청 최대 5건
충전액 $100+: 분당 요청 500건, 동시 요청 최대 50건
충전액 $500+: 분당 요청 5,000건, 동시 요청 최대 500건

오류 및 과금

401 unauthorized: 키가 없거나 유효하지 않습니다.
403 ai_topup_required: 이 계정은 충전한 적이 없습니다. 금액에 관계없이 충전하면 사용할 수 있습니다.
422 unknown_model / missing_param / input_too_large: 모델 이름이 잘못되었거나(오류에 가장 가까운 이름이 제안됩니다), messages가 없거나, 입력이 너무 깁니다. 요청을 수정한 후 다시 보내세요.
429 rate_limited: 현재 등급의 분당 요청 수를 초과했습니다. Retry-After만큼 기다린 후 재시도하세요.
503: 모델을 일시적으로 사용할 수 없습니다. 잠시 후 다시 시도하세요.

오류