AI 공식 라이브러리 7개 언어 — 골랐다가 못 쓰는 기능이 있습니다

AI를 코드에 붙일 때 제일 먼저 하는 선택이 "무슨 언어로 짤까"입니다. 다행히 공식 라이브러리가 일곱 언어로 나와 있습니다 — 파이썬, 타입스크립트, C#, 고, 자바, PHP, 루비. 문제는 이름과 겉모습이 비슷해서 "어느 걸 골라도 똑같겠지"라고 믿게 된다는 점입니다. 문서를 나란히 펴 놓고 보면 아닙니다. 어떤 언어에는 있는 편의 기능이 다른 언어엔 없고, 어떤 언어는 아직 판이 바뀌면 규격도 바뀐다고 스스로 적어 놨습니다.

📌 30초 요약

• 일곱 언어 전부 공식입니다. 자동 재시도·시간 제한·목록 자동 넘김·오류 분류는 어디서나 똑같이 됩니다.
• PHP는 아직 베타입니다. 게다가 HTTP 쪽을 잘못 고르면 스트리밍이 오류 없이 통째로 쏟아집니다.
• C#은 그 이름의 주인이 바뀌었습니다. 예전 판대에는 커뮤니티가 만든 다른 물건이 올라가 있었습니다.
• 파이썬에만 도구 자동 반복 도우미가 예제로 실려 있습니다. 대신 감시·테스트 도구가 요청을 못 보는 함정이 있습니다.
• 범용 클라이언트가 아닌 끼워 넣기용 라이브러리도 둘 있는데, 성격이 완전히 다릅니다.

1. 일곱 언어 전부 공식 — 공통으로 되는 것

먼저 좋은 소식입니다. 일곱 개 전부 회사가 직접 만들고 관리하는 물건이고, 기본기는 어느 언어를 골라도 같습니다. 손으로 짜면 귀찮은 것들이 이미 들어 있습니다.

자동 재시도가 기본 두 번 돌고, 사이에 간격을 점점 늘려 잡습니다. 되돌려 주는 대상은 연결이 끊겼을 때, 시간이 다 됐을 때, 충돌이 났을 때, 한도를 넘겼을 때, 서버 쪽이 터졌을 때입니다. 제한 시간은 기본 10분이고 손으로 줄일 수 있습니다. 목록을 부르면 다음 장을 알아서 가져오는 반복이 딸려 오고, 오류는 상황별로 종류가 갈려 있어 "한도 초과일 때만 쉬었다 하기" 같은 처리가 쉽습니다. 문서에 없는 항목을 억지로 보내야 할 때 쓰는 탈출구도 전부 마련돼 있습니다.

언어	색깔	고르기 전 알아둘 것
파이썬	동기·비동기 짝, 검증형 응답 객체	도구 자동 반복 도우미가 여기만 예제로 있음
타입스크립트	서버 런타임 여러 종류 + 브라우저	브라우저에서 쓰면 열쇠 노출에 주의
C#	공통 대화 인터페이스 구현	그 이름의 주인이 바뀌었음
고	맥락으로 취소, 함수형 옵션	그 언어 관습에 맞춰 모양이 다름
자바	빌더 방식, 비동기 결과 객체	비동기 표현이 파이썬과 전혀 다름
PHP	값 객체, 빌더 방식	베타 + 스트리밍 함정
루비	형 표기, 스트리밍 도우미	형 검사 도구를 함께 쓰는 전제

여기에 성격이 다른 물건 두 개가 더 있습니다. 애플 기기 안에서 도는 모델과 같은 방식으로 부르게 해 주는 것, 그리고 타사 라이브러리 모양 그대로 클로드를 쓰게 해 주는 호환 계층입니다. 둘은 범용 클라이언트가 아니라 남의 규격에 끼워 넣는 어댑터라서, 여기 표의 일곱 개와 같은 잣대로 비교하면 안 됩니다. 셸에서 바로 굴리고 싶다면 공식 명령줄 도구가 따로 있고요.

2. PHP는 아직 베타 — 스트리밍이 통째로 쏟아집니다

일곱 개 중 문서가 스스로 "베타"라고 밝힌 건 PHP뿐입니다. 판이 올라가면서 규격이 바뀔 수 있다고 적혀 있고, 주 버전대도 아직 초기 개발 구간에 머물러 있습니다. 실서비스에 넣을 거라면 이 문장을 먼저 읽고 결정해야 합니다.

더 조심할 건 스트리밍입니다. PHP 쪽은 HTTP를 직접 붙이지 않고 이미 깔려 있는 HTTP 클라이언트를 찾아서 쓰는 구조입니다. 유연한 대신 함정이 생깁니다. 응답을 통째로 모아 두는 성격의 클라이언트가 잡히면, 스트리밍을 켜도 한 조각씩 오지 않습니다.

⚠️ 오류가 안 나서 더 헷갈립니다

이 상황에서 프로그램은 정상적으로 돕니다. 반복문도 잘 돌고 조각도 다 옵니다. 다만 응답이 완전히 끝난 뒤에 한꺼번에 옵니다. 즉 화면에 글자가 흘러나오게 만들려던 기능이 "한참 멈춰 있다가 통째로 뜨는" 것으로 바뀝니다. 오류도 경고도 없으니 코드를 아무리 봐도 원인이 안 보입니다. 문서가 권장하는 클라이언트를 깔거나, 스트리밍이 되는 것을 직접 지정해 넘겨야 합니다.

반대로 PHP도 기본기는 멀쩡합니다. 재시도 두 번, 오류 종류 분리, 목록 자동 넘김이 다 있고 문서에 없는 항목을 보내는 길도 열려 있습니다. "기본은 되는데 스트리밍만 환경을 탄다"고 기억해 두면 됩니다.

3. C#은 그 이름의 주인이 바뀌었습니다

이건 좀 특이한 사연입니다. C# 쪽 패키지 이름은 원래 커뮤니티가 만든 비공식 라이브러리가 쓰고 있었습니다. 나중에 회사가 공식 물건을 내면서 그 이름을 이어받았고, 기존 커뮤니티판은 다른 이름으로 옮겨 갔습니다.

그래서 예전에 그 이름으로 개발해 둔 프로젝트를 아무 생각 없이 최신으로 올리면 같은 이름의 전혀 다른 팀이 만든 전혀 다른 물건으로 갈아타는 셈이 됩니다. 함수 이름부터 다르니 빌드가 깨지고, 왜 깨졌는지 감이 안 잡힙니다. 예전 것을 계속 쓰려면 참조하는 이름 자체를 옮겨진 쪽으로 바꿔 잡아야 합니다.

대신 C#에는 다른 언어에 없는 장점이 있습니다. 마이크로소프트 쪽 공통 대화 인터페이스를 구현해 놔서, 그 규격에 맞춰 만들어진 다른 도구들과 그냥 물립니다. 도구 연결 규약 쪽 도구 목록을 받아다 그대로 넘겨 주는 식이죠. 생태계가 이미 그 규격 위에 있다면 이게 결정적입니다.

하나 더. C#은 응답 검사가 기본으로 꺼져 있습니다. 서버가 예상과 다른 모양을 돌려줘도 그 자리에서 터지지 않고, 그 값을 실제로 꺼내 쓰는 순간에야 터집니다. 원인 지점과 터지는 지점이 갈리는 전형적인 상황이죠. 받자마자 확인하게 만드는 스위치가 따로 있으니, 중요한 경로라면 켜 두는 편이 낫습니다.

4. 파이썬만 되는 것, 파이썬만 조심할 것

파이썬 문서가 가장 두껍고, 실제로 편의 기능도 가장 많습니다. 함수에 표시 하나만 달면 도구 설명서를 자동으로 만들어 주고, 모델이 그 도구를 부르면 대신 실행해서 결과를 돌려주는 반복까지 알아서 돌려 줍니다. 도구를 붙이는 코드를 손으로 짜 본 적 있다면 이게 얼마나 큰지 아실 겁니다. 토큰을 보내기 전에 미리 세어 보는 기능, 동기와 비동기가 같은 모양으로 짝을 이루는 구조도 여기 있습니다.

친절한 안전장치도 있습니다. 스트리밍 없이 아주 긴 출력을 요청하면, 라이브러리가 "이건 제한 시간을 넘길 것 같다"고 미리 막아 줍니다. 중간에 연결이 끊겨 영문 모를 실패가 나는 걸 예방하는 장치죠. 스트리밍을 켜거나 시간을 직접 늘리면 이 제동이 풀립니다.

그런데 파이썬에는 다른 언어에 없는 함정이 하나 있습니다. 이 라이브러리가 안에서 쓰는 HTTP 라이브러리가 널리 쓰이던 것의 갈라져 나온 판입니다. 그래서 요청을 들여다보는 도구들 — 추적·모니터링·테스트용 가짜 응답 도구 — 이 이 요청을 기본적으로 못 봅니다. 붙였다고 생각했는데 기록이 안 남고, 테스트에서 가짜 응답이 안 먹습니다. 프로그램 맨 앞에서 별칭을 한 번 걸어 주면 그때부터 보입니다.

어떤 언어를 고르든 열쇠를 코드에 박아 두지 않는 것이 먼저입니다. 무료 한도로 감을 잡고 싶다면 카드 없이 최신 모델을 써 보는 곳들부터 훑고, 실제로 붙이는 감은 열쇠 하나로 챗봇을 만들어 보는 예제로 잡으면 순서가 맞습니다.

5. 자주 묻는 질문 (FAQ)

Q. 결국 어떤 언어를 골라야 하나요?

이미 쓰고 있는 언어가 정답입니다. 일곱 개 다 공식이고 기본기는 같으니, 언어를 바꿔 가며 얻는 이득보다 익숙한 환경에서 얻는 속도가 큽니다. 예외는 둘 — 도구를 여러 개 붙여 자동으로 돌리는 게 목적이면 파이썬 쪽 예제가 가장 앞서 있고, 이미 특정 대화 인터페이스 생태계 위에 있으면 C#이 그대로 물립니다.

Q. 베타라는데 PHP로 실서비스를 해도 되나요?

되긴 하지만 판을 고정해 두고 쓰세요. 문서가 "판이 바뀌면 규격이 달라질 수 있다"고 밝혀 뒀으니, 자동으로 최신을 따라가게 해 두면 어느 날 갑자기 안 됩니다. 올릴 때는 변경 내역을 읽고 올리는 습관이 필요합니다.

Q. C# 패키지를 올렸더니 빌드가 다 깨졌어요.

십중팔구 같은 이름의 다른 물건으로 갈아탄 것입니다. 예전 커뮤니티판을 계속 쓰려면 참조 이름을 옮겨진 쪽으로 바꾸면 되고, 공식으로 넘어갈 생각이면 호출부를 새 모양에 맞춰 고쳐야 합니다. 어느 쪽이든 실수가 아니라 예정된 교체라서 원인을 알면 금방 정리됩니다.

Q. 타사 호환 계층으로 이미 짰는데 옮겨야 하나요?

비교·평가 단계라면 그대로 두세요. 다만 계속 운영할 거라면 옮기는 편이 낫습니다. 호환 계층은 남의 규격에 맞추느라 지원 못 하는 항목이 꽤 있고, 그중 일부는 오류도 없이 무시됩니다. 공식 라이브러리에는 그 제약이 없습니다.

✨ 정리하면

일곱 언어 전부 공식이고 기본기는 똑같습니다. 갈리는 건 셋 — PHP는 베타에 스트리밍이 환경을 타고, C#은 그 이름의 주인이 바뀌었고, 파이썬은 감시 도구가 요청을 못 봅니다. 쓰던 언어를 그대로 쓰되 이 셋만 미리 확인하면 됩니다. AI에 드는 돈이 새는 자리를 순서대로 훑고 싶다면 AI 지출 관리 허브에 단계별로 모아 뒀습니다.

※ 2026년 9월 기준 공식 문서(라이브러리 개요·파이썬·PHP·C# 안내)를 나란히 대조해 정리했습니다. 각 언어마다 최소로 요구하는 실행 환경 판이 정해져 있으니 설치 전 해당 문서를 확인하세요. 베타 표시와 지원 범위는 수시로 바뀝니다.