API

API는 프로그램이 다른 프로그램에게 정해진 방식으로 일을 부탁하고 답을 받는 창구예요. 은행 손님이 금고에 직접 들어가지 않고 창구에 서류를 내면 직원이 결과를 건네주는 것과 같아요.

글 서순명(솔리드그루 이사 · 퓨쳐인프라 운영) · 2026-10-29 작성 · 예시 코드는 2026-10-29 서울 Windows 11 에서 직접 실행

API는 어떻게 주고받나요?

API 호출은 편지 한 통을 보내고 답장을 받는 일이에요. 보내는 쪽 편지에는 보통 네 가지가 들어가요.

주소와 방법을 정하는 규칙은 REST API 글에, 열쇠를 받고 지키는 법은 API 키 글에 따로 정리했어요. 답이 오는 글자 모양은 대부분 JSON이에요.

MDN 문서도 API를 "사람이 쓰는 화면이 아니라 소프트웨어가 쓰는 기능과 규칙"이라고 설명해요(MDN Glossary: API). 창구 안쪽이 어떻게 돌아가는지는 몰라도 돼요. 약속된 서류만 맞게 내면 돼요.

API는 어디에 쓰이나요?

요즘 앱은 기능을 처음부터 다 만들지 않아요. 잘 만든 기능을 API로 빌려 와요.

• 로그인 — "구글로 로그인" 버튼은 구글의 API에 "이 사람 맞아요?"를 묻는 거예요.
• 결제 — 카드 결제 회사의 API에 금액을 보내고 승인 결과를 받아요.
• 지도·날씨 — 주소를 보내면 지도 그림이나 오늘 기온이 와요.
• AI 기능 — 질문을 보내면 AI 모델이 쓴 답이 와요. 챗봇, 요약, 번역 기능이 대부분 이 방식이에요.

바이브코딩으로 앱을 만들 때도 마찬가지예요. "날씨 보여 주는 앱"을 부탁하면 AI는 날씨 서비스의 API를 찾아 붙여요.

API에는 어떤 종류가 있나요?

나누는 기준이 두 가지예요. 누구에게 열려 있는지, 그리고 어디에 있는지예요.

웹 API는 다시 설계 방식으로 나뉘어요. 흔히 쓰는 건 주소와 방법으로 짜는 REST 방식이에요. 원하는 칸만 골라 묻는 GraphQL, 연결을 열어 두고 계속 주고받는 웹소켓도 있어요.

직접 불러 보면 어떻게 나오나요?

2026-10-29 밤 서울의 Windows 11 PC에서 직접 실행한 결과예요. 파이썬 3.12.8 기본 기능만 썼어요. 깃허브가 공개해 둔 API에 "cpython 저장소 정보 주세요"를 세 번 보냈어요.

$ cat call_api.py
import json, time, urllib.request
url = "https://api.github.com/repos/python/cpython"
times = []
for _ in range(3):
    t = time.perf_counter()
    with urllib.request.urlopen(urllib.request.Request(url, headers={"User-Agent": "glossary-test"}), timeout=20) as r:
        status, data = r.status, json.load(r)
    times.append((time.perf_counter() - t) * 1000)
print("상태 코드:", status)
print("받은 값 일부:", {k: data[k] for k in ("full_name", "stargazers_count", "language")})
print("응답 시간(ms, 3번):", [round(x) for x in times], "가운데 값", round(sorted(times)[1]))

$ python call_api.py
상태 코드: 200
받은 값 일부: {'full_name': 'python/cpython', 'stargazers_count': 77760, 'language': 'Python'}
응답 시간(ms, 3번): [506, 17, 16] 가운데 값 17

$ curl -s https://futureinfra.ai/v1/me   (열쇠 없이 부르면)
{"error":"not_authenticated"}  <- HTTP 401

• 200은 "잘 처리했어요"라는 뜻이에요. 답 안에서 저장소 이름, 별 수, 언어만 골라 출력했어요.
• 첫 번째만 506ms로 느렸어요. 처음 한 번은 상대 서버를 찾고 연결을 준비하느라 오래 걸린 것으로 보여요. 두 번째부터는 0.02초도 안 걸렸어요.
• 마지막 줄은 열쇠 없이 퓨쳐인프라 API를 부른 결과예요. 401은 "누구신지 먼저 증명해 주세요"라는 뜻이에요.

AI 모델 API는 뭐가 달라요?

구조는 같아요. 주소로 질문을 보내면 답이 와요. 다른 점은 두 가지예요.

첫째, 돈이 쓴 만큼 나가요. AI API는 보통 주고받은 글자 양(토큰)으로 값을 매겨요. 그래서 키가 새면 남이 내 돈으로 AI를 쓰게 돼요. 둘째, 회사마다 주소와 키가 달라요. 모델 세 개를 쓰려면 가입과 키 관리도 세 번 해야 해요.

그래서 한 번에 여러 모델을 부르는 "라우터"를 많이 써요. 구글 모델을 직접 쓰는 법은 제미나이 API 글에 있어요. AI 에이전트가 도구를 쓰는 연결 방식은 API와 결이 달라서 MCP 글에서 따로 다뤘어요.

자주 하는 오해와 주의할 점

• "API는 프로그램 이름이다" — API는 특정 프로그램이 아니라 창구와 규칙을 부르는 말이에요. 서비스마다 자기 API가 있어요.
• "공개 API는 무제한 공짜다" — 대부분 시간당 호출 횟수에 한도가 있고, 넘치면 429(너무 많이 보냄)가 와요. 유료 API도 많아요.
• "키를 화면 코드에 넣어도 된다" — 브라우저로 내려가는 코드는 누구나 열어 볼 수 있어요. 키는 서버 쪽에서만 써요.
• "답은 늘 같은 모양이다" — 서비스가 API를 바꾸면 답 모양도 바뀌어요. 그래서 주소에 v1·v2 같은 판 번호를 붙이는 서비스가 많아요.

퓨쳐인프라에서는 어떻게 쓰나요?

퓨쳐인프라 REST API의 기본 주소는 https://futureinfra.ai/v1 이에요. 콘솔 화면이 쓰는 것과 같은 API라서, 화면에서 하는 일을 프로그램으로도 할 수 있어요. 프로그램은 "Authorization: Bearer pk_live_…" 모양의 API 키로 자기를 증명해요.

AI 기능을 붙인다면 AI 라우터가 편해요. 300종 넘는 AI 모델을 API 키 하나로 부를 수 있고, OpenAI 호환이라 기존 예제 코드를 거의 그대로 써요. 쓴 만큼 충전 지갑에서 빠져나가요. 클로드 코드에 키 위치만 알려 주면 연결 코드는 AI가 써 줘요.

자주 묻는 질문

API 호출이 뭐예요?

프로그램이 API 주소로 요청을 한 번 보내고 답을 받는 일을 말해요. '하루 1,000번 호출'처럼 횟수로 한도나 요금을 정하는 서비스가 많아요.

오픈 API는 아무나 써도 돼요?

가입하고 키를 받으면 누구나 쓸 수 있게 열어 둔 API예요. 다만 이용 약관과 호출 한도는 지켜야 하고, 상업적으로 쓸 때 조건이 따로 있는 곳도 있어요.

API 연동은 무슨 뜻이에요?

내 앱이 다른 서비스의 API를 불러 쓰도록 이어 붙이는 작업이에요. 예를 들어 쇼핑몰에 결제 회사 API를 연결하면 카드 결제 버튼이 생겨요.

코딩을 몰라도 API를 쓸 수 있어요?

n8n 같은 자동화 도구는 화면에서 주소와 키만 넣으면 API를 불러 줘요. 클로드 코드 같은 AI 코딩 도구에 'OO API로 연결해 줘'라고 부탁해도 돼요.

관련 용어

• REST API — 주소와 GET·POST로 API를 짜는 흔한 방식
• API 키 — API를 부를 때 내미는 신분증
• JSON — API 답이 오는 글자 모양
• MCP — AI 에이전트가 도구를 쓰는 연결 방식
• 제미나이 API — 구글 AI 모델을 API로 부르는 법
• 백엔드 — API를 만들어 내주는 서버 쪽 코드