OpenAI Agents API 실전: AI Agent 구축, 클라우드 배포, API와 서버 비용 계산

OpenAI Agents API는 2026년 9월 10일 공개 베타에 들어갔습니다. 고르는 것은 모델, 도구, 실행 환경입니다. Codex를 움직이는 하네스는 OpenAI가 호스팅합니다. API 자체에는 플랫폼 요금이 없습니다. 청구서는 대개 세 줄입니다. 모델 토큰, 기본 제공 도구, 그리고 호스팅 샌드박스를 실제로 썼을 때만 나오는 컨테이너 시간입니다. xcodebuild, 시뮬레이터, 서명이 필요한 작업은 Linux 샌드박스에서 할 수 없습니다. 그 단계는 잠들지 않는 Mac이 따로 필요합니다.

오늘은 DevDay(2026년 9월 29일, 샌프란시스코)입니다. 아래 단가는 집필 당시 열어 둔 가격 페이지, GPT-6 Astra 모델 페이지, Agents API 발표의 숫자입니다. 키노트에서 가격이 바뀌면 콘솔과 가격 페이지가 우선입니다. 기능 지도는 DevDay 프리뷰와 GPT-6 Astra 기능과 가격에 있습니다.

청구서를 세 줄로 나누기

“Agent가 비싸다”는 말은 대개 네 가지를 더한 결과입니다. 플래그십 모델, 검색, 놀고 있는 컨테이너, macOS 때문에만 빌린 머신입니다. 나누면, 일상 루프가 비싼 이유는 모델 등급이지 Agents API를 호출했기 때문이 아닙니다.

가장 작은 Agent 만들기

입구는 POST /v1/agents/sessions이고, 헤더는 OpenAI-Beta: agents=v1입니다. 키에는 api.agents.read, api.agents.write, 추론용 api.responses.write가 필요합니다. 키는 요청을 보내는 프로세스에 둡니다. OPENAI_API_KEY를 샌드박스 환경 변수에 넣지 마세요. PATH, CODEX_* 같은 예약 이름은 거부됩니다.

curl --no-buffer --fail-with-body https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "model": "gpt-6-sol",
      "instructions": "Write clean code, run it, and report the actual output."
    },
    "environment": { "type": "openai_hosted" },
    "input": "Create tree.py, print a readable tree of the current directory, run it, show the output.",
    "stream": true
  }'

처음에는 gpt-6-sol입니다. 모든 세션에 gpt-6-astra를 넣지 마세요. 통과 조건은 하나입니다. 파일을 쓰고, 실행하고, 실제 출력을 다시 읽는 것입니다. 측정이 끝난 어려운 사례만 Astra로 올립니다. 서브 Agent를 켜면 토큰은 Agent마다의 컨텍스트로 더해집니다. 사용자 메시지 한 줄의 가격이 아닙니다.

클라우드에 두는 세 자리

여기서 배포는 플랫폼을 한 겹 더 씌우는 일이 아닙니다. 누가 API를 호출하는지, 도구가 어느 머신에서 도는지, 이 두 가지입니다.

openai_hosted: 스크립트와 검사

호스팅 샌드박스는 Python, Node.js, 셸이 있는 Linux 작업 공간입니다. 작업 디렉터리는 /workspace입니다. 스크립트 생성, 데이터 처리, Apple 도구 체인이 필요 없는 저장소 검사에 맞습니다. 네트워크는 작업마다 조일 수 있습니다. 문서 예시에는 먼저 접근을 끄고, 통한 뒤에 여는 경우가 많습니다.

깨어 있는 프로세스

프로토타입은 앞의 노트북에서 이 curl을 보내도 됩니다. 덮개를 닫으면 긴 세션은 끊깁니다. 운영에서는 잠들지 않는 프로세스에 호출을 둡니다. 큐, webhook, 타이머입니다. 이 프로세스는 작아도 됩니다. iOS를 컴파일하지 않습니다. 커스텀 이미지, GPU, 사설 네트워크는 self_hosted나 문서의 파트너 환경입니다. 호스팅 샌드박스에 억지로 넣지 마세요. 요청 필드는 개발자 문서를 따릅니다.

Mac이 꼭 필요할 때

호스팅 샌드박스는 Linux입니다. xcodebuild, iOS 시뮬레이터, 서명, TestFlight는 macOS가 필요합니다. 오케스트레이션은 Agents API에 두고, Apple 도구 체인은 Cloud Mac에 둡니다. 스크립트와 프런트 검사는 샌드박스, 아카이브와 서명은 Mac입니다.

집필일 홈의 가격 표시는 M4 · 16GB / 256GB 월 $101.7부터, M4 · 24GB / 512GB 월 $200.3부터였습니다. 일, 주, 월, 분기를 고를 수 있습니다. 짧은 수용 테스트는 일이나 주, 상주 빌드는 월로 바꿉니다. 결제는 플랜 페이지를 따릅니다. 시작가를 계약가로 쓰지 않습니다.

API 비용 계산

표는 짧은 컨텍스트, 100만 토큰당 미국 달러입니다. 입력이 272K를 넘으면 요청 전체가 긴 컨텍스트입니다. 입력과 캐시는 약 2배, 출력은 약 1.5배이며, 넘친 부분에만 붙는 가격이 아닙니다. Batch / Flex는 표준의 약 절반, Fast는 약 2배입니다. 캐시된 입력은 더 싸고, 캐시 쓰기는 캐시되지 않은 입력의 약 1.25배입니다.

경로가 아직 GPT-5.6 Sol이면, 9월 20일 문서와 맞던 프로모션은 입력 $4, 출력 $20이고 11월 21일까지로 적혀 있었습니다. 다른 모델 행입니다. gpt-6-sol의 $2 / $10과 더하지 마세요. 내보내기 전에 가격 페이지를 다시 보세요.

서버 비용을 더하는 법

• 앉아 있는 동안에만 호출한다.서버는 $0입니다. 덮개를 닫으면 멈추고, 밤샘 작업은 받지 못합니다.
• webhook을 하루 종일 받고, 도구는 전부 샌드박스나 순수 API다.오케스트레이션 프로세스는 가볍습니다. 이미 켜 둔 머신이 있다면 Agents API 때문에 Mac을 또 빌리지 마세요.
• macOS가 필요하다.Cloud Mac을 더합니다. 16GB 홈 시작가는 약 $101.7 / 월입니다. 토큰을 대신하지 않습니다. Mac 없이는 못 하는 그 단계만 대신합니다.

숫자를 바꿀 수 있는 월간 워크시트

이것은 견적서가 아니라 워크시트입니다. 영업일 22일, 하루 40세션, 합계 880회입니다. 매번 짧은 컨텍스트, 캐시 없음, 입력 2만 토큰, 출력 4천 토큰, Web search 1회입니다. 입력 합계 17.6M, 출력 합계 3.52M입니다.

세 가지 대조입니다. 가져온 본문 토큰은 아직 빠졌습니다.

• Luna + 검색 + 1 GB를 5분 하한만: 약 $19(3.52 + 8.80 + 6.60).
• 혼합 모델 + 검색 + 1 GB를 20분 전부: 약 $134(98.56 + 8.80 + 26.40).
• 그 줄에 16GB Cloud Mac 시작가를 더하면: 약 $235(134 + 101.7). Mac을 빼도 API 쪽은 약 $134입니다.

자기 양으로 바꿀 때는 세 숫자만 바꿉니다. 세션 수, 회당 입력 토큰, 회당 출력 토큰입니다. 단가 줄은 가격 페이지와 맞추세요. 880회가 88회가 되면 모델, 검색, 컨테이너는 대략 10으로 나뉩니다. Mac 월 요금은 나뉘지 않습니다.

FAQ

Agents API에 플랫폼 요금이 있나요?

베타 발표에는 없다고 되어 있습니다. 내는 것은 고른 모델의 토큰, 실제로 호출한 기본 제공 도구, openai_hosted를 썼을 때의 컨테이너 시간입니다.

일상에는 어느 모델을 쓰나요?

기본은 gpt-6-sol 또는 gpt-6-luna입니다. 같은 880세션에서 전부 Astra인 모델 줄은 $352, Sol 90%에 Astra 10%이면 $98.56입니다. 어려운 사례는 고정 평가로 비교한 뒤에 올리세요.

호스팅 샌드박스에서 Xcode가 되나요?

안 됩니다. Linux입니다. 서명, 시뮬레이터, xcodebuild는 macOS에 둡니다. Cloud Mac은 그 단계를 맡습니다. API 청구를 대신하지 않습니다.

키는 어디에 두나요?

API를 호출하는 프로세스입니다. 샌드박스 환경 변수가 아닙니다. 베타는 Zero Data Retention을 지원하지 않고, self_hosted도 예외가 아닙니다.

한 달은 어떻게 추정하나요?

위의 880회를 기준으로 횟수와 토큰을 바꿉니다. 컨테이너는 1 GB와 4 GB 두 열, 5분 하한과 20분 전부를 같이 보세요. DevDay 당일 가격이 바뀌면 가격 페이지가 우선입니다.

먼저 통과시키고, 그다음 청구 세 줄을 본다

순서는 최소 세션, 세 줄의 청구, 마지막에 Mac이 필요한지입니다. 기본 모델은 Sol이나 Luna에 두고, Astra는 측정이 끝난 어려운 사례만입니다. Linux 샌드박스는 스크립트, macOS는 아카이브입니다. 한 머신으로 다른 쪽을 대체하지 말고, 두 청구를 “Agent 월 요금” 하나로 합치지 마세요.

더 읽어 보기

• OpenAI DevDay 2026: GPT-6 Astra, Agents API, Codex
• GPT-6 Astra: 기능, 가격, API