요즘 ChatGPT나 Claude, 제미나이 같은 AI 관련 영상을 보다 보면 API라는 말을 자주 듣게 됩니다.
“CahtGPT API를 이용하면 됩니다”, “API 키를 발급받아 연결하면 됩니다”
이런 설명을 듣고 API가 무엇인지 검색해 보면 이번에는 ‘애플리케이션 프로그래밍 인터페이스(Application Programming Interface)’라는 더 어려운 말이 나옵니다.
저도 AI를 이용한 타로 사이트를 한번 만들어보고 싶어서 API에 대해 알아봤는데요. 처음에는 API를 설명하는 말부터 어렵게 느껴지더라고요
그래서 이번 글에서는 개발을 잘 모르는 분들도 이해할 수 있도록 어려운 용어는 최대한 빼고 API가 무엇인지 AI API는 어디에 사용하는자 쉽게 설명해보겠습니다.
AI API란 무엇일까 쉽게 설명하면
먼저 어려운 정의부터 외울 필요는 없습니다.
API란 쉽게 말해 프로그램끼리 필요한 것을 요청하고 결과를 주고받는 방법입니다.
AI API도 마찬가지입니다.
내가 만든 프로그램에서 AI에게 질문을 보내고, AI가 만든 답변을 다시 받아 사용할 수 있다고 생각하면 이해하기 쉽습니다. 그런데 이것만으로는 아직 조금 애매할 수 있습니다.
제가 만들어보고 싶은 AI 타로 사이트를 예로 들어보겠습니다.
AI 타로 사이트를 만든다고 생각해 볼까요?
우리가 ChatGPT를 사용할 때는 직접 질문을 입력합니다.
예를 들어 타로 카드를 한 장 뽑은 다음 ChatGPT에 “이 타로 카드가 나왔는데 어떤 의미인지 알려줘.” 라고 질문할 수 있습니다.
그러면 ChatGPT가 카드의 의미를 설명해 줍니다.
그런데 타로 사이트를 하나 만들어서 사용자가 사이트에서 카드를 선택하는 것만으로 AI가 자동으로 해석해 주게 만들고 싶다면 어떻게 해야 할까요?
사용자가 카드를 선택할 때마다 ChatGPT를 직접 실행해서 질문할 수는 없습니다.
대신 프로그램이 AI에게 질문하도록 만들 수 있습니다. 사용자가 타로 카드를 선택하면 내 사이트가 AI에게
“사용자가 이 카드를 선택했어. 카드의 의미를 쉽게 설명해 줘.”
라고 요청합니다.
AI가 답변을 만들어 보내주면 내 사이트는 그 내용을 받아 사용자 화면에 보여줍니다.
이렇게 내 사이트와 AI가 서로 요청과 답변을 주고받을 때 API를 이용할 수 있습니다.
사용자 → 타로 카드 선택 → 내 타로 사이트 → AI에게 해석 요청 → AI 답변 → 결과 보여주기
API를 식당에 비유하면 더 쉽게 이해할 수 있습니다
아직 어렵다면 식당을 한번 생각해 보겠습니다.
우리가 식당에 가서 음식을 먹을 때 직접 주방에 들어가 요리를 만들지는 않습니다.
먹고 싶은 음식을 주문하면 주문 내용이 주방으로 전달되고, 음식이 완성되면 다시 손님에게 전달됩니다.
API도 비슷한 방식으로 생각할 수 있습니다.
내 프로그램에서 필요한 것을 요청하면 상대 서비스가 요청을 처리한 다음 결과를 보내줍니다.
여기서 중요한 것은 내 프로그램이 상대방의 내부 구조를 모두 알 필요는 없다는 것입니다.
AI가 어떤 방식으로 만들어졌는지 몰라도 정해진 방법으로 요청하고 결과를 받아 사용할 수 있습니다.
식당 비유는 API 자체를 정확하게 표현하기 위한 것이라기보다, 요청하고 결과를 받는 흐름을 쉽게 이해하기 위한 예라고 생각하면 됩니다.
ChatGPT와 AI API는 무엇이 다를까?
여기까지 읽으면 이런 궁금증이 생길 수 있습니다.
“그냥 ChatGPT에서 질문하면 되는데 굳이 API를 왜 사용하는 거지?”
가장 쉽게 구분하는 방법은 누가 AI에게 질문하느냐입니다.
ChatGPT에서는 사람이 직접 질문합니다.
반면 API를 이용하면 내가 만든 프로그램이 AI에게 자동으로 질문하고 답변을 받아올 수 있습니다.
앞에서 설명한 타로 사이트를 다시 생각해 보겠습니다.
사용자가 직접 ChatGPT를 실행해서
“제가 뽑은 카드가 이것인데 해석해 주세요”
라고 입력할 필요가 없습니다.
사이트에서 카드를 선택하고 ‘결과 보기’ 버튼만 누르면 됩니다.
그 뒤에 이루어지는 질문과 답변은 프로그램이 대신 처리하도록 만들 수 있습니다.
이것이 AI API를 사용하는 이유를 이해하는 가장 쉬운 예 중 하나입니다.
API를 이용하면 어떤 것을 만들 수 있을까?
타로 사이트만 가능한 것은 아닙니다.
예를 들어 영어 공부 사이트를 만든다면 사용자가 입력한 영어 문장을 AI가 쉽게 설명하도록 만들 수 있습니다.
여행 사이트에서는 사용자가 입력한 지역과 여행 기간을 바탕으로 AI가 여행 일정을 만들어 주도록 할 수도 있습니다.
긴 문서를 입력하면 중요한 내용만 요약해 주는 서비스도 만들 수 있고, 사용자의 질문에 자동으로 답하는 AI 챗봇도 만들 수 있습니다.
즉, 우리가 ChatGPT에서 직접 하던 일을 내가 만든 프로그램 안에서 자동으로 처리하도록 만들 수 있는 것입니다.
API Key는 무엇일까?
AI API에 대해 알아보다 보면 API Key라는 말도 거의 반드시 만나게 됩니다.
이것도 처음에는 어렵게 생각할 필요가 없습니다.
API Key는 AI 서비스를 사용할 수 있도록 발급받는 ‘비밀 열쇠’라고 생각하면 이해하기 쉽습니다.
AI 서비스를 운영하는 회사 입장에서는 아무 프로그램이나 마음대로 서비스를 이용하게 할 수 없습니다.
누가 서비스를 이용하고 있는지 구분해야 하고 얼마나 사용했는지도 확인해야 합니다.
그래서 API를 사용할 수 있도록 각각의 사용자에게 API Key를 발급합니다.
API Key는 다른 사람에게 공개하면 안 됩니다.
API Key가 다른 사람에게 노출되면 내 키를 이용해 API를 사용하는 문제가 발생할 수 있습니다.
따라서 블로그나 유튜브에서 API 사용 방법을 설명할 때도 실제 API Key가 화면에 노출되지 않도록 주의해야 합니다.
AI API를 사용하면 돈이 들까?
이 부분도 API를 처음 접하면 많이 궁금합니다.
AI API는 서비스에 따라 다르지만 사용량에 따라 비용이 발생하는 경우가 많습니다.
예를 들어 내가 만든 AI 타로 사이트에 하루 10명이 들어오는 것과 하루 1만 명이 들어오는 것은 AI를 사용하는 횟수가 다릅니다.
사용자가 많아지고 AI에게 보내는 내용과 AI가 만들어내는 답변이 많아질수록 비용도 달라질 수 있습니다.
여기서 주의할 부분이 하나 더 있습니다.
ChatGPT 유료 구독과 API 사용 요금은 별도로 생각해야 합니다.
ChatGPT를 유료로 이용하고 있다고 해서 내가 만든 프로그램에서 AI API를 무제한으로 사용할 수 있다는 의미는 아닙니다.
API는 사용하는 서비스와 모델, 사용량 등에 따라 별도의 비용이 발생할 수 있기 때문에 실제 서비스를 만들기 전에는 요금 구조를 확인하는 것이 좋습니다.
API 비용과 토큰에 대해서는 처음부터 함께 설명하면 내용이 복잡해질 수 있으므로 다음 글에서 따로 알아보겠습니다.
API, 이것만 기억해도 됩니다
API에 대해 처음 알아보면서 어려운 용어를 모두 이해할 필요는 없습니다.
우선 아래 내용만 기억해도 충분합니다.
API는 프로그램끼리 필요한 것을 요청하고 결과를 주고받을 수 있게 해주는 방법입니다.
그리고 AI API는
내가 만든 프로그램이 AI에게 질문하고 AI의 답변을 받아 사용할 수 있게 해주는 방법
이라고 생각하면 이해하기 쉽습니다.
처음에는 API라는 단어가 개발자만 사용하는 어려운 기술처럼 보이지만 개념을 이해하고 나면 우리가 사용하는 여러 서비스가 조금 다르게 보이기 시작합니다.
저도 이번에 설명한 AI 타로 사이트를 실제로 한번 만들어보고 싶습니다.
사용자가 카드를 선택하고 AI가 그 카드의 의미를 해석해 주는 간단한 형태부터 시작하면 재미있는 프로젝트가 될 것 같습니다.
하지만 실제로 서비스를 만들려면 API Key는 어떻게 발급받는지, 비용은 얼마나 발생하는지, API Key가 노출되지 않도록 어떻게 관리해야 하는지 등을 알아야 합니다.
다음 글에서는 AI API를 실제로 사용하기 전에 알아야 할 API Key와 비용에 대해 조금 더 자세히 알아보겠습니다.