연동 키트API 연동Gemini 4 Neon
Gemini 4 Neon API 사내 자동화 연동
- 누가 · 어디에
- 복잡한 코드 분석과 다단계 업무 자동화 파이프라인을 구축하는 사내 개발자
- 업무 효과
- 기존 Carbon 대비 32% 낮은 작업 비용으로 프론티어급 추론과 고난도 작업을 처리
공식 API · SDK 로 우리 시스템에 붙입니다. AI 가 공식 문서를 찾아 정리한 가이드로, mopick 이 직접 따라 해 보지는 않았습니다 · 공식 문서에서 제품을 확인했습니다
준비할 것
- Google AI Studio 또는 Cloud 유료 결제 계정
- Gemini API 키 (GEMINI_API_KEY)
- cURL 터미널 환경 또는 Python 3.10+ (google-genai 2.34.0 이상)
연동 단계
해 본 단계는 번호를 눌러 표시하세요. 표시는 이 브라우저에만 남습니다.
0% 진행
API 키 발급
Google AI Studio(aistudio.google.com)에 로그인한 뒤 좌측 'Get API key' 메뉴를 눌러 새 API 키를 생성하고 복사합니다.
유료 결제 등록
Neon 모델은 무료 티어가 제공되지 않으므로 Google Cloud 결제 계정을 연결해 종량제(Pay-as-you-go) 요금제를 활성화합니다.
환경 변수 설정
터미널에서 export GEMINI_API_KEY='YOUR_API_KEY' 명령을 실행해 API 키를 환경 변수로 등록합니다.
API 요청 호출
모델 식별자를 'gemini-4-neon'으로 지정하고 generateContent 또는 Interactions 엔드포인트로 JSON 요청을 전송합니다.
붙여 넣는 설정 · 코드
YOUR_API_KEY 같은 자리에는 내 값을 넣으세요. 키는 코드 · 문서에 그대로 남기지 말고 환경 변수 · 비밀 저장소에 두세요.
cURL generateContent 호출 bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-4-neon:generateContent?key=$GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{"parts": [{"text": "업무 자동화용 Python 스크립트 작성해줘."}]}]
}'- 잘 연결됐는지 확인
- 응답 JSON의 candidates 배열 내 parts.text에 모델의 추론 및 생성 결과가 정상 반환되는지 확인합니다.
- 비용
- 무료 등급 없음. 입력 100만 토큰당 $3.00, 출력 100만 토큰당 $15.00, 캐시된 입력 100만 토큰당 $0.15.
- 주의
- · 무료 티어가 지원되지 않으며 사고(Thinking) 토큰을 포함한 모든 입출력 토큰이 유료 과금됩니다.
- · temperature, top_p, top_k 등 샘플링 파라미터 커스텀 설정은 API 상에서 무시됩니다.
- · 추론 기능은 비활성화할 수 없으며 thinking_level은 LOW, MEDIUM, HIGH, XHIGH 4가지만 지원됩니다.
공식 문서
우리 회사 시스템에 붙여야 한다면 — 업무 앱 · 사내 자료 · 보안 조건에 맞춘 연동을 TPI INSIGHT AX센터가 함께합니다.