[AI입문]API가 뭔가 — 대화창 밖에서 AI 쓰기 (입문)

이 글은 AI 입문 연재 3단계의 세 번째 글이다. API라는 말은 여기저기서 보이는데 설명은 대부분 개발자를 상대로 쓰여 있다. 이 글은 개발 지식 없이 개념만 잡는 것이 목표다. 다 읽고 나서 "나는 아직 필요 없구나"라는 결론이 나와도 괜찮다. 그 판단을 내릴 수 있게 되는 것이 이 글의 목적이다.

API가 무엇인가

가게에 비유하면 이렇다. 지금까지 우리는 창구에 직접 가서 주문했다. 화면에 질문을 적고 답을 읽는 방식, 즉 대화창이다. API는 전화 주문 회선에 가깝다. 사람 대신 프로그램이 전화를 걸고, 정해진 형식으로 주문을 넣고, 받은 답을 다른 곳으로 넘긴다.

정리하면 API는 프로그램이 다른 프로그램에 요청을 보내는 통로다. AI의 API는 내 프로그램이 AI에게 말을 거는 길이다. 답하는 쪽은 같다. 말을 거는 쪽이 사람이냐 프로그램이냐가 다를 뿐이다.

대화창과 API의 차이

왜 API가 필요해지나

대화창이 불편해지는 순간이 있다. 대체로 셋 중 하나다.

  • 반복이 많다. 같은 형식의 요청을 하루에 수십 번 붙여넣고 있다면 사람이 할 일이 아니다.
  • 연결이 필요하다. 답을 읽는 데서 끝나지 않고 스프레드시트나 사내 시스템, 앱 화면으로 바로 넘겨야 한다.
  • 사람이 없어도 돌아야 한다. 매일 아침 정해진 시간에 알아서 처리돼 있어야 한다.
이럴 때 API를 떠올린다

반대로 하루에 몇 번 물어보는 정도라면 대화창이 낫다. 오히려 더 편하다. 답이 마음에 안 들면 바로 되물을 수 있고, 파일도 끌어다 놓으면 그만이다. API는 그 편의를 버리고 반복과 연결을 얻는 선택이다.

요금이 매겨지는 방식이 다르다

구독은 정액이다. 한 달 얼마를 내고 정해진 범위 안에서 쓴다. API는 쓴 만큼 낸다. 켜 두기만 하고 안 쓰면 나가는 돈이 거의 없고, 많이 쓰면 그만큼 늘어난다.

세는 단위는 39편 용어 사전에서 봤던 토큰이다. 글자를 잘게 쪼갠 조각이라고 생각하면 된다. 중요한 건 두 가지다. 첫째, 보낸 글과 받은 글을 모두 센다. 긴 자료를 붙여 보내면 답이 짧아도 그만큼 값이 붙는다. 둘째, 대화가 이어질수록 앞의 내용을 매번 다시 보낸다. 프로그램은 기억을 갖고 있지 않아서 지금까지의 대화를 통째로 다시 실어 보내기 때문이다. 그래서 대화가 길어질수록 한 번의 요청이 무거워진다.

구체적인 단가는 여기에 적지 않는다. 자주 바뀌기도 하고, 모델마다 다르기 때문이다. 각 서비스의 요금 페이지에서 직접 확인하는 편이 정확하다. 대신 구조만 기억해 두면 된다. 보낼 내용을 줄이면 값이 준다.

키 관리 기본

API를 쓰려면 키를 발급받는다. 키는 긴 문자열인데, 성격은 비밀번호에 가깝다. 이걸 가진 사람은 내 계정으로 요청을 보낼 수 있고, 그 요금은 내게 청구된다. 지킬 것은 몇 가지뿐이다.

  • 코드나 문서 안에 직접 적어 두지 않는다. 파일이 공유되는 순간 그대로 노출된다.
  • 화면을 캡처해서 올리거나 질문 글에 붙여넣지 않는다. 가리는 걸 잊기 쉽다.
  • 용도별로 따로 발급하고 안 쓰는 키는 지운다. 문제가 생겼을 때 어디서 새는지 찾기 쉽다.
  • 사용량 알림과 상한을 걸어 둔다. 실수로 반복 요청이 돌아가는 사고를 여기서 막는다.
  • 유출이 의심되면 고민하지 말고 폐기하고 새로 만든다.

시작해 볼 만한 경로

경로어떤 사람에게
웹 콘솔 둘러보기일단 어떻게 생겼는지만 보고 싶은 사람
스프레드시트에서 부르기48편처럼 시트 작업이 많은 사람
자동화 서비스에 키 등록코드 없이 흐름만 연결하고 싶은 사람

대부분의 AI 회사는 웹 콘솔을 제공한다. 가입하면 브라우저 안에서 요청을 보내 보고 결과를 확인하는 시험 화면이 있는 경우가 많다. 코드를 쓰지 않고도 감을 잡기에 좋다.

결제 수단을 등록하기 전에 무료로 써 볼 수 있는 범위가 있는지 먼저 확인한다. 등록했다면 곧바로 상한부터 걸어 둔다. 순서를 바꾸지 않는 것이 좋다.

아직 안 해도 되는 이유

API는 도구라기보다 배관에 가깝다. 물을 어디로 보낼지가 정해지지 않았는데 배관부터 깔 이유는 없다. 대화창으로 충분한 사람이 훨씬 많고, 그건 뒤처진 게 아니다.

필요해지는 순간은 대개 스스로 알아차리게 된다. 같은 일을 반복하다가 "이거 자동으로 안 되나"라는 생각이 드는 때다. 그때 이 글로 돌아오면 된다.

정리

API는 프로그램이 AI에게 말을 거는 통로다. 반복, 연결, 무인 처리 이 셋 중 하나가 필요할 때 값을 한다. 요금은 쓴 만큼 붙고 보낸 글까지 센다. 키는 비밀번호처럼 다룬다. 여기까지가 입문에 필요한 전부다.

다음 편은 연재의 마지막 글이다. 지금까지 배운 것을 정리하고 관심사별로 어디로 가면 좋을지를 안내한다.

· · · 연재 순서 · · ·

(이전) 코딩 몰라도 하는 자동화 — 반복 업무를 줄이는 법

(다음) AI 학습 로드맵 — 여기서 어디로 갈까

※ 이 글의 설명은 2026년 8월 기준이며 서비스 정책은 자주 변경됩니다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

[AI입문]AI 용어 사전 — 토큰, 컨텍스트, 환각... 뜻만 알면 절반은 끝난다

이미지
이 글은 새로 시작하는 AI 입문 연재의 첫 번째 글이다. 이 연재는 AI를 한 번도 써 본 적 없는 사람을 위해 쓴다. 그런데 첫 관문은 기술이 아니라 말이다. 토큰, 컨텍스트, 환각 같은 단어가 설명 없이 튀어나오는 순간부터 글이 읽히지 않는다. 그래서 첫 글에서는 앞으로 계속 나올 용어를 하나씩 짚는다. 용어마다 일상 비유 하나와, 그 말을 알면 무엇이 달라지는지를 붙였다. 외울 필요는 없다. 읽고 나서 "아, 그게 그 말이었구나" 정도만 남아도 충분하다. 대화를 이루는 기본 용어 LLM과 생성형 AI LLM 은 '거대 언어 모델'의 줄임말이다. 어마어마한 양의 글을 읽고 말의 패턴을 익힌 프로그램이라고 보면 된다. 생성형 AI 는 그보다 넓은 말로, 없던 결과물을 새로 만들어 내는 AI 전체를 가리킨다. 글을 만들면 언어 모델, 그림을 만들면 이미지 생성 AI다. 왜 중요한가. 흔히 말하는 'AI 챗봇'은 대부분 LLM, 즉 글을 다루는 데 특화된 도구다. 계산기나 검색 엔진과는 잘하는 일이 애초에 다르다는 뜻이다. 토큰 AI는 글을 글자 단위로 세지 않는다. 토큰 이라는 조각 단위로 센다. 한글은 한 글자가 대략 한 토큰 정도라고 생각하면 크게 어긋나지 않는다. 택배 요금을 무게로 매기듯, AI는 처리량을 토큰으로 잰다. 왜 중요한가. 무료 사용 한도, 유료 요금, 한 번에 넣을 수 있는 문서 분량이 모두 토큰으로 계산된다. "길게 쓰면 비싸진다"는 말의 근거가 여기에 있다. 컨텍스트 윈도우 AI가 한 번에 펼쳐 놓고 볼 수 있는 분량이다. 책상 넓이에 비유할 수 있다. 책상이 넓으면 자료를 여러 개 올려놓고 볼 수 있지만, 좁으면 새 자료를 놓을 때 먼저 있던 것을 치워야 한다. 대화가 길어지면 앞부분이 이 책상에서 밀려난다. 왜 중요한가. 오래 이어 간 대화에서 AI가 갑자기 앞 내용을 잊는 것은 고장이 아니다. 구조상 당연한 일이다. 주제가 바뀌면 새 대화를 여...
자세한 내용 보기

메일 주소 하나 만들려다 브랜드를 세웠다 — 1인 스튜디오 브랜딩 실전기

이미지
메일 주소 하나 만들려다, 브랜드를 통째로 세웠다 1인 스튜디오 브랜딩 실전기 — 도메인 · 메일 · 로고 · 상표 출원까지 직접 해본 기록 시작은 단순했다. " 내이름@내스튜디오.com 같은 전문적인 메일 주소 하나 갖고 싶다." 딱 그거였다. 그런데 그 한 가지 바람이 도메인 선정, 브랜드 네이밍, 상표 검색, 로고 제작, 메일 서버 인증, 상표 출원까지 줄줄이 이어졌다. 결국 1인 개발/콘텐츠 스튜디오 ‘에이븐스튜디오(Aeven Studio)’ 의 기반을 통째로 세우게 됐다. 같은 길을 걸을 다른 1인 창작자들을 위해, 부딪힌 함정과 배운 것을 정리한다. 1. 자체 메일 서버? 결론은 ‘관리형’ 처음엔 멋있어 보여서 메일 서버를 직접 굴려볼까 했다. 알아보니 개인이 자체 발송 서버를 운영하는 건 생각보다 가시밭길이다. 가정용 IP는 대부분 스팸 차단 목록에 기본 등록돼 있어 받는 쪽이 거부한다. 발송 포트(25번)가 막혀 있고, 역방향 DNS(PTR)를 내 맘대로 못 건다. AWS EC2조차 25번 포트가 기본 차단이고 IP 평판이 좋지 않다. 결론: 비즈니스 메일이라면 Google Workspace · Zoho · 네이버웍스 같은 관리형 서비스 가 정답이다. 서버·보안·스팸·도달률이라는 골치 아픈 문제를 통째로 넘길 수 있다. 나는 익숙함과 생태계 통합 때문에 Google Workspace로 정했다. 2. 이름 짓기 — 가장 오래 헤맨 구간 여기서 제일 많이 배웠다. 좋은 이름을 정하는 건 ‘감각’의 문제가 아니라 세 개의 관문을 동시에 통과 시키는 문제였다. 이름 하나가 통과해야 할 세 관문 후보 이름 "이거 어때?" 관문 ① 상표 KIPRIS 검색 내 사업류에 살아있는 유사 상표 없어야 'AI' 등 설명적 단어는 식별력 없음 관문 ② 도메인 진짜 병목 구간 어감 좋은 단어는 .com이 이미 선점됨 해법: .kr/.app 수용 또는 조어(coined word) 관...
자세한 내용 보기

클로드 Fable 5와 Opus 4.8 비교 - 차이점, 가격, 무료 기간 종료 후 변화까지 총정리 (7월 최신)

이미지
2026년 6월 9일, Anthropic이 5세대 모델 가족의 첫 주자인 Claude Fable 5 를 공개했다. 기존 최상위 모델이던 Opus 4.8과 무엇이 다른지, 구독 플랜에서는 어떻게 제공되는지, 그리고 출시 직후 벌어진 접근 중단 사태까지, 실제 사용 과정에서 확인한 내용을 정리한다. 새 모델을 써볼지 고민 중이거나 갑자기 모델 접근 오류를 만난 사람에게 도움이 될 것이다. Fable 5란 어떤 모델인가 Fable 5는 Anthropic의 모델 계층에서 가장 위에 있는 Mythos급(Mythos-class) 모델이다. 기존 계층이 Haiku → Sonnet → Opus 순서였다면, 이제 그 위에 Mythos 등급이 추가된 셈이다. 배경을 보면 Anthropic은 같은 해 4월에 Mythos를 먼저 공개했지만, 고급 사이버보안 능력 때문에 일부 승인된 고객에게만 제한적으로 배포했다. Fable 5는 그 Mythos 기술에 안전장치를 더해 일반 사용자도 쓸 수 있게 만든 버전이다. 함께 발표된 Claude Mythos 5는 여전히 일반 출시되지 않았으며, 두 모델은 본질적으로 같은 기반 모델이다. Fable 5 vs Opus 4.8 - 핵심은 용도의 차이 두 모델의 가장 중요한 차이는 성능 수치가 아니라 용도 다. Fable 5는 모델이 스스로 작업을 분해하고 조사하고 만들고 검증하는 장기 비동기 프로젝트 에 적합하고, Opus 4.8은 복잡한 작업을 사람과 주고받으며 처리하는 빠른 동기적(실시간) 협업 에 적합하다. Fable 5의 강점으로 알려진 내용은 다음과 같다. Claude Code 같은 에이전트 환경에서 며칠 동안 작업을 지속 하며, 단계별로 계획하고 하위 에이전트에 위임하고 자기 작업을 검증한다. 5천만 줄 규모의 Ruby 코드베이스에서, 팀이 수작업으로 2개월 넘게 걸릴 전체 마이그레이션을 하루 만에 수행한 사례가 소개됐다. 파일과 PDF 안에 중첩된 다이어그램·차트·표를 이해하는 비전 능력이 강화되어 금융·법률...
자세한 내용 보기