3줄 요약
- 오픈AI가 9월 10일 Agents API를 퍼블릭 베타로 열었습니다. API 사용료는 0원이고, 내는 돈은 모델 토큰값과 도구값입니다.
- 오픈AI가 호스팅하는 컨테이너를 쓰면 요금이 따로 붙습니다. 4GB 기준 20분에 0.12달러, 한 시간이면 484원 정도입니다. 전체 비용에서 컨테이너 비중은 작고 대부분이 토큰값입니다.
- 한국 회사라면 요금보다 데이터 조건을 먼저 봐야 합니다. 데이터 레지던시는 미국만 지원하고, 샌드박스를 자체 서버에 둬도 무보존 대상이 아닙니다.
9월 10일 오픈AI가 제품 네 개를 한꺼번에 발표했습니다. 그중 Agents API는 코덱스를 돌리던 하네스를 개발자에게 API로 열어 준 제품입니다. 국내 보도는 같은 날 나온 금융 서비스용 챗GPT에 몰렸고, Agents API는 거의 다뤄지지 않았습니다. 에이전트를 직접 만들어 본 사람에게는 이 API가 무엇을 대신해 주는지, 한국 회사가 쓸 때 어디서 막히는지가 더 궁금할 겁니다. 아래 내용은 모두 공식 문서를 기준으로 했습니다.
추가 요금이 없다는 발표는 맞습니다. 다만 0원인 것은 API 사용료뿐이고, 모델 토큰값과 오픈AI가 호스팅하는 컨테이너값은 따로 청구됩니다. 한국 회사라면 요금보다 먼저 볼 조건이 있습니다. 이 API는 데이터 레지던시를 미국만 지원하고, 샌드박스를 자체 서버에 둬도 무보존 조건이 적용되지 않습니다.
Agents API는 코덱스가 쓰던 하네스를 API로 열었다
AI에게 며칠 걸리는 일을 맡기려면 그 과정을 관리할 하네스가 필요합니다. Agents API는 오픈AI가 그 하네스를 대신 운영해 주는 서비스입니다.
"장애 원인을 찾아서 정리해 둬" 같은 긴 일을 맡기면 모델 혼자서는 끝까지 가지 못합니다. 파일을 열고 명령을 실행할 환경이 있어야 합니다. 대화가 길어져 컨텍스트(모델이 한 번에 기억하는 분량)가 넘치면 앞부분을 요약해 줘야 하고, 중간에 끊기면 어디서 이어갈지도 알아야 합니다. 이런 관리 작업을 묶어 하네스라고 부릅니다. 에이전트를 만들어 본 사람들이 실제로 가장 많은 시간을 쓰는 곳도 모델보다 이쪽입니다.
오픈AI는 코덱스에서 이미 이 하네스를 운영해 왔고, 이번에 API 호출 한 번으로 쓸 수 있게 열었습니다. 개발자 문서는 하네스가 하는 일을 여섯 가지로 적어 두었습니다.
- 샌드박스에서 명령과 코드를 실행한다
- 도구와 MCP로 외부 데이터에 붙는다
- 작업 도중 사람이 입력해 방향을 바꿀 수 있다
- 컨텍스트가 한계에 가까워지면 앞 내용을 자동으로 압축한다
- 일을 나눠 서브에이전트에게 맡긴다
- 끊긴 세션을 이어서 진행한다
MCP는 AI를 외부 도구에 연결하는 규격입니다. 이 API에서는 MCP 서버 주소만 적으면 바로 도구로 등록됩니다.
Agents API 요금은 토큰값과 컨테이너값으로 나뉜다
청구 금액은 대부분 모델 토큰값에서 나옵니다.청구서에는 세 가지가 올라옵니다. 고른 모델의 토큰값, 오픈AI 도구 사용료, 그리고 오픈AI 호스팅 샌드박스를 골랐다면 컨테이너값입니다. 컨테이너는 에이전트가 파일을 두고 명령을 돌리는 리눅스 환경이고, 메모리 크기에 따라 값이 달라집니다.
| 메모리 | 20분 세션당 | 한 시간 환산 |
|---|---|---|
| 1GB | 0.03달러 | 약 121원 |
| 4GB | 0.12달러 | 약 484원 |
| 16GB | 0.48달러 | 약 1,935원 |
| 64GB | 1.92달러 | 약 7,740원 |
원화는 9월 13일 환율(1달러 1,343.80원)로 환산했습니다. 요금은 분 단위로 계산하지만 세션마다 최소 5분이 붙어서, 1초만 쓰고 닫아도 5분치를 냅니다.
4GB 컨테이너를 한 시간 켜 두면 484원입니다. 같은 시간 동안 GPT-6 아스트라가 입력 50만 토큰, 출력 10만 토큰을 썼다면 토큰값은 13,438원입니다. 컨테이너값은 전체의 3.5%밖에 안 됩니다. 비용을 줄이려면 컨테이너보다 토큰 사용량을 봐야 합니다.
토큰 단가는 GPT-6 아스트라 기준 100만 토큰당 입력 10달러, 출력 50달러입니다. 컨텍스트가 길어지면 입력 20달러, 출력 75달러로 오릅니다. 위 계산의 50만·10만 토큰은 가정한 값이고, 실제 사용량은 맡긴 일에 따라 크게 달라집니다. 감을 잡고 싶다면 딥시크 V4.1 플래시 가격 글의 벤치마크를 참고하면 됩니다. 거기서 아스트라는 작업 하나를 11.1분, 1.61달러에 끝냈습니다. 몇 시간짜리 일을 맡기면 비용도 걸린 시간만큼 늘어난다고 보면 됩니다.
서브에이전트는 기본 6개까지 동시에 돌고, 함수 도구는 못 쓴다
서브에이전트는 기본 6개까지 동시에 실행되고, 이들을 조율하는 상위 에이전트는 이 숫자에 들어가지 않습니다.
서브에이전트는 각자 자기 컨텍스트에서 따로 일하고, 상위 에이전트가 결과를 모아 하나로 합칩니다. 문서 세 개를 나눠 검토하거나 장애 원인 후보 셋을 따로 조사하는 일처럼, 서로 얽히지 않은 일에 맞습니다.
제약은 세 가지입니다.
| 제약 | 내용 |
|---|---|
| 함수 도구 불가 | 서브에이전트는 MCP 도구와 웹 검색은 물려받지만 직접 정의한 함수 도구는 쓸 수 없습니다 |
| 샌드박스 공유 | 서브에이전트를 만들어도 환경이 새로 생기지 않고, 상위 에이전트와 같은 파일시스템을 씁니다 |
| 완료 신호 아님 | 생성이나 대기 액션이 끝났다는 이벤트가 와도 그 서브에이전트가 일을 마친 것은 아닙니다 |
가장 헷갈리는 건 세 번째입니다. 끝났다는 이벤트를 받자마자 결과를 읽으러 가면 결과가 아직 없을 수 있습니다.
샌드박스는 네트워크를 잠글 수 있고, 1시간 동안 활동이 없으면 지워질 수 있다
샌드박스의 외부 통신은 세 단계로 설정할 수 있습니다. 가장 좁은 단계에서는 허용할 호스트를 하나씩 직접 적습니다.
기본값은 열림이고, 완전히 막거나 지정한 호스트만 열 수도 있습니다. 사내 시스템에 붙일 때는 지정 방식(restricted)을 쓰게 되는데 손이 꽤 갑니다. 정확한 호스트 이름을 1개에서 100개까지 적어야 하고, 와일드카드·프로토콜·경로·포트는 넣을 수 없습니다. 서브도메인이나 리다이렉트로 넘어가는 목적지도 하나하나 적어야 합니다. 에이전트가 닿을 수 있는 범위는 이 목록으로 정해집니다.
다음은 만료입니다. 활동과 연결 신호가 한 시간 끊기면 샌드박스가 지워질 수 있고, 이 시간은 설정으로 바꿀 수 없습니다. 다만 /workspace/outputs 아래 둔 파일은 턴이 끝날 때 따로 보관됩니다. 샌드박스가 사라진 뒤에도 내려받을 수 있으니 남길 결과물은 이 경로에 두면 됩니다.
OPENAI_API_KEY를 샌드박스 환경변수로 넣으면 거부됩니다. API 키는 샌드박스 밖에 두도록 막아 둔 셈입니다.
한국 회사는 데이터 레지던시와 무보존 조건에서 먼저 막힌다
Agents API는 데이터 레지던시를 미국만 지원하고 무보존도 지원하지 않습니다. 샌드박스를 자체 호스팅해도 이 조건은 같습니다.
개요 문서 맨 아래에 한 줄로 적힌 내용입니다. 데이터 레지던시는 내가 보낸 데이터가 어느 나라 서버에 남는지 정하는 조건이고, 무보존(ZDR)은 처리만 하고 저장하지 않는 조건입니다. 금융·의료·공공처럼 데이터를 국내에 둬야 하는 곳에서는 이 두 조건으로 도입 여부가 먼저 갈립니다.
챗GPT 기업용 요금제와 비교하면 차이가 뚜렷합니다. 기업용 요금제 기능표에는 대한민국을 포함해 10개국 데이터 레지던시가 적혀 있습니다. Agents API 목록에는 아직 한국이 없습니다.
샌드박스를 내 인프라에 두면 풀릴 것 같지만 아닙니다. 샌드박스 위치와 세션 데이터를 누가 갖고 있느냐는 별개 문제여서, 자체 호스팅을 골라도 무보존 대상이 되지 않습니다.
오픈AI와 앤트로픽 에이전트 제품은 세 갈래로 짝지어진다
두 회사 모두 에이전트 제품을 직접 짜기, 라이브러리로 짜기, 호스팅 서비스로 쓰기의 세 갈래로 나눠 두었습니다.앤트로픽 문서는 자기 제품 넷을 용도별로 나눠 두었습니다. 같은 기준에 오픈AI 제품을 놓으면 아래처럼 짝이 맞습니다.
| 하려는 일 | 앤트로픽 | 오픈AI |
|---|---|---|
| 샌드박스와 세션 인프라를 직접 운영하지 않고 에이전트를 오래 돌린다 | Managed Agents (호스팅 REST API) | Agents API |
| 도구 루프를 직접 짜지 않고 내 프로세스 안에서 돌린다 | Agent SDK (파이썬·TS 라이브러리) | Agents SDK |
| API를 직접 호출하고 루프도 직접 짠다 | Client SDK | Responses API 등 기존 API |
| 터미널에서 대화하며 작업한다 | Claude Code CLI | Codex CLI |
앤트로픽 쪽에서 함께 볼 조건이 둘 있습니다. Agent SDK는 파이썬과 타입스크립트 라이브러리로만 나와서, 다른 언어에서 같은 루프를 돌리려면 CLI를 하위 프로세스로 띄워야 합니다. 또 서드파티 개발자는 사전 승인 없이 자기 제품에 claude.ai 로그인이나 구독 사용량을 붙일 수 없고, 앤트로픽은 대신 API 키 인증을 쓰라고 안내합니다.
앤트로픽 Managed Agents의 데이터 레지던시 조건은 이번에 확인하지 못했습니다. 해당 개요 문서가 열리지 않았기 때문입니다. 이 표는 제품 구성이 어떻게 짝지어지는지만 보여 줄 뿐이고, 두 회사의 데이터 조건까지 같다고 보면 안 됩니다.
떠도는 말과 원문이 다른 부분
| 떠도는 주장 | 원문 기준 |
|---|---|
| 추가 요금이 없으니 공짜로 에이전트를 돌릴 수 있다 | 0원은 API 사용료뿐입니다. 토큰값, 도구값, 컨테이너값은 그대로 붙습니다 |
| 서브에이전트는 동시 3개까지다 | 3은 발표문 예제에 나온 값입니다. 문서상 기본값은 6이고, 조율하는 상위 에이전트는 이 숫자에 들어가지 않습니다 |
| 샌드박스를 내 서버에 두면 데이터가 안 남는다 | 그렇게 해도 무보존 대상이 아닙니다 |
| 하네스가 비공개라 안이 안 보인다 | 코덱스 하네스는 오픈소스로 공개돼 있습니다. 운영은 오픈AI가 맡고, 코드는 직접 열어 볼 수 있습니다 |
직접 만들지 오픈AI에 맡길지는 데이터를 어디까지 내보낼 수 있느냐로 정한다
비용과 수고만 보면 맡기는 쪽이 낫지만, 고객 데이터가 섞이면 지금은 쓰기 어렵습니다.이 API가 덜어 주는 일은 컨텍스트 압축, 세션 이어받기, 서브에이전트 조율, 샌드박스 관리입니다. 하나같이 직접 만들려면 시간이 꽤 들고, 다 만든 뒤에도 모델이 바뀔 때마다 다시 손봐야 하는 부분입니다. 오픈AI가 파는 게 바로 이 유지보수입니다. 새 모델이 나와도 하네스는 오픈AI가 맞춰 줍니다.
판단은 이렇게 갈립니다.
| 상황 | 판단 |
|---|---|
| 데이터가 공개 자료거나 내보내도 되는 범위다 | 오픈AI에 맡기는 편이 쌉니다. 하네스 유지보수를 직접 떠안지 않아도 된다는 점이 큽니다 |
| 고객 정보나 거래 데이터가 섞인다 | 지금은 보류합니다. 데이터 레지던시 조건이 풀릴 때까지 기다리거나, 외부로 나갈 데이터를 먼저 걸러 냅니다 |
| 사내 시스템에 연결해야 한다 | 네트워크를 restricted로 두고 호스트를 직접 적습니다. 그 목록이 곧 권한 범위입니다 |
| 일이 서로 얽히지 않은 덩어리로 나뉜다 | 서브에이전트를 쓸 만합니다. 얽힌 일을 쪼개면 다시 합치는 비용이 더 듭니다 |
한국 회사는 대부분 두 번째 줄에 걸립니다. 그렇다고 손 놓고 기다릴 일은 아닙니다. 무엇을 내보내고 무엇을 가릴지 정하는 것부터 해 두면 되고, 어느 API를 고르든 이 결정은 똑같이 거쳐야 합니다. ERP를 AI에 붙이면서 같은 문제를 정리한 기록은 ERP를 AI에 붙이기 전에 정해야 하는 여섯 가지에 있습니다.
자주 묻는 질문
지금 바로 쓸 수 있나요
퍼블릭 베타로 모든 개발자에게 열려 있습니다. 조건은 바뀔 수 있고, 오픈AI도 피드백을 받아 빠르게 고치겠다고 밝혔습니다.
월정액이 따로 있나요
없습니다. 모델 토큰, 도구 호출, 컨테이너 시간을 각각 쓴 만큼 냅니다.
컨테이너를 안 쓰면 값이 안 드나요
오픈AI 호스팅 샌드박스 대신 자체 호스팅이나 파트너 환경을 고르면 오픈AI 컨테이너 요금은 없습니다. 그 대신 해당 인프라 비용을 따로 냅니다.
한국 데이터를 넣어도 되나요
데이터 레지던시는 미국만 지원합니다. 국내 보관이 필요한 데이터라면 지금 조건과 맞지 않습니다. 사내 규정이 이 조건을 허용하는지부터 확인해야 합니다.
에이전트가 며칠씩 돌아도 되나요
세션은 이어집니다. 다만 샌드박스는 활동과 연결 신호가 한 시간 끊기면 지워질 수 있고, 이 시간은 바꿀 수 없습니다. 남길 파일은 /workspace/outputs에 둬야 만료 뒤에도 받을 수 있습니다.
클로드 코드로 하던 일을 옮길 수 있나요
Agents API에 대응하는 앤트로픽 제품은 Managed Agents입니다. MCP 서버는 양쪽 모두 붙일 수 있습니다. 다만 서브에이전트가 쓰는 도구 범위가 달라서, 오픈AI 서브에이전트는 직접 정의한 함수 도구를 쓰지 못합니다.