OpenAI Agents API와 Responses API 중 무엇을 써야 할까요? 장시간 여러 도구를 쓰며 진행 상태를 이어가는 에이전트를 OpenAI가 운영하게 하려면 Agents API, 앱이 호출·상태·도구 실행을 직접 설계하려면 Responses API가 출발점입니다. 앱 안에서 에이전트 루프와 승인 절차를 직접 운영하고 싶다면 Agents SDK도 후보입니다. 다만 Agents API는 현재 미국 데이터 레지던시만 지원하고 Zero Data Retention(ZDR) 대상이 아닙니다. 한국 기업이 데이터 보존 요건을 먼저 검토해야 하는 이유입니다.
아래 내용은 2026년 9월 27일 OpenAI 공식 문서를 확인한 결과입니다. 실제 서비스의 성능·청구액을 직접 측정한 후기는 아니며, 공개 베타의 조건은 바뀔 수 있습니다.
직접 생성한 구조 비교 개념 이미지입니다. 실제 제품 화면이나 공식 도식이 아닙니다.
Agents API vs Responses API: 운영 주체가 다르다
OpenAI의 공식 선택 가이드는 세 도구를 모델 성능의 높고 낮음이 아니라 누가 에이전트 실행과 상태를 관리하느냐로 구분합니다.
- Agents API: OpenAI가 Codex 기반 에이전트 하네스, 세션, 오케스트레이션, 컨텍스트 압축과 복구를 관리합니다. 개발자는 도구를 연결하고 실행 환경을 고릅니다. 여러 단계의 오래 걸리는 업무에 적합합니다.
- Agents SDK: 에이전트 루프와 도구·핸드오프를 앱 런타임 안에서 실행합니다. 배포, 저장소, 승인 흐름과 통합을 개발팀이 더 직접 제어합니다.
- Responses API: 모델 응답을 직접 호출합니다. 단일 질의부터 자체 에이전트 루프까지 만들 수 있지만, 반복 실행·재시도·도구 결과 연결 같은 운영 로직을 앱이 설계해야 합니다.
예를 들어 사내 문서 질의에 답하고 결과를 앱 화면에 보여 주는 기능은 Responses API부터 검토할 수 있습니다. 반면 저장소를 조사하고 명령을 실행하며 중간 진행 상태를 이어가는 작업은 Agents API가 줄여 주는 운영 부담이 큽니다. 자체 승인 게이트와 런타임 통제가 핵심이라면 SDK를 비교하세요. 이는 공식 기능 차이에 근거한 선택 기준이지 모든 서비스에 같은 구조가 최적이라는 뜻은 아닙니다.
Agents API 비용: 추가 API 이용료 0원과 무료는 다르다
OpenAI는 출시 발표에서 Agents API 자체의 추가 이용료는 없다고 설명합니다. 그러나 개발 문서의 가격 항목에는 선택한 모델의 토큰 요금, OpenAI 도구 요금, OpenAI 호스팅 샌드박스를 사용할 때의 컨테이너 요금이 명시돼 있습니다. 외부 서비스를 호출한다면 그 서비스 요금도 따로 보세요. ChatGPT 구독료와 개발자 API 요금은 별개입니다.
예산식: 총비용 = 루트 에이전트·하위 에이전트의 모든 모델 호출 + 유료 도구 + 호스팅 샌드박스 + 외부 서비스. 실패 후 재시도도 호출 수에 넣어야 합니다. 한 작업을 1회 처리했다고 모델도 한 번만 호출한 것은 아닙니다. OpenAI의 사용량 문서는 사용량 값이 추정치일 수 있으며 누락이 0원 청구를 뜻하지 않는다고 경고합니다.
모델·도구·컨테이너 비용과 데이터 보존을 함께 검토하는 직접 생성 개념 이미지입니다. 실제 청구서나 보안 인증 화면이 아닙니다.
한국에서 예상 비용을 잡을 때는 공식 API 가격표의 현재 모델·도구·컨테이너 단가에 실제 테스트의 호출 횟수를 대입하세요. 달러 가격 외에 적용 환율·세금·결제 조건도 별도로 확인해야 합니다. 특정 모델의 토큰 계산 예시는 이 블로그의 GPT-6 Astra API 가격 가이드, 반복 작업의 캐시 변수는 프롬프트 캐싱 점검 글을 참고할 수 있습니다.
한국 기업의 보안 판단: Agents API는 현재 미국 리전만
OpenAI 공식 설명에 따르면 Agents API 세션 데이터의 레지던시는 현재 미국만 지원하며, 이 API는 ZDR을 지원하지 않습니다. 실행용 샌드박스를 자체 호스팅하더라도 Agents API 자체가 ZDR 대상이 되는 것은 아닙니다. 따라서 국내 저장, 다른 리전 저장 또는 ZDR이 필수인 조직은 이 API로 먼저 설계를 확정하지 말고 데이터 처리 조건을 검토해야 합니다.
그렇다고 Responses API나 SDK를 선택하면 자동으로 모든 보존·지역 요건이 해결된다고 단정할 수도 없습니다. 사용하려는 모델, API 기능, 조직의 데이터 제어 설정과 계약을 각각 확인해야 합니다. 특히 고객 문서·소스코드·개인정보를 연결할 계획이라면 입력 범위, 도구 권한, 로그 보존 기간과 승인 단계를 먼저 정하세요. 실무 점검 항목은 AI 에이전트 보안 가이드와 함께 볼 수 있습니다.
Assistants API에서 옮길 때 Agents API로 바로 갈까?
아닙니다. 자동 대체재로 보면 안 됩니다. OpenAI의 공식 이전 가이드는 2026년 8월 26일 종료된 Assistants API의 새 통합 대상으로 Responses API를 제시합니다. 기존 Assistants·Threads·Runs의 개념은 각각 Prompts·Conversations·Responses에 대응됩니다. 기존 앱의 채팅 흐름을 옮기는 목적이라면 이 경로부터 점검하세요.
다만 이전 과정에서 장시간 코딩·파일 작업과 재개 가능한 세션을 새로 도입한다면 Agents API를 별도 아키텍처 선택지로 평가할 수 있습니다. 기존 Threads를 Agents API 세션에 이름만 바꿔 넣는 방식은 아닙니다. 특히 공식 문서는 종료된 Assistants API에서 과거 메시지를 다시 가져오는 호출이 더는 동작하지 않는다고 설명하므로, 이전 대화가 필요하면 앱이 보관한 데이터를 확인해야 합니다.
도입 전 4단계 체크리스트
- 업무를 분해: 단일 응답인지, 수십 단계에 걸쳐 파일·도구를 쓰는지, 중간에 재개해야 하는지 적습니다.
- 데이터 조건 확인: 미국 리전과 ZDR 미지원이 허용되는지 검토하고, 민감 자료를 넣지 않은 샘플로 먼저 시험합니다.
- 같은 과업으로 비교: Responses API 또는 SDK 자체 구현과 Agents API를 동일한 성공 기준·승인 규칙으로 테스트합니다. 완료율, 소요 시간, 모든 호출 비용을 함께 기록합니다.
- 운영 한도 설정: 도구 권한 최소화, 반복·재시도 상한, 사람 승인 지점과 월 예산 경보를 정한 뒤 확대합니다.
결론은 간단합니다. 운영을 맡길 가치가 크고 미국 데이터 조건이 허용되면 Agents API를 시험하세요. 앱의 실행·데이터 통제가 핵심이면 Agents SDK, 기존 채팅 이전이나 직접 구성하는 작은 흐름이면 Responses API가 출발점입니다. 공개 베타의 기능과 가격은 출시 때마다 바뀔 수 있으므로 계약·배포 직전에 공식 문서를 다시 확인하세요.
공식 출처
'Tech' 카테고리의 다른 글
| Claude 플러그인 설치 방법: 무료 계정·화면별 지원 차이 (0) | 2026.09.27 |
|---|---|
| Claude 플러그인 등록 방법: 디렉터리 제출 조건·MCP와 스킬 차이 (0) | 2026.09.27 |
| Gemini 연결 앱 한국 지원 여부: Adobe·monday.com과 Airtable·Linear 차이 (0) | 2026.09.27 |
| Qwen Intelligence란? 3가지 에이전트·HONOR 출시·가격 (0) | 2026.09.27 |
| iOS 27 업데이트 후 배터리 빨리 닳음: 기다릴 때와 점검·수리 순서 (0) | 2026.09.26 |
댓글