OpenAI 공식 문서
Responses API 기준
OpenAI Assistants API 종료, 이 날짜 놓치면 됩니다
2026년 8월 26일. OpenAI Assistants API가 완전히 꺼집니다.
그날 이후로는 API 호출 자체가 되지 않습니다. 지금 Assistants API로 서비스를 운영 중이라면
이 글에서 말하는 세 가지를 먼저 확인하세요.
“Responses API로 그냥 갈아끼우면 되지”라고 생각하면 막히는 지점이 있습니다.
Assistants API, 정확히 언제 어떻게 꺼지나
OpenAI가 공식 공지한 날짜는 두 개입니다. 2025년 8월 26일에 deprecated(지원 중단 선언)이 됐고,
2026년 8월 26일에 sunset(완전 종료)입니다.
(출처: OpenAI Assistants API 공식 문서)
2026년 8월 26일 이후에는 openai.beta.threads,
openai.beta.assistants 계열 엔드포인트
전체가 호출 불가가 됩니다. “베타”라는 딱지가 붙어 있어서 가볍게 봤다면, 실제로 운영 중인 서비스에는 치명적입니다.
지금 시점(2026년 3월 26일) 기준으로 종료까지 약 153일이 남았습니다.
스타트업이나 솔로 개발자 기준으로 전체 마이그레이션에 2~4주가 걸리는 걸 감안하면, 지금 시작해도 여유롭지 않습니다.
Thread 데이터, 자동으로 이전되지 않습니다
💡 공식 마이그레이션 가이드와 실제 이전 작업을 같이 놓고 보니 이 차이가 보였습니다.
“자동 이전 도구 제공”을 기다리고 있다면 안 옵니다.
Assistants API에서 사용자 대화를 저장하던 Thread는 Responses API의 Conversation으로 대체됩니다.
그런데 공식 마이그레이션 가이드에는 이 문장이 그대로 적혀 있습니다.
“We will not provide an automated tool for migrating Threads to Conversations.”
Thread를 Conversation으로 옮기는 작업은 개발자가 직접 코드를 짜야 합니다.
OpenAI가 제공하는 건 예시 코드뿐이고, 실제 이전 스크립트는 팀이 직접 작성해야 합니다.
수십만 건의 Thread가 쌓인 서비스라면, 이 작업 자체가 수 주를 잡아먹을 수 있습니다.
게다가 기존 Thread에 저장된 파일 첨부(image, file) 내용 중 일부는 변환 과정에서 항목이 누락될 수 있습니다.
공식 예시 코드가 텍스트 메시지 중심으로만 작성되어 있어, 멀티미디어 컨텍스트가 많은 서비스는 별도 검증이 필요합니다.
Responses API는 Assistants API와 구조가 다릅니다
“API만 갈아끼우면 되겠지”라는 생각이 가장 많이 막히는 지점입니다.
Assistants API는 서버 사이드에서 Thread·Run 생명주기를 관리해줬습니다.
Responses API는 기본 구조가 다릅니다. 오케스트레이션, 재시도, 히스토리 pruning 같은
작업이 앱 레이어로 이동합니다.
| Assistants API | Responses API | 바뀐 이유 |
|---|---|---|
Assistants |
Prompts |
버전 관리·롤백 가능 |
Threads |
Conversations |
메시지 외 tool call도 저장 |
Runs |
Responses |
단일 호출로 멀티턴 처리 |
Run steps |
Items |
메시지·툴콜·출력 통합 객체 |
Responses API에서 상태를 유지하는 방법은 두 가지입니다. 하나는 previous_response_id를 넘겨 체인을 이어가는 방식,
다른 하나는 Conversation 객체를 사용하는 방식입니다. 단, Conversation 방식을 쓸 때도
30일 TTL 정책이 Response 객체에는 적용된다는 점을 기억해야 합니다.
Conversation에 연결된 아이템은 별도 보존 정책이 적용되지만, 공식 문서가 이 부분을 명확하게 설명하지 않은 상태입니다.
File Search, 갈아타면 비용이 달라집니다
💡 공식 요금표와 실제 청구 구조를 같이 보니 이 차이가 보였습니다.
“기능이 같으면 비용도 같겠지”라는 가정이 틀린 경우입니다.
Assistants API에서 File Search(구 Retrieval)는 벡터 스토리지 비용($0.10/GB/일, 첫 1GB 무료)만 냈습니다.
쿼리 자체에는 별도 요금이 없었습니다.
Responses API에서는 다릅니다.
(출처: OpenAI API Pricing 공식 페이지)
| 항목 | Assistants API | Responses API |
|---|---|---|
| File Search 쿼리 비용 | 무료 | $2.50 / 1,000회 |
| 벡터 스토리지 비용 | $0.10/GB/일 (첫 1GB 무료) | $0.10/GB/일 (첫 1GB 무료) |
| Code Interpreter 컨테이너 | 별도 비용 없음 | $0.03/1GB (2026.03.31부터 인상 예정) |
하루에 File Search를 1,000번 호출하는 서비스라면, 이전 대비 월 $75의 추가 비용이 발생합니다.
File Search 사용량이 많은 RAG 파이프라인이나 고객지원 봇에서는 마이그레이션 전 비용 시뮬레이션이 필수입니다.
Prompt 오브젝트 API 생성이 안 되는 이유
Assistants API에서는 openai.beta.assistants.create()로 코드에서 직접
어시스턴트 오브젝트를 동적으로 생성할 수 있었습니다.
Responses API에서 이것과 동일한 역할을 하는 게 Prompt 오브젝트인데,
현 시점 기준으로 API를 통해 Prompt를 생성하는 엔드포인트가 없습니다.
공식 마이그레이션 가이드는 대시보드 → 플레이그라운드에서 수동으로 만들고,
그 Prompt ID를 코드에 하드코딩해서 사용하는 방식을 안내합니다.
동적으로 어시스턴트를 대량 생성하는 멀티테넌트 아키텍처를 쓰고 있다면,
이 구조를 처음부터 다시 설계해야 합니다.
OpenAI 커뮤니티에서도 이 부분을 “기능 패리티가 아니다”라는 지적이 공개적으로 나왔습니다.
(출처: OpenAI Community — Assistants API deprecation 스레드)
이게 지금 당장 서비스를 멈추게 할 수도 있는 이유입니다.
코드베이스가 Assistants를 동적으로 생성하는 구조라면,
Responses API 전환은 단순 API 교체가 아니라 아키텍처 재설계입니다.
GPT-5.4부터 Chat Completions로 못 돌아가는 상황
💡 OpenAI 공식 Responses API 가이드와 GPT-5.4 출시 노트를 교차해서 보니 이 연결이 보였습니다.
공식 Responses API 가이드에는 이 문장이 있습니다.
“Starting with GPT-5.4, tool calling is not supported in Chat Completions with
reasoning: none.”
쉽게 말하면, GPT-5.4 이상 모델을 쓰면서 함수 호출(function calling)이 필요한 경우
Chat Completions로는 처리가 안 됩니다.
Responses API로 넘어와야만 동작합니다.
Assistants API를 쓰지 않더라도 Chat Completions에서 최신 모델로 function calling을 쓰고 있다면
이미 Responses API 전환이 사실상 강제되는 구조입니다.
Assistants API 종료를 “나와 관계없는 이야기”로 보고 있었다면, 이 부분에서 해당될 수 있습니다.
마이그레이션 순서 — 지금 당장 할 것
전체 구조를 한 번에 바꾸려고 하면 오래 걸립니다.
아래 순서대로 단계를 나눠서 진행하는 게 실제로 덜 막힙니다.
대시보드 → Assistants 탭에서 현재 생성된 Assistant 오브젝트 전체 목록 확인. Thread 수와 파일 첨부 현황도 함께 파악.
플레이그라운드에서 각 Assistant를 Prompt로 변환. 현재 API 생성 불가이므로 대시보드에서 직접 진행.
기존 Thread는 유지하되, 새로운 사용자 대화는 Responses API + Conversation 객체로 받기 시작. A/B 방식으로 점진적 전환.
공식 가이드의 예시 코드를 참고해 Thread → Conversation 변환 스크립트 작성. 파일 첨부가 있는 메시지는 별도 처리 필요.
현재 File Search 월간 호출 수 × $0.0025 = 추가 예상 비용. 기존 대비 비용 차이를 산출하고 예산에 반영.
마이그레이션 완료 시점 목표는 2026년 7월 말로 잡는 게 안전합니다.
종료 1개월 전에 끝내야 예기치 않은 이슈 대응 시간이 생깁니다.
자주 묻는 질문 5가지
Q1. 지금 Assistants API를 쓰고 있는데, 아직 호출이 되나요?
▾
Q2. Thread 데이터가 8월 26일 이후에 자동으로 삭제되나요?
▾
Q3. Chat Completions API는 계속 사용할 수 있나요?
▾
Q4. n8n이나 Make 같은 노코드 툴로 Assistants API를 쓰고 있다면?
▾
Q5. Azure OpenAI에서도 같은 날짜에 종료되나요?
▾
마치며 — 총평
Responses API가 Assistants API보다 실제로 더 유연하고 강력한 건 맞습니다.
추론 모델과의 결합, 내장 툴 확장, 버전 관리 가능한 Prompt 체계 — 방향 자체는 좋습니다.
다만 마이그레이션이 “간단하다”는 말은 직접 해보기 전까지만 맞는 이야기입니다.
Thread 수동 이전, Prompt 대시보드 전용 생성, File Search 추가 과금, 멀티테넌트 구조 재설계.
이 네 가지만 봐도 단순 교체 작업이 아니라는 게 보입니다.
솔직히 말하면, 종료 공지가 나온 게 2025년 8월인데 아직 이전을 시작하지 않은 팀이 많을 겁니다.
D-153이라는 숫자를 일정에 박아두고, 이번 달 안에 현황 파악부터 시작하는 게 현실적입니다.
📚 본 포스팅 참고 자료
-
OpenAI Assistants API 공식 문서 — platform.openai.com
-
OpenAI Assistants API 마이그레이션 가이드 — platform.openai.com
-
OpenAI Migrate to Responses API 공식 가이드 — platform.openai.com
-
OpenAI 에이전트 빌딩 도구 공식 발표 블로그 (Responses API 출시) — openai.com
-
OpenAI API 공식 요금표 — developers.openai.com
-
OpenAI 커뮤니티 — Assistants API deprecation 공식 공지 스레드
본 포스팅은 2026년 3월 26일 기준 OpenAI 공식 문서를 바탕으로 작성되었습니다.
본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다.
최신 내용은 OpenAI 공식 문서에서 반드시 확인하세요.
댓글 남기기