API

안을 몰라도 쓸 수 있어요

어떤 서비스든 안쪽에는 복잡한 것이 잔뜩 들어 있어요. 자료를 어디에 어떻게 쌓아 두었는지, 어떤 순서로 계산하는지 같은 것들이에요. API는 이 복잡한 안쪽을 가려 두고 바깥에서 쓸 창구만 남겨 놓은 거예요.

이렇게 가려 두면 양쪽 다 편해요. 쓰는 쪽은 안을 배울 필요가 없고, 만드는 쪽은 창구 형식만 지키면 안쪽을 마음대로 고칠 수 있어요. 콘센트 규격을 그대로 두면 발전 방식이 바뀌어도 집 안 가전을 바꾸지 않아도 되는 것과 같아요.

사람이 화면을 눌러 쓰는 자리와도 달라요. 화면은 사람이 보라고 만든 것이고, API는 프로그램이 부르라고 만든 것이에요. 그래서 API에는 버튼도 그림도 없고 형식만 있어요.

무엇을 보내고 무엇을 받는지 정해져 있어요

창구에는 주소가 있어요. 어디로 부탁을 보내야 하는지 정해져 있고, 주소마다 하는 일이 달라요. 글을 만들어 달라는 주소와 소리를 글로 옮겨 달라는 주소가 따로 있는 식이에요.

보낼 것도 정해져 있어요. 무엇을 반드시 넣어야 하고 무엇은 빼도 되는지가 문서에 적혀 있어요. 돌아오는 답의 모양도 마찬가지예요. 어디에 결과가 담기고 어디에 부가 정보가 담기는지 미리 알 수 있어요.

이 약속이 있어서 처음 보는 서비스도 문서만 읽으면 이어 붙일 수 있어요. 약속된 형식이 곧 두 프로그램 사이의 공통 언어예요.

AI를 API로 쓴다는 것

AI를 화면에서 쓰는 것과 API로 쓰는 것은 결이 달라요. 화면에서는 사람이 하나씩 물어보지만, API로는 프로그램이 자동으로 수천 번도 물어볼 수 있어요. 쌓인 문의 글을 한꺼번에 나눠 담거나, 매일 아침 새 자료를 줄여 두는 일이 이렇게 만들어져요.

주고받는 형식이 정해져 있으니 다른 서비스로 갈아타기도 비교적 쉬워요. 창구 주소와 몇 가지 이름만 바꾸면 되는 경우가 많아요. 이 성질 덕분에 여러 AI를 나란히 놓고 견줘 보거나, 상황에 따라 다른 쪽을 부르는 일도 할 수 있어요.

대신 안전장치는 부르는 쪽이 챙겨야 해요. 화면 앞에서는 하기 어려운 실수를 프로그램은 아주 빠르게 아주 많이 저지를 수 있으니까요.

한도가 있고, 규격은 바뀌어요

콘센트 하나에 너무 많은 것을 물리면 차단기가 내려가요. API에도 같은 한도가 있어요. 정해진 시간 안에 부를 수 있는 횟수가 정해져 있고, 넘기면 잠시 거절당해요. 한 곳이 몰아 쓰면 다른 곳이 못 쓰게 되니까요.

규격이 바뀌는 일도 있어요. 창구 쪽이 형식을 고치면 예전 형식으로 보내던 프로그램은 어느 날 갑자기 멈춰요. 그래서 API에는 대개 판을 구분하는 번호가 붙고, 옛 판을 한동안 함께 열어 두어요. 언젠가 바뀐다는 전제로 만들어 두는 편이 좋아요.