Gemini API를 OpenAI SDK로 호출하기
Gemini API는 OpenAI 호환 형식으로 호출합니다. Base URL을 https://api.relayswitch.io/v1로, 키를 RelaySwitch 키로 바꾸고 model에 Gemini id를 넣으면 OpenAI SDK가 그대로 동작합니다. Gemini 모델 21개가 같은 키에 있고 요금은 토큰당 선불 잔액에서 차감됩니다.
01Google 계정 없이 쓰는 Gemini API
Gemini API를 직접 쓰려면 Google 계정으로 AI Studio에서 키를 만들고 Google의 과금 방식대로 결제합니다. 여기서는 계정이 RelaySwitch에 있습니다. 이메일 하나로 가입해 선불로 충전하고, 콘솔에서 만든 키로 게이트웨이에 요청을 보내면 게이트웨이가 Gemini로 전달합니다. 코드에서 달라지는 것은 주소와 키뿐이고 모델 id는 Gemini의 id 그대로입니다.
Gemini에는 고유한 요청 형식(generateContent)이 있지만, 기존 도구와 코드의 다수는 OpenAI의 Chat Completions 형식으로 작성되어 있습니다. Google도 이를 위해 OpenAI 호환 인터페이스를 제공하며 문서에 이 지원이 아직 베타라고 적어 두었습니다. 이 사이트도 같은 방식이어서, 가격표의 모든 Gemini id를 OpenAI 형식으로 호출할 수 있습니다.
02curl로 키와 주소 확인
SDK에 넣기 전에 curl 한 번으로 확인하십시오. Base URL에는 /v1이 들어가고 SDK가 그 뒤에 /chat/completions를 붙입니다. model 값은 아래 가격표에 지금 나와 있는 id를 그대로 씁니다. 틀리게 쓰면 404 model_not_found가 반환됩니다.
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gemini-3.1-pro-preview", "messages": [{"role": "user", "content": "Reply with ok"}]}'03Python: OpenAI SDK로 Gemini 호출
base_url, api_key, model 세 값만 바꿉니다. 이미 OpenAI 형식으로 작성한 코드를 Gemini로 돌릴 때는 model 필드 하나만 고치면 되고, GPT나 Claude와 나란히 비교할 때도 마찬가지입니다. 스트리밍은 stream을 true로 두면 server-sent events로 내려오며 OpenAI의 형식과 같습니다.
Google의 OpenAI 호환 문서를 따라 작성한 코드라면 이미 OpenAI SDK를 쓰고 있으므로 요청 본문은 그대로 둡니다. 다만 Google 문서에서 extra_body로 넘기는 Gemini 전용 필드는 이 페이지에서 항목별로 검증하지 않았습니다. 사용한다면 요청 하나로 먼저 시험하고 영수증의 과금이 예상과 맞는지 확인하십시오.
from openai import OpenAI client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.chat.completions.create( model="gemini-3.1-pro-preview", messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.choices[0].message.content)04Gemini 모델 실시간 가격
백만 토큰당 달러 가격이며 페이지를 렌더링할 때 카탈로그에서 읽습니다. 표에 보이는 단가가 그대로 차감됩니다. id에 preview가 붙은 모델은 프리뷰 버전이고 Google이 나중에 정식 이름으로 바꾸므로, 코드에 넣는 id는 표에 지금 나와 있는 것을 기준으로 하십시오.
Gemini는 계약서 전체, 코드 저장소, 회의 녹취록처럼 긴 자료를 읽히는 데 자주 쓰입니다. 이런 요청은 비용 대부분이 입력에서 나오므로 입력 단가와 컨텍스트 크기를 먼저 보고 그다음에 출력 단가를 보십시오. 같은 자료에 반복해서 질문하면 두 번째부터 반복되는 부분이 캐시에 적중해 캐시 입력 단가로 계산되고, 영수증에 그 토큰 수가 따로 적힙니다.
| 모델 | 개발사 | 입력 | 출력 | 컨텍스트 |
|---|---|---|---|---|
| Gemini 4 Argongemini-4-argon | $0.60≈ ₩818 | $3.00≈ ₩4,092 | 1,048,576 | |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925≈ ₩672 | $2.25≈ ₩3,069 | 1,048,576 | |
| Gemini 3.7 Flashgemini-3.7-flash | $0.4925≈ ₩672 | $2.25≈ ₩3,069 | 1,048,576 | |
| Gemini 3.5 Flash Litegemini-3.5-flash-lite | $0.225≈ ₩307 | $1.875≈ ₩2,557 | 1,048,576 | |
| Gemini 3.6 Flashgemini-3.6-flash | $0.4925≈ ₩672 | $2.25≈ ₩3,069 | 1,048,576 | |
| Gemini 3.5 Flashgemini-3.5-flash | $1.50≈ ₩2,046 | $9.00≈ ₩12,275 | 1,048,576 | |
| Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-preview | $0.1875≈ ₩256 | $1.125≈ ₩1,534 | 1,048,576 | |
| Gemini 3.1 Pro Previewgemini-3.1-pro-preview | $1.20≈ ₩1,637 | $7.20≈ ₩9,820 | 1,048,576 | |
| Gemini 3.1 PRO Preview LOWgemini-3.1-pro-preview-low | $5.00≈ ₩6,819 | $22.50≈ ₩30,687 | 1,048,576 | |
| Gemini 3 Flash Previewgemini-3-flash-preview | $0.375≈ ₩511 | $2.25≈ ₩3,069 | 1,048,576 | |
| Gemini 2.5 Flashgemini-2.5-flash | $0.30≈ ₩409 | $2.50≈ ₩3,410 | 1,048,576 | |
| Gemini 2.5 Progemini-2.5-pro | $0.9375≈ ₩1,279 | $7.50≈ ₩10,229 | 1,048,576 | |
| Gemini 2.5 Flash Litegemini-2.5-flash-lite | $0.075≈ ₩102 | $0.30≈ ₩409 | ||
| Gemini 3 Pro Previewgemini-3-pro-preview | $5.00≈ ₩6,819 | $22.50≈ ₩30,687 | ||
| Gemini 3.1 Flash Litegemini-3.1-flash-lite | $0.15≈ ₩205 | $0.90≈ ₩1,227 | ||
| Gemini 3.1 PRO Preview Customtoolsgemini-3.1-pro-preview-customtools | $4.80≈ ₩6,547 | $28.80≈ ₩39,280 | 1,048,576 | |
| Gemini 4 Carbongemini-4-carbon | $2.3529≈ ₩3,209 | $11.7647≈ ₩16,046 | ||
| Gemini 4 Hydrogengemini-4-hydrogen | $0.5882≈ ₩802 | $2.9412≈ ₩4,011 | ||
| Gemini Flash Latestgemini-flash-latest | $1.80≈ ₩2,455 | $9.00≈ ₩12,275 | 1,048,576 | |
| Gemini Flash Lite Latestgemini-flash-lite-latest | $0.72≈ ₩982 | $6.00≈ ₩8,183 | 1,048,576 | |
| Gemini PRO Latestgemini-pro-latest | $4.80≈ ₩6,547 | $28.80≈ ₩39,280 | 1,048,576 |
백만 토큰당 가격(USD) · ≈ 는 유럽중앙은행 2026-11-13 환율로 환산한 원화 참고 가격이며, 과금은 미국 달러로 이루어집니다
05Gemini 네이티브 형식: generateContent
Google의 요청 형식으로 이미 작성된 프로그램은 다시 쓸 필요가 없습니다. 카탈로그의 Gemini id 가운데 이 경로를 지원하는 모델은 https://api.relayswitch.io/v1beta/models/{model}:generateContent로 호출합니다. 도메인 바로 뒤에 /v1beta가 오고 /v1은 붙지 않습니다.
키는 x-goog-api-key 헤더에 넣습니다. URL의 쿼리 파라미터에 넣은 키는 게이트웨이가 거부합니다. 요청과 응답은 Google의 구조 그대로여서 contents를 보내고 candidates를 받습니다. 두 형식은 같은 키, 같은 잔액을 쓰고 가격도 같습니다.
오류도 형식을 따릅니다. OpenAI 형식에서는 error.code에 오류 코드가 들어가고, 네이티브 형식에서는 Google의 방식이어서 예를 들어 키를 빠뜨리면 401과 함께 error.status가 UNAUTHENTICATED로 반환됩니다. 상태 코드별 원인은 OpenAI API 사용법 페이지의 오류 코드 표에 있으며 Gemini를 OpenAI 형식으로 호출할 때 그대로 적용됩니다.
06운영 환경에 올리기 전에
운영용 키를 따로 만들고 달러 예산과 일일 사용 한도를 설정한 뒤, 모델 허용 목록으로 골라 둔 Gemini id만 호출하도록 제한하십시오. 긴 문서를 읽는 프로그램은 특히 상한이 필요합니다. 실수로 디렉터리 전체를 보낸 요청 하나의 입력이 수십만 토큰이 될 수 있기 때문입니다. 실패한 요청은 retry-after 헤더를 보고 재시도 간격을 정합니다.
모델 선택은 추측할 필요가 없습니다. 모든 Gemini id가 같은 키에 있으므로 같은 프롬프트를 각각 한 번씩 보내고 응답과 영수증의 비용을 비교하면 됩니다. 표시된 모델이 그대로인지는 하루 한 번 공개 점검하며, 판정을 읽는 방법은 모델 검증 페이지에 있습니다.
자주 묻는 질문
- Gemini API key는 어디서 발급하나요?
- app.relayswitch.io 에서 이메일로 가입하고 카드 또는 암호화폐로 $10부터 충전한 뒤 콘솔에서 sk-relay- 로 시작하는 키를 만듭니다. 코드에서는 base_url을 https://api.relayswitch.io/v1 로, api_key를 이 키로, model을 Gemini id로 지정하고 OpenAI SDK의 Chat Completions로 호출합니다.
- Google 계정이나 AI Studio 키가 필요한가요?
- 필요 없습니다. Google의 Gemini API는 Google 계정으로 AI Studio에서 키를 만들어야 하지만, 여기서는 계정이 RelaySwitch에 있고 이메일 하나면 됩니다. 같은 키로 카탈로그의 다른 모델도 호출합니다.
- OpenAI SDK와 Gemini 네이티브 형식 중 무엇을 써야 하나요?
- 새로 작성하는 프로그램은 OpenAI SDK를 권합니다. base_url만 바꾸면 되고 다른 개발사 모델로 바꿀 때도 model 필드 하나만 고칩니다. 이미 Google의 generateContent로 작성한 프로그램은 네이티브 경로로 요청을 보내고 키를 x-goog-api-key 헤더에 넣습니다. 두 형식은 같은 키, 같은 잔액, 같은 가격입니다.
- Gemini API 가격은 어디서 확인하나요?
- 이 페이지의 가격표가 카탈로그에서 실시간으로 읽은 단가이며 표의 숫자가 그대로 차감됩니다. Google이 공개한 공식 가격은 Google의 가격 페이지에서 확인해 모델별로 비교할 수 있습니다.
- Gemini API에 무료 등급이 있나요?
- Google의 Gemini API에는 일부 모델에 속도 제한이 걸린 무료 등급이 있으며, 어떤 모델이 포함되는지는 Google의 가격 페이지를 기준으로 합니다. RelaySwitch에는 무료 등급이 없습니다. 요청마다 선불 잔액에서 토큰 단위로 차감되고 최소 충전액은 $10이며 잔액은 만료되지 않습니다.
- 호출되는 모델이 진짜 Gemini인지 어떻게 확인하나요?
- 모든 모델에 매일 같은 점검 프롬프트를 보내 이전 응답과 비교하며 결과는 https://api.relayswitch.io/v1/proof 에서 키 없이 볼 수 있습니다. 요청마다 모델 id, 과금 토큰, 비용이 적힌 서명된 영수증(GET https://api.relayswitch.io/v1/requests/:id/receipt)도 발급됩니다.