Assistants API 지원 중단 및 마이그레이션
개요
Assistants API는 OpenAI가 2025년 8월 26일에 공식 지원 중단(deprecation)을 통보한 API입니다. 셧다운 날짜는 통보일로부터 정확히 1년 뒤인 2026년 8월 26일로 예정되어 있습니다. OpenAI Deprecations API 문서에 따르면, OpenAI는 2025년 3월 Responses API를 출시할 당시 Assistants API의 모든 기능을 더 사용하기 쉬운 Responses API로 이전하겠다는 계획을 함께 발표한 바 있습니다. OpenAI Deprecations API
지원 중단 세부 일정
OpenAI API 지원 중단 정책에 따라 일반 공개(Generally Available) 모델 및 API에는 최소 6개월의 사전 공지 기간이 주어집니다. Assistants API는 이 기준을 준수하여 공지에서 셧다운까지 1년의 유예 기간이 부여되었습니다. OpenAI Deprecations API
| 날짜 | 내용 |
|---|---|
| 2025년 8월 26일 | 지원 중단 공지 발송 (이메일 및 문서) |
| 2026년 8월 26일 | Assistants API 접근 완전 종료 (셧다운) |
대체 수단
OpenAI는 Assistants API를 사용하는 개발자에게 다음 두 가지 API로 마이그레이션할 것을 권장합니다. OpenAI Deprecations API
- Responses API — 더 간편한 인터페이스로 Assistants API의 핵심 기능을 대체
- Conversations API — 대화 상태 관리를 위한 신규 API
Responses API vs Assistants API 비교 페이지에서 두 API 간의 기능 차이를 확인할 수 있습니다.
과거 버전: Assistants API v1 베타 지원 중단
Assistants API에는 이전에도 베타 버전 간 마이그레이션이 있었습니다. 2024년 4월 v2 베타 출시 시점에 v1 베타의 종료가 예고되었으며, 2024년 12월 18일에 v1 베타 접근이 종료되었습니다. OpenAI Deprecations API
| 셧다운 날짜 | 대상 | 권장 대체 |
|---|---|---|
| 2024-12-18 | OpenAI-Beta: assistants=v1 | OpenAI-Beta: assistants=v2 |
마이그레이션 흐름
마이그레이션 상세 절차는 OpenAI 공식 문서의 *Assistants to Conversations migration guide*를 참고하세요. OpenAI Deprecations API
관련 지원 중단 항목
Assistants API 외에도 동 시기에 여러 플랫폼 구성 요소가 지원 중단되었습니다. 전체 일정은 OpenAI 모델 셧다운 타임라인 (2026~2027)에서 확인할 수 있습니다.
- Evals 플랫폼 지원 중단 및 Promptfoo 마이그레이션 — 2026-11-30 셧다운
- Agent Builder 지원 중단 및 Agents SDK 마이그레이션 — 2026-11-30 셧다운
- OpenAI 셀프서브 파인튜닝 지원 중단 — 2027-01-06 신규 작업 생성 종료
- Sora 2 및 Videos API 지원 중단 — 2026-09-24 셧다운
- OpenAI 레거시 모델 지원 중단 이력 — 과거 전체 이력 정리
용어 정리
OpenAI API 지원 중단 정책에서 정의하는 주요 용어는 다음과 같습니다. OpenAI Deprecations API
| 용어 | 의미 |
|---|---|
| Deprecation(지원 중단) | 모델 또는 엔드포인트 퇴역 프로세스 시작. 공지 즉시 deprecated 상태가 됨 |
| Shutdown / Sunset(셧다운) | 모델 또는 엔드포인트에 더 이상 접근할 수 없는 상태. 두 용어는 동의어로 사용 |
| Legacy(레거시) | 더 이상 업데이트를 받지 않는 모델 또는 엔드포인트. 미래에 deprecated될 가능성이 높음 |