Blog

Gemini 3.0 API 사용법

Ashley Innocent

Ashley Innocent

18 November 2025

Gemini 3.0 API 사용법

개발자들은 높은 비용 부담 없이 강력한 AI 모델을 끊임없이 찾고 있습니다. Google은 Gemini 3 Pro와 같은 미리 보기 버전을 포함한 고급 모델에 무료로 액세스할 수 있도록 함으로써 이러한 요구를 해결합니다.

💡
계속하기 전에 지금 바로 Apidog를 무료로 다운로드하세요 – Gemini 3 API에 요청을 보내고, 응답을 검사하며, 다중 모드 입력을 처리하고, 무료 등급 실험 중에 엔드포인트를 효율적으로 디버깅하는 데 탁월한 API 클라이언트 역할을 합니다.

버튼

Google은 Google AI Studio를 통해 Gemini API에 대한 관대한 무료 등급을 유지하고 있습니다. 이 설정을 통해 API 키를 생성하고 즉시 모델을 호출할 수 있습니다. 또한 2025년 11월 현재 Google은 프로토타이핑, 테스트 및 소규모 애플리케이션에 적합한 속도 제한이 있더라도 Gemini 3 Pro 미리 보기 모델에 무료로 액세스할 수 있도록 제공하고 있습니다.

Gemini 3 API 가격 이해하기

일반적으로 Gemini 3.0의 가격은 다음과 같습니다.

Gemini 3.0의 지식 마감일은 2025년 1월로 설정되어 있습니다.

Gemini 3.0 API를 무료로 사용하고 싶다면 Google은 여러분이 시도해 볼 수 있도록 충분히 관대합니다. Google은 Gemini API를 무료 및 종량제라는 두 가지 주요 등급으로 구성합니다. 무료 등급은 청구 활성화 없이 완전히 작동합니다. 따라서 더 높은 할당량을 위해 클라우드 청구를 명시적으로 활성화할 때까지 모든 요청은 무료로 유지됩니다.

Google AI Studio는 무료 액세스를 위한 주요 인터페이스 역할을 합니다. 여기에서 프롬프트를 프로토타이핑하고, API 키를 생성하며, 모델을 직접 호출할 수 있습니다. Gemini 3 Pro와 같은 미리 보기 모델은 해당 지역에서 사용 가능한 경우 모델 선택기에 자동으로 나타납니다.

무료 등급의 주요 장점은 다음과 같습니다.

그러나 무료 등급은 공정한 사용을 보장하기 위해 할당량을 적용합니다. Gemini 3 Pro 미리 보기 모델의 일반적인 제한은 분당 약 5~10회 요청(RPM), 분당 250,000 토큰(TPM), 일일 50~100회 요청(RPD)입니다. 이러한 값은 모델 변형 및 지역에 따라 다르며, Google은 주기적으로 이를 조정합니다.

단계별: Gemini 3 API 키 생성하기

Google AI Studio에서 API 키를 생성하는 것으로 시작합니다. 다음 정확한 단계를 따르십시오.

  1. aistudio.google.com으로 이동합니다.
  2. Google 계정(개인 또는 Workspace)으로 로그인합니다.

4. 오른쪽 상단 모서리에 있는 프로필 아이콘을 클릭하고 "API 키 가져오기"를 선택합니다. "새 프로젝트에서 API 키 만들기"(또는 기존 프로젝트 선택)를 선택합니다.

6. Google이 즉시 키를 생성합니다. 즉시 복사하십시오 – 다시 볼 수 없습니다.

또한 보안을 위해 여러 키를 생성하고 특정 리퍼러 또는 IP 주소로 제한할 수 있습니다. 키는 항상 민감한 데이터로 취급하고 공개 저장소에 절대로 커밋하지 마십시오.

Gemini 3 Pro 미리 보기에 직접 액세스하려면 Google에서 제공하는 다음 링크를 방문하십시오: https://aistudio.google.com/prompts/new_chat?model=gemini-3-pro-preview. 이 링크는 미리 보기 모델로 사전 구성된 채팅 인터페이스를 엽니다.

Google AI Studio에서 Gemini 3.0 API를 사용해 봅시다.

프로그래밍 방식 액세스를 위한 공식 Gemini SDK 설치

Google은 여러 언어로 클라이언트 라이브러리를 제공합니다. 패키지 관리자를 통해 설치합니다.

Python 개발자의 경우:

pip install -U google-generativeai

그런 다음 라이브러리를 구성합니다:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY_HERE")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content("Explain quantum entanglement in simple terms.")
print(response.text)

Node.js 사용자는 다음을 실행합니다:

npm install @google/generative-ai

const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("YOUR_API_KEY_HERE");
const model = genAI.getGenerativeModel({ model: "gemini-3-pro-preview-11-2025" });

const result = await model.generateContent("Write a Python function to calculate Fibonacci numbers.");
console.log(result.response.text());

지원되는 다른 언어로는 Go, Java, Swift가 있습니다. 모든 라이브러리는 인증, 재시도 및 스트리밍을 자동으로 처리합니다.

curl을 사용하여 Gemini 3 API에 첫 번째 요청 보내기

빠른 확인을 위해 curl로 직접 테스트할 수 있습니다:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview-11-2025:generateContent?key=YOUR_API_KEY \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Describe the key improvements in Gemini 3 over previous versions." }]
    }]
  }'

이 엔드포인트는 생성된 텍스트와 사용량 메타데이터를 포함하는 JSON 응답을 반환합니다.

더욱 통합된 API 테스트 워크플로우를 위해 Apidog 사용하기

순수한 curl 명령은 간단한 테스트에는 유용하지만, 프로덕션 수준의 개발에는 더 나은 도구가 필요합니다. Apidog는 완전한 기능을 갖춘 API 클라이언트 및 문서 플랫폼으로서 여기서 탁월한 성능을 발휘합니다.

버튼

Apidog에 공식 Gemini OpenAPI 사양을 임포트하면, 모든 엔드포인트, 파라미터 및 요청 본문이 자동으로 생성됩니다. 이후 다음과 같은 작업을 수행할 수 있습니다.

Gemini 3 API 엔드포인트 테스트를 위한 Apidog 인터페이스

많은 개발자들이 Gemini 워크플로우를 위해 Apidog를 선택하는 이유는 Apidog가 대용량 파일 업로드, 스트리밍 응답 및 구조화된 JSON 출력을 원활하게 처리하기 때문입니다. 이는 Postman이 생성형 API에 대해 어려움을 겪는 기능입니다.

Gemini 3.0 API 속도 제한은 무엇인가요?

Google은 현재 Gemini 3.0 API의 속도 제한을 공개하지 않았지만, 사용자들은 몇 번의 채팅 내에서 속도 제한 문제(오류 코드: You've reached your rate limit. Please try again later.)를 겪고 있다고 보고하고 있습니다.

Google 공식 문서에 따르면, Gemini API는 공정한 사용을 보장하기 위해 속도 제한이 적용되는 Google AI Studio를 통해 액세스할 수 있는 무료 등급을 제공합니다. 이러한 제한은 주로 분당 요청(RPM)으로 측정되며, 일부 모델의 경우 일일 요청(RPD) 및 분당 토큰(TPM)으로도 측정됩니다. 예를 들어, 표준 gemini-1.0-pro 모델은 개발 및 테스트에 일반적으로 충분한 60 RPM의 무료 속도 제한을 가집니다. 이러한 제한은 무료로 제공되며 청구 계정을 설정할 필요가 없습니다.

Gemini 계열 내의 다른 모델은 다른 속도 제한을 가집니다. 모델의 속도 제한을 초과하면 HTTP 429 "Resource Exhausted" 오류가 발생합니다. 이를 관리하려면 개발자는 지수 백오프(exponential backoff) 전략으로 오류 처리를 구현해야 합니다. 이는 요청을 재시도하기 전에 점차적으로 더 긴 시간 동안 기다리는 것을 포함합니다. 무료 등급에서 허용하는 것보다 더 높은 요청 볼륨이 필요한 애플리케이션의 경우, Google Cloud 프로젝트에서 청구를 활성화하고 훨씬 더 높은 제한을 제공하는 종량제(pay-as-you-go) 요금제로 전환해야 합니다(ai.google.dev).

더 높은 처리량을 위해서는 여러 개의 Google 계정(각각 고유한 키 포함)을 생성하고 이를 순환 사용하는 것이 일반적인 관행입니다. 이는 무료 제한 내에서 유지하려는 개발자들 사이에서 흔히 사용됩니다.

Gemini 3.0 API를 활용한 비전 및 비디오

Gemini 3는 이미지와 비디오를 기본적으로 처리합니다. 이미지 분석을 위한 Python 코드 예시:

from google.generativeai.types import File

image_file = genai.upload_file(path="diagram.png")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content([
    "Explain this architecture diagram in detail:",
    image_file
])
print(response.text)

비디오 이해도 비슷하게 작동합니다. MP4 파일을 업로드하고 내용, 타임스탬프 또는 작업에 대해 질문할 수 있습니다.

결론

Google은 무료 등급을 통해 최첨단 AI에 대한 전례 없는 액세스를 제공합니다. 2분 이내에 키를 얻고, Gemini 3 Pro 미리 보기 모델을 즉시 호출하며, 비용을 들이지 않고 정교한 애플리케이션을 구축할 수 있습니다.

이 기능을 Apidog와 같은 강력한 API 클라이언트와 결합하면 유료 서비스에 필적하는 완전한 개발 환경을 얻게 됩니다. 수천 명의 개발자가 이미 이러한 방식으로 에이전트, RAG 시스템 및 다중 모드 앱을 프로토타이핑하고 있습니다.

지금 바로 행동하세요: Google AI Studio로 이동하여 키를 생성하고, Apidog를 다운로드한 다음, 첫 번째 Gemini 3 요청을 보내십시오. 최첨단 AI로 구축하는 장벽은 그 어느 때보다 낮아졌습니다.

버튼

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드