API

입문

API는 AI 문맥에서 자주 등장하는 개념입니다. 이 페이지는 입문 난이도로 API의 뜻과 쓰임을 빠르게 이해할 수 있도록 정리한 AI 용어사전 항목입니다.

API를 처음 보는 독자도 헷갈리지 않도록 정의와 맥락, 관련 글 3개를 한 페이지에 묶었습니다. 아래 설명을 먼저 읽고, 이어서 연결된 개념과 글까지 보면 이해가 훨씬 빨라집니다.

API는 Application Programming Interface의 약자로, 프로그램과 프로그램이 서로 소통할 때 사용하는 규격화된 방법입니다. 하나의 소프트웨어가 다른 소프트웨어의 기능을 요청하고 그 결과를 받아오기 위해 따라야 하는 규칙과 형식의 집합입니다.

AI 분야에서 API는 특히 중요한 개념입니다. OpenAI API, Anthropic API처럼 AI 기업들은 자사 언어 모델을 API 형태로 공개합니다. 개발자는 GPT-4o나 Claude 같은 대형 모델을 자신의 앱에서 바로 호출할 수 있습니다.

실제 사용 시 알아야 할 핵심 개념은 세 가지입니다. API 키는 사용자를 식별하는 인증 문자열입니다. 요청(Request)과 응답(Response)은 API 통신의 기본 단위입니다. 현대 웹 API의 대부분은 REST 방식을 따르며, HTTP 프로토콜 위에서 JSON 형식으로 데이터를 주고받습니다.

API가 왜 필요한지 이해하려면 소프트웨어 개발의 분업 구조를 생각해야 합니다. 지도 기능이 필요한 앱을 만든다고 가정할 때, 지도 데이터를 직접 수집하고 렌더링 엔진을 만드는 것은 현실적으로 불가능합니다. 하지만 Google Maps API를 사용하면 몇 줄의 코드만으로 지도 기능을 앱에 넣을 수 있습니다. API는 이처럼 복잡한 기능을 간단하게 재사용할 수 있도록 만드는 표준 인터페이스입니다.

AI API의 작동 방식은 일반 웹 API와 같은 원리입니다. 클라이언트(앱 또는 서비스)가 HTTP 요청을 보내면, AI API 서버가 언어 모델을 실행하고 결과를 JSON 형식으로 돌려줍니다. Anthropic API를 예로 들면, 요청에 모델 이름, 메시지, 최대 토큰 수 등을 담고, 응답으로 모델의 텍스트 출력을 받습니다. 이 구조 덕분에 개발자는 모델 내부를 전혀 몰라도 AI 기능을 서비스에 통합할 수 있습니다.

AI API 사용에서 주의해야 할 것은 토큰 기반 과금입니다. 대부분의 AI API는 입력과 출력 토큰 수에 따라 비용이 청구됩니다. 토큰은 대략 영어 단어의 3/4 정도 길이의 텍스트 단위입니다. 많은 요청을 보내거나 긴 컨텍스트를 유지하면 비용이 빠르게 늘어날 수 있습니다. 프로덕션 환경에서는 캐싱, 배치 처리, 적절한 모델 선택으로 비용을 관리하는 것이 중요합니다.

API 보안도 중요한 주제입니다. API 키가 노출되면 제3자가 해당 키로 무제한 요청을 보내 요금 폭탄이 생길 수 있습니다. API 키는 절대 클라이언트 사이드 코드(브라우저에서 실행되는 JavaScript 등)에 노출하면 안 됩니다. 항상 서버 사이드에서만 API 키를 사용하고, 환경 변수로 관리하며, 정기적으로 키를 교체하는 것이 좋은 관행입니다.

API는 공개(Public) API와 비공개(Private) API로 나뉩니다. 공개 API는 외부 개발자가 사용할 수 있도록 문서와 함께 공개된 API입니다. OpenAI API, Anthropic API, Google Maps API가 대표적입니다. 비공개 API는 내부 시스템 간 통신에만 사용하며 외부에 노출하지 않습니다. 기업이 자사 마이크로서비스 간 통신에 쓰는 API가 여기에 해당합니다. 파트너 API는 특정 파트너 기업에만 접근 권한을 주는 중간 형태입니다.

AI API를 처음 사용하는 개발자가 자주 겪는 어려움은 레이트 리밋(Rate Limit)입니다. 레이트 리밋은 단위 시간당 보낼 수 있는 요청 수를 제한하는 것입니다. 무료 티어에서는 분당 요청 수가 매우 적어 프로덕션에 바로 쓰기 어렵습니다. 사용량이 많아지면 유료 티어로 전환하고, 필요하면 API 제공사에 직접 레이트 리밋 상향을 요청할 수 있습니다. 대량 처리가 필요한 경우에는 배치 API를 활용하면 비용과 레이트 리밋 모두 유리합니다.

API 설계 품질은 개발자 경험에 큰 영향을 미칩니다. 좋은 API는 일관된 명명 규칙, 명확한 에러 메시지, 충분한 문서, 코드 예제를 갖추고 있습니다. Anthropic API가 개발자들에게 호평받는 이유 중 하나는 직관적인 설계와 상세한 공식 문서입니다. SDK도 Python, TypeScript, Java 등 주요 언어를 지원하여 API 호출 코드를 직접 작성하지 않아도 됩니다. 결국 좋은 API는 개발자가 핵심 기능 구현에 집중할 수 있게 해주는 도구입니다.

ℹ️쉽게 말하면

API는 식당의 메뉴판과 주문 시스템에 비유할 수 있습니다. 손님(클라이언트)은 주방(서버) 내부를 몰라도 메뉴판(API 명세)에 적힌 방식으로 주문(요청)을 넣으면 완성된 요리(응답)를 받을 수 있습니다.

아래 글들은 API가 실제 문맥에서 어떻게 쓰이는지 보여주는 참고 자료입니다. glossary에서 개념을 잡고 관련 글로 넘어가면 이해가 훨씬 쉬워집니다.

튜토리얼

VS Code에서 Claude Code 시작하기

Windows에서 VS Code를 설치하고, Claude Code 익스텐션을 설정하고, 첫 대화를 시작하는 과정을 단계별로 안내합니다.

가이드

컨텍스트 엔지니어링 완전 가이드 (2026년 3월 기준)

프롬프트 엔지니어링의 시대는 저물고, 컨텍스트 엔지니어링의 시대가 열렸습니다. LLM에 무엇을, 언제, 어떻게 전달할지를 설계하는 컨텍스트 엔지니어링의 핵심 개념부터 실전 패턴까지 2026년 기준으로 정리했습니다.

가이드

AI 자동화 하네스 완전 가이드 — 프롬프팅과 컨텍스트 엔지니어링으로 AI 워크플로우 구축하기 (2026년 3월 기준)

AI 하네스는 단순 프롬프트를 넘어, 프롬프팅·컨텍스트·도구·검증을 하나의 파이프라인으로 묶은 자동화 시스템입니다. Claude Code와 CLAUDE.md를 중심으로 실전 하네스를 직접 설계하고 운영하는 방법을 처음부터 끝까지 정리했습니다.