Assistants API v2 기준
⚠️ 종료일: 2026.08.26
OpenAI Assistants API 종료,
이 경우엔 Responses로 못 갑니다
2026년 8월 26일, OpenAI가 Assistants API를 완전히 끕니다. 문제는 “Responses API로 그냥 옮기면 되지”라는 생각이 틀렸다는 점입니다. Thread 대화 기록을 자동으로 이전해주는 도구가 없고, file_search를 쓰던 서비스는 비용이 최대 50% 오를 수 있습니다. 어떤 조건에서 막히는지, 공식 문서와 실사용자 사례를 직접 뒤져봤습니다.
종료 일정, 정확히 어떻게 됩니까
OpenAI는 2025년 8월 26일, Assistants API 종료를 공식 선언했습니다. 정확한 셧다운 날짜는 2026년 8월 26일이고, 이날 이후에는 해당 API 엔드포인트가 완전히 닫힙니다.
(출처: OpenAI 공식 Deprecations 문서)
공식 문서에는 이렇게 나와 있습니다. “When we released the Responses API in March 2025, we announced plans to bring all Assistants API features to the easier to use Responses API, with a sunset date in 2026.” 즉, Responses API에 기능 동등성이 갖춰졌다고 판단한 뒤 종료를 확정한 겁니다.
💡 공식 발표 시점(2025.08.26)과 실제 종료일(2026.08.26) 사이 간격이 정확히 1년입니다. 이메일 공지도 이미 발송된 상태라, “몰랐다”는 변명이 통하지 않습니다.
| 항목 | 날짜 | 내용 |
|---|---|---|
| Responses API 출시 | 2025.03 | Chat Completions 대체 목적으로 출시 |
| Assistants API 지원 중단 발표 | 2025.08.26 | deprecated 선언, 이메일 공지 발송 |
| ⚠️ Assistants API 완전 종료 | 2026.08.26 | 엔드포인트 접근 완전 차단 |
Responses API로 바꾸면 뭐가 달라집니까
가장 먼저 알아야 할 건 이겁니다. Responses API는 Assistants API의 1:1 교체가 아닙니다. OpenAI 개발자 커뮤니티에서 2026년 1월 6일에 올라온 글의 제목이 그대로 이 사실을 말해줍니다. “Assistants API → Responses API: this is not a 1:1 migration.” (출처: OpenAI 개발자 커뮤니티)
개념 구조 자체가 바뀝니다. Assistants가 Prompts로, Threads가 Conversations로, Runs가 Responses로, Run Steps가 Items로 이름이 바뀌고 동작 방식도 달라집니다. 이름만 다른 게 아니라 오케스트레이션 책임의 소재가 완전히 다른 곳에 놓입니다.
| Assistants API | Responses API | 핵심 변화 |
|---|---|---|
| Assistant | Prompt | 대시보드에서만 생성 (코드로 생성 불가) |
| Thread | Conversation | 메시지 외 tool call 등 Item 단위 저장 |
| Run (비동기) | Response (동기/스트리밍) | 폴링 루프 불필요, 단순화 |
| Run Steps | Items | 메시지·툴콜·출력 통합 객체 |
💡 가장 중요한 변화는 Prompt를 코드로 생성할 수 없다는 점입니다. 반드시 OpenAI 대시보드에서 직접 만들어야 합니다. 수백 개의 Assistant를 프로그래밍 방식으로 관리하던 서비스라면, 이 제약이 꽤 걸립니다.
Thread 기록은 어떻게 됩니까 — 자동 이전 없습니다
“기존 Thread 대화 기록을 Conversations로 자동으로 옮겨주는 도구는 제공하지 않는다.” 공식 마이그레이션 가이드에 그대로 나와 있습니다.
⚠️ 공식 문서 원문 (OpenAI Assistants Migration Guide)
“We will not provide an automated tool for migrating Threads to Conversations. Instead, we recommend migrating new user threads onto conversations and backfilling old ones as necessary.”
결국 기존 Thread를 Conversation으로 직접 코드를 짜서 옮겨야 합니다. 공식 문서에는 Python 예시 코드가 제공되지만, Thread 메시지를 페이지 단위로 가져와서 직접 파싱하고 Conversation Item 형식으로 변환하는 작업은 개발자가 직접 수행해야 합니다. 수만 개의 Thread를 운영하는 서비스라면, 이건 단순 API 교체가 아니라 데이터 이전 작업이 됩니다.
📌 공식 권장 방법 요약
- 신규 사용자 대화는 즉시 Conversations로 시작
- 기존 Thread는 필요에 따라 수동으로 백필(backfill)
- 백필 시
openai.beta.threads.messages.list()로 메시지를 추출 후 변환
실사용자 후기에서도 이 점이 확인됩니다. 수만 명의 사용자와 수천 개의 Vector Store를 운영하던 한 개발자는 Responses API로의 전환에 “약 2시간”이 걸렸다고 했지만, 그건 코드 수정 기준이고 Thread 데이터 정리는 별도 작업이라고 명확히 구분했습니다. (출처: OpenAI 개발자 커뮤니티, 2025.03.22)
file_search 비용이 올라가는 조건이 있습니다
Responses API로 전환하면 비용이 낮아진다고 알려져 있습니다. 실제로 OpenAI 공식 문서는 내부 테스트에서 캐시 활용률이 40~80% 개선됐다고 밝힙니다. 그런데 이건 전체 그림의 절반입니다.
💡 공식 발표와 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다
캐시 비용은 줄지만, file_search 도구 자체에 Assistants API에 없던 호출당 요금이 추가됩니다. 이 조합은 RAG 기반 서비스에서 비용을 오히려 높일 수 있습니다.
Responses API에서 file_search 도구를 사용하면 호출 1,000건당 $2.50가 별도 청구됩니다. (출처: OpenAI Pricing 페이지, 2026.03 기준) Assistants API에서는 이 별도 요금이 없었습니다.
⚠️ 비용 변화 시뮬레이션 (RAG 챗봇 기준)
| 항목 | Assistants API | Responses API |
|---|---|---|
| gpt-4o-mini 토큰비 (1,000건) | 약 $5 | 약 $4 (캐시 개선 시) |
| file_search 호출비 (1,000건) | $0 | $2.50 추가 |
| 합계 (1,000건) | 약 $5 | 약 $6.50 (최대 +50%) |
※ 추정값. 캐시 효율과 모델 버전에 따라 변동. 출처: OpenAI 공식 Pricing + 커뮤니티 실측 사례
file_search를 매 질문마다 호출하지 않는 구조라면 영향이 작습니다. 하지만 모든 대화에서 Vector Store를 참조하는 전형적인 RAG 패턴이라면, 전환 전에 비용 시뮬레이션이 필수입니다.
Chat Completions를 그냥 쓰면 안 됩니까
솔직히 말하면, 됩니다. OpenAI 공식 문서에는 이렇게 나와 있습니다. “While Chat Completions remains supported, Responses is recommended for all new projects.” 종료 예고된 건 Assistants API이지, Chat Completions API가 아닙니다. (출처: OpenAI Migrate to Responses 공식 가이드)
“Assistants API가 없어지면 Responses API로 무조건 가야 한다”는 말이 퍼져 있는데, 정확하지 않습니다. Assistants API → Responses API는 직접 대응 관계이고, Chat Completions API는 별개 경로입니다. 간단한 상태 비저장(stateless) 챗봇이라면 Chat Completions에서 굳이 옮길 이유가 없습니다.
📋 어떤 API를 선택할지 기준
- Chat Completions 유지 — 단순 단일 턴 응답, 상태 관리 불필요, 빠른 응답 최우선
- Responses API 전환 필요 — 웹 검색·file_search·computer use 등 내장 도구 활용, 멀티턴 에이전트, GPT-5 추론 모델 최적 활용
- Responses API 전환 시 주의 — RAG(file_search 다빈도 사용), 수백 개 Assistant 프로그래밍 방식 관리, ZDR(Zero Data Retention) 요구 조직
단, GPT-5.4부터는 Chat Completions에서 reasoning: none 이외 설정에서 툴 콜링이 지원되지 않습니다. 추론 모델을 본격적으로 활용할 계획이라면 Responses API로의 이전이 실질적인 필수 조건이 됩니다. (출처: OpenAI Migrate to Responses 공식 가이드)
지금 당장 해야 할 것, 미뤄도 되는 것
종료일이 2026년 8월 26일이니 아직 약 5개월이 남아 있습니다. 하지만 준비가 늦어지면 실제로 서비스 중단 위험이 생깁니다. 지금 바로 해야 할 것과 여유를 갖고 해도 되는 것을 구분하면 이렇습니다.
✅ 지금 바로 해야 할 것
- 현재 Assistants API 사용 여부 인벤토리 확인
- 사용 중인 Thread·Vector Store 규모 파악
- file_search 호출 빈도와 비용 시뮬레이션
- 대시보드에서 기존 Assistant → Prompt 변환 테스트
⏳ 2026년 6월 전까지
- 신규 기능 개발 시 Responses API 기반으로 시작
- 기존 Thread → Conversation 백필 코드 작성
- Structured Outputs 형식 변경 (
response_format→text.format) - 함수 호출 스키마 구조 변경 반영
💡 마이그레이션 난이도 현실 체크
실사용자 후기에 따르면 코드 수정 자체는 2시간 내외로 끝나는 경우도 있습니다. 단, Vector Store 파일 동기화 문제, Thread 백필, file_search 비용 재계산이 추가 작업으로 남습니다. 서비스 규모에 따라 전체 작업은 수일~수주까지 길어질 수 있습니다.
개인적으로 가장 조심해야 할 포인트는 “Playground 대체 도구가 없다”는 겁니다. Assistants Playground는 개발 초기 테스트에서 매우 유용했는데, Responses API에는 이에 해당하는 UI가 아직 없습니다. 이 부분이 좀 아쉬웠습니다.
Q&A
마치며
OpenAI Assistants API 종료는 단순한 API 교체 이슈가 아닙니다. Thread 데이터 이전을 직접 해야 하고, Prompt는 코드가 아닌 대시보드에서만 만들 수 있으며, file_search 비용 구조도 달라집니다. “그냥 갈아끼우면 된다”는 말을 그대로 믿고 8월을 기다리다간 생각보다 많은 작업이 한꺼번에 몰립니다.
반면 Chat Completions API는 계속 유지되니, 모든 서비스가 Responses API로 이전해야 하는 건 아닙니다. 자신의 서비스가 어떤 기능을 쓰고 있는지부터 점검하고, 필요한 작업 범위를 먼저 파악하는 게 순서입니다.
개인적으로 Responses API는 전반적으로 더 깔끔한 구조라고 봅니다. Assistants API가 항상 베타 딱지를 달고 있던 이유가 있었던 것 같고, Responses API 쪽이 실제로 더 단순하고 명확합니다. 단지 그 전환 과정이 자동화되지 않는다는 점이 걸립니다. 미리 준비하면 충분히 감당할 수 있는 작업입니다.
📚 본 포스팅 참고 자료
- OpenAI 공식 Deprecations 문서 — https://developers.openai.com/api/docs/deprecations/
- OpenAI Migrate to Responses 공식 가이드 — https://platform.openai.com/docs/guides/migrate-to-responses
- OpenAI Assistants Migration Guide — https://developers.openai.com/api/docs/assistants/migration/
- OpenAI 개발자 커뮤니티 — “My experience switching from Assistants API to Responses API” (2025.03.22) — community.openai.com
- OpenAI 개발자 커뮤니티 — “Assistants API → Responses API: this is not a 1:1 migration” (2026.01.06) — community.openai.com
※ 본 포스팅은 2026년 3월 27일 기준으로 작성되었습니다. OpenAI 서비스 정책·API 스펙·가격 구조는 이후 변경될 수 있으며, 최신 정보는 OpenAI 공식 문서에서 직접 확인하시기 바랍니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다.
댓글 남기기