API 비용 줄이는 설계
2026.08.05

📝 한줄 요약
주소 검색과 거리 계산 둘 다 지도 기능인데, 하나는 무료 서비스로 하나는 유료 서비스로 나눠 붙였습니다. 기준은 “얼마나 자주 부르는가”와 “얼마나 정확해야 하는가”였습니다.
Before: 유료 API를 쓰면 얼마 나올지 몰라서 무서움 After: 연간 599건이라는 실제 숫자로 계산해보니 0원
👥 이런 분께 추천
유료 API를 붙여야 하는데 비용이 무서운 분
무료 서비스와 유료 서비스 중 뭘 쓸지 고민 중인 분
“일단 만들고 나중에 최적화”와 “지금 최적화” 사이에서 헷갈리는 분
개발자에게 넘길 문서를 쓰고 있는 비개발자
🙋 내 스펙 & 환경
항목 | 내용 |
|---|---|
코딩 경험 | 비개발자. |
AI 도구 | Claude Code |
환경 | 윈도우 11 |
다루는 업무량 | 초과근무 미팅 연 599건 (2025년 실적) |
진행 방법
1. 왜 하게 되었나
거리 계산에 Google 지도 API를 붙이기로 했습니다. 그런데 붙이고 나서 걱정이 됐어요.
주소 관련 기능은 원래 Photon이라는 무료 서비스를 쓰고 있었거든요. 비용을 아끼려고 일부러 무료를 골랐던 건데, 이제 Google을 붙였으니 그 노력이 헛수고가 된 건 아닌가 싶었습니다.
그래서 물어봤습니다.
그럼 원래 주소를 쓸 때 Photon API를 썼잖아.
근데 google api로 사용해도 될까? 최대한 비용절감을 하려고 photon을 쓴 건데.
주소 검색은 photon으로 하고 초과근무 건만 google api 사용해서
마일 계산하면 비용을 절감할 수 있으려나?
이게 2025년 총 600건이었거든2. 확인해보니 이미 나눠져 있었다
확인해보니 제가 걱정한 구조가 이미 만들어져 있었습니다. Google은 거리 계산에만 붙었고, 주소 검색은 Photon 그대로였어요.
하는 일 | 무엇을 쓰나 | 비용 |
|---|---|---|
주소 검색 (타이핑할 때마다) | Photon | 무료 |
거리 계산 (주소를 고른 순간 1번) | 유료 (무료 구간 있음) |
3. 왜 이렇게 나누는 게 맞나: 호출 횟수
핵심은 두 기능이 불리는 횟수가 완전히 다르다는 점이었습니다.
언제 불리나 | 한 건당 호출 | |
|---|---|---|
주소 검색 | 글자를 칠 때마다 | 여러 번 |
거리 계산 | 주소가 정해진 뒤 | 한 번 |
주소 검색은 타이핑 중에 계속 불립니다. 주소 하나 넣는 데 열 번씩 부를 수도 있어요. 반면 거리 계산은 주소가 확정된 다음 한 번이면 끝납니다.
그래서 호출이 많은 쪽에 무료를, 적은 쪽에 유료를 붙이는 게 맞습니다. 반대로 했으면 비용이 열 배로 늘었을 거예요.
4. 왜 이렇게 나누는 게 맞나: 정확도
정확도가 필요한 자리도 거리 계산 쪽이었습니다.
정확도가 왜 필요한가 | |
|---|---|
거리 계산 | 수당 타입 A와 B를 가르는 근거 값. 틀리면 돈이 잘못 나감 |
주소 검색 | 후보만 띄우면 됨. 최종 확인은 사람이 눈으로 골라서 함 |
주소 검색은 조금 부정확해도 사람이 걸러냅니다. 하지만 거리는 그대로 판정에 쓰이니까 틀리면 안 돼요.
즉 호출 횟수와 정확도, 두 기준이 같은 답을 가리켰습니다. 거리 계산이 유료를 쓸 자리였습니다.
5. 실제로 얼마 나오나: 599건으로 계산하기
여기서 제가 가진 실제 숫자가 쓸모가 있었습니다. 200배가 늘어나도 무료 구간 안입니다.
이 숫자를 알고 나니 판단이 쉬워졌습니다. 막연히 “유료라서 무섭다”가 아니라 “월 50건이면 0원”이 되니까요.
교훈은 이겁니다. 비용이 무섭게 느껴지는 건 대부분 실제 사용량을 모르기 때문입니다. 내 업무의 진짜 숫자를 알고 있으면 계산이 됩니다.
6. 요금표는 나중에 다시 확인해야 한다
다만 여기서 멈추지 않고 하나를 더 적어뒀습니다. 이 판단의 근거가 가입 화면에 뜬 안내문이었지 공식 요금 문서가 아니었다는 점이에요.
이게 중요한 이유가 있습니다. Google 지도 요금은 실제로 바뀐 전례가 있어요. 예전에 있던 매달 200달러 무료 크레딧이 2025년 3월에 없어지고 기능별 무료 건수로 바뀌었습니다.
그래서 요구사항정의서에 다시 확인할 시점 세 개를 적어뒀습니다.
언제 | 왜 |
|---|---|
고객 시연 전 | 실제로 쓰기 시작하기 전에 현재 요금이 맞는지 |
개발자 인수인계 시 | 넘겨받는 쪽이 비용을 알고 시작해야 함 |
사용량이 예상보다 늘 때 | 과거 데이터 이관처럼 호출이 몰리는 작업이 생기면 |
7. 한도를 걸려고 했는데 막혀 있었다
비용이 폭주하지 않게 사용량 한도를 걸려고 했습니다. Google Console의 Quotas 화면에 들어가 봤어요.
그런데 걸 수가 없었습니다.
항목 | 값 | 조정 가능 |
|---|---|---|
Elements per day | 무제한 | 불가 |
Elements per minute | 60,000 | 불가 |
Elements per minute per user | 무제한 | 불가 |
공식 문서에도 “요청 횟수에 하루 최대 한도는 없고 분당 쿼리 수만 제한된다”고 되어 있어서, 화면과 문서가 일치했습니다.
그래서 막는 대신 애초에 새지 않게 하는 쪽으로 방향을 바꿨습니다.
장치 | 하는 일 | 상태 |
|---|---|---|
키를 서버에만 보관 | 브라우저에서 키를 꺼낼 수 없게 | 완료 |
API 제한 | 키가 새도 거리 계산 외에는 못 쓰게 | 완료 |
예산 알림 | 막지는 못하나 이상을 빨리 알아챔 | 배포 전 예정 |
앞의 두 개가 진짜 방어선입니다. 키가 안 새면 한도가 무제한이어도 남이 못 씁니다.
8. 예산 알림과 사용량 한도는 다른 것
여기서 헷갈리기 쉬운 걸 하나 배웠습니다.
하는 일 | |
|---|---|
예산 알림 (Budget alert) | 얼마 썼는지 알려주기만 함. 안 막음 |
사용량 한도 (Quota limit) | 한도에 닿으면 API가 응답을 멈춤. 막음 |
이름 때문에 예산 알림이 막아줄 것 같은데, 알리기만 하고 막지 않습니다. 이걸 모르고 예산 알림만 걸어두면 안심하고 있다가 요금이 나올 수 있어요.
9. 안 만들기로 한 것도 문서에 남기기
만들다 보니 낭비가 하나 보였습니다. 사용자가 주소 후보를 고르다 마음을 바꿔 앞서 골랐던 주소로 되돌아가면, 똑같은 질문을 Google에 다시 보냅니다.
사용자 행동 | 호출 |
|---|---|
후보 A 선택 | 1회 |
후보 B로 변경 | 1회 |
다시 후보 A로 복귀 | 1회 (앞과 같은 질문) |
받아둔 답을 기억해뒀다 재사용하면 막을 수 있습니다. 주소 검색 쪽에는 이미 그렇게 되어 있고요.
그런데 지금은 안 붙이기로 했습니다.
이유는 두 가지입니다. 하나, 월 50건인데 세 번씩 고쳐도 월 150건이라 무료 구간에 한참 못 미칩니다. 둘, 코드가 하나 늘면 나중에 확인할 것도 하나 늘어납니다.
대신 언제 붙이면 되는지 조건을 요구사항정의서에 적었습니다.
조건 | 왜 그때인가 |
|---|---|
건수가 지금의 몇 배로 늘 때 | 무료 구간에 가까워지면 호출 하나가 비용이 됨 |
과거 데이터를 한 번에 옮길 때 | 짧은 시간에 호출이 몰리고 같은 주소가 반복됨 |
거리 표시가 느리다는 말이 나올 때 | 재사용하면 두 번째부터 기다림이 없음 |
이렇게 해두면 개발자가 나중에 판단할 수 있습니다. 제가 지금 결정할 필요가 없어요.
🛠 사용한 도구
도구 | 역할 |
|---|---|
Photon API | 주소 검색 (무료, 호출 많음) |
Google Distance Matrix API | 거리 계산 (유료, 호출 적음) |
Google Cloud Console | 무료 한도와 사용량 한도 확인 |
Claude Code | 구조 설계, 공식 문서 확인, 문서 반영 |
2025년 실적 데이터 | 599건이라는 판단 근거 |
배운 점
💡 핵심 교훈
1. 같은 종류의 기능이라도 호출 횟수가 다르면 다른 서비스를 씁니다
주소 검색과 거리 계산은 둘 다 지도 기능이지만, 하나는 타이핑마다 불리고 하나는 한 번만 불립니다. 이 차이가 열 배 이상의 비용 차이를 만들어요. 기능 이름이 비슷하다고 같은 서비스로 묶을 이유가 없습니다.
2. 정확도가 필요한 자리와 아닌 자리를 구분합니다
거리는 수당 타입을 가르는 값이라 틀리면 돈이 잘못 나갑니다. 반면 주소 검색은 사람이 눈으로 확인하니 조금 부정확해도 됩니다. 사람이 걸러주는 자리는 저렴하게 가도 됩니다.
3. 비용이 무서운 건 대부분 실제 숫자를 몰라서입니다
“유료 API라 무섭다”에서 “월 50건이면 0원”으로 바뀌는 데는 실제 건수 하나면 충분했습니다. 내 업무의 진짜 숫자를 아는 게 중요합니다.
4. 예산 알림은 막아주지 않습니다
이름 때문에 차단 기능으로 오해하기 쉬운데, 알리기만 합니다. 진짜로 막는 건 사용량 한도인데, 그마저 걸 수 없는 API도 있습니다. 그럴 땐 애초에 키가 안 새게 하는 쪽이 유일한 방어선입니다.
📚 오늘 배운 용어
용어 | 쉬운 설명 |
|---|---|
Elements | 지도 API의 호출 단위. 출발지 하나에 도착지 하나면 1 element |
예산 알림 (Budget alert) | 돈을 얼마 썼는지 알려주는 기능. 막지는 않음 |
사용량 한도 (Quota limit) | 정해진 횟수를 넘으면 API가 응답을 멈추는 기능. 진짜로 막음 |
무료 구간 | 이 횟수까지는 돈을 안 받는 범위 |
적용할 점
🎯 결과
항목 | 판단 |
|---|---|
주소 검색 | Photon (무료 유지) |
거리 계산 | Google (유료, 무료 구간 안) |
예상 월 비용 | 0원 |
무료 한도 대비 사용량 | 0.5% |
📋 복붙 가능한 프롬프트
유료 API를 붙이기 전에 던지면 좋은 질문입니다.
[서비스명] API를 붙이려는데, 비용부터 확인하고 싶어.
[내 사용량]
- 연간 처리 건수: OOO건
- 한 건당 API 호출 횟수: 몇 번인지 확인해줘
[확인해줄 것]
1. 최신 공식 요금 문서를 찾아서 무료 구간이 얼마인지
2. 내 사용량이면 월 얼마 나오는지 표로
3. 사용량 한도를 걸 수 있는지, 걸 수 있으면 어디서
4. 예산 알림과 사용량 한도의 차이
바로 코드 짜지 말고, 숫자부터 보여줘.기능이 여러 개일 때 나눠 붙일지 판단하는 질문입니다.
이 기능들을 전부 유료 API로 해야 할까, 나눌 수 있을까?
각 기능마다 아래를 정리해줘.
- 한 건 처리할 때 몇 번 불리는지
- 정확도가 얼마나 필요한지 (틀리면 무슨 일이 생기는지)
- 사람이 눈으로 확인하는 단계가 있는지
호출이 많고 사람이 걸러주는 자리는 무료로 가고 싶어.📋 유료 API 붙일 때 체크리스트
내 실제 연간 처리 건수를 아는가
한 건당 API가 몇 번 불리는지 세어봤는가
호출이 많은 기능과 적은 기능을 나눴는가
정확도가 돈으로 이어지는 자리를 구분했는가
공식 요금 문서로 무료 구간을 확인했는가 (가입 화면 안내문 말고)
사용량 한도를 걸 수 있는지 확인했는가
못 걸면 키가 새지 않게 하는 장치를 걸었는가
예산 알림은 막아주지 않는다는 걸 아는가
솔직한 소감
제일 도움이 된 건 기존 데이터 통계였습니다. 기존에 데이터가 있다면, 그걸 통계 내어 합산 건수가 얼마인지를 알면 API 비용 설계에도 도움이 됩니다.




API 비용 중요하죠. 비용 설계를 위해서 여러모로 비교해 보고 판단에 근거가 될 수 있게 내용을 잘 정리하신 부분이 인상깊네요^^ 그리고 구글api가 한도 지정이 안 되는 부분이 있어서 api가 노출되지 않도록 보안에 신경 쓰신 것도 정말 잘하신 거 같아요^^