Assistants API 종료, 지금 확인해야 할 전환 포인트 | DAKER 커뮤니티

어제까지 돌아가던 통합이 오늘 갑자기 실패했다면, 원인을 일시 장애로만 보기 어려운 시점입니다. OpenAI가 예고해 둔 Assistants API 종료일이 이미 지났기 때문입니다.

이번 변경은 ChatGPT 요금제 이야기가 아니라, /v1/assistants, /v1/threads, /v1/runs 경로를 쓰던 개발자용 API 통합에 관한 일입니다. 지금 필요한 것은 추측이 아니라 공식 문서 기준으로 현재 상태를 다시 확인하는 일입니다.

OpenAI가 공식 폐기 일정에 적어 둔 Assistants API는 2026년 8월 26일에 종료되었고, 기존 통합은 Responses API와 Conversations API로 옮겨야 합니다.

공식 문서가 말하는 종료 일정

OpenAI Deprecations 페이지의 Assistants API 항목에는 2025년 8월 26일에 폐기 예고를 했고, 정확히 1년 뒤인 2026년 8월 26일에 API에서 제거한다고 적혀 있습니다. 같은 표의 Recommended replacement는 Responses API and Conversations API입니다. 오늘(한국시간 8월 27일) 기준으로 종료일은 이미 지났습니다.

이 일정은 갑작스러운 당일 공지가 아닙니다. 공식 글은 2025년 3월 Responses API 출시 때 Assistants 기능을 Responses로 옮기고 2026년에 종료하겠다고 밝혔고, 이후 2025년 8월 26일 메일·문서 공지가 이어졌습니다. 따라서 종료일 이후 호출 실패는 예고된 일정에 따른 결과로 보는 것이 맞습니다.

유예 기간을 더 준다는 문장은 공식 폐기 페이지에 없습니다.

무엇으로 옮겨야 하는가

Assistants migration guide는 대응 관계를 분명하게 제시합니다. Assistants는 Prompts, Threads는 Conversations, Runs는 Responses, Run steps는 Items로 옮기는 구조입니다.

migration guide에 따르면, Assistants가 묶고 있던 모델·도구·지시문은 Prompts 쪽으로, Threads의 메시지 저장은 Conversations의 items 쪽으로, Runs의 실행은 Responses 쪽으로 이동합니다. Conversations는 단순한 메시지 저장소가 아니라 도구 호출과 출력 같은 항목도 함께 담습니다. 또 conversation 객체를 쓰면 previous_response_id를 매번 넘기지 않아도 맥락을 관리할 수 있다고 설명합니다.

Responses는 입력 항목을 보내고 출력 항목을 받는 구조이며, deep research·MCP·computer use 같은 기능도 이쪽에서 이어 간다고 문서에 적혀 있습니다.

새 통합을 설계할 때 기준이 되는 문서는 Responses API와 Conversations API를 가리키는 공식 문서 두 곳입니다.

이번 일이 아닌 것들

먼저 분리해서 봐야 할 점이 있습니다. 이것은 ChatGPT 구독이 끊긴 날이 아닙니다. 소비자 앱 요금제가 아니라 API에서 Assistants·Threads·Runs 객체를 쓰던 개발자 통합의 종료입니다.

또한 공식 페이지가 마이그레이션 비용을 숫자로 적어 준 것도 아닙니다. 인건비·토큰비·다운타임 견적은 공식 문서에 없으므로, 이 글에서도 임의의 수치를 만들지 않습니다.

유예 기간이 더 붙었다는 공지도 아닙니다. deprecations 표의 Shutdown date는 2026-08-26이며, 그 날짜를 연장한다는 문장은 공식 페이지에서 확인되지 않습니다.

Threads 전체를 자동으로 이전하는 버튼이 생긴 것도 아닙니다. migration guide는 자동 이전 도구를 제공하지 않는다고 적고 있습니다. 새 대화부터 옮기고, 필요한 경우에만 기존 메시지를 읽어 Conversations items로 넣는 예제를 보여 줍니다.

마지막으로, 이것은 Responses API 자체의 신규 출시 발표를 다시 쓰는 글도 아닙니다. Responses는 2025년 3월에 나왔고, 지금 중요한 것은 Assistants 종료가 실제 일정대로 도래했다는 점입니다.

지금 확인하면 좋은 항목

공식 폐기 페이지와 migration guide

가장 먼저 볼 문서는 developers.openai.com/api/docs/deprecations와 Assistants migration guide입니다. 사내 위키나 오래된 문서에 적힌 날짜보다 공식 표를 우선해 대조하는 것이 좋습니다.

저장소에 남아 있는 기존 호출

저장소에서는 beta.threads, assistants.create, /v1/assistants, /v1/threads, /v1/runs, OpenAI-Beta: assistants 헤더가 남아 있는지 먼저 찾으면 됩니다. 예제 폴더와 내부 도구 스크립트까지 범위를 넓혀 보는 편이 안전합니다.

종료일이 지난 뒤에는 옛 경로에 재시도 루프를 붙여 두는 것보다, 실패 로그가 Assistants 객체 이름을 가리키는지 확인하고 대체 API로 바꾸는 작업을 우선하는 것이 맞습니다.

새 트래픽과 기존 스레드 처리

새 사용자 대화부터는 Conversations·Responses로 보내는 것이 좋습니다. migration guide는 Threads를 자동으로 Conversations로 바꿔 주는 도구를 제공하지 않는다고 적고 있으므로, 오래된 스레드는 실제로 다시 열 필요가 있는 것만 골라 직접 옮기는 방식이 현실적입니다.

Threads 이전은 자동이 아니라 수동입니다.

프롬프트와 장기 운영 설정

migration guide는 Assistants 설정을 대시보드의 prompt로 옮기는 경로를 안내합니다. 다만 같은 deprecations 페이지에는 reusable prompts 자체의 별도 폐기 일정도 있으므로, 장기 운영 설정은 애플리케이션 코드와 버전 관리에 함께 두는 방안을 검토하는 것이 좋습니다.

다른 폐기 일정과 섞지 말아야 하는 이유

같은 deprecations 페이지에는 오디오·리얼타임 모델 2027년 1월 종료, GPT-5·o3 스냅샷 2026년 12월 종료, Agent Builder·Evals·reusable prompts 2026년 11월 종료 같은 다른 항목도 있습니다. 하지만 이번 글의 주제는 Assistants API 종료만입니다.

여러 폐기 일정을 한 제목이나 한 장애 채널에 묶으면 팀의 마이그레이션 우선순위가 흐려질 수 있습니다. Assistants 종료 장애와 다른 폐기 일정은 별도 티켓으로 두는 편이 원인 분석에도 도움이 됩니다.

한 페이지로 정리하면

OpenAI 공식 deprecations 페이지는 Assistants API Shutdown date를 2026년 8월 26일로 적고 있습니다. Recommended replacement는 Responses API and Conversations API입니다. 예고는 2025년 8월 26일이었고, Responses API는 2025년 3월에 나왔습니다. migration guide는 Assistants→Prompts, Threads→Conversations, Runs→Responses, Run steps→Items로 대응한다고 설명합니다. Threads 자동 이전 도구는 없다고 적혀 있습니다.

따라서 오늘(한국시간 8월 27일) 기준으로는 옛 경로 재시도보다 대체 API 이전이 우선입니다. 저장소에서는 beta.threads와 /v1/assistants·/v1/threads·/v1/runs 호출을 먼저 찾으면 됩니다. 런북 첫 줄에는 공식 deprecations와 migration guide 주소를 넣어 두는 것이 좋습니다.

장애 대응 문장도 짧게 정리할 수 있습니다. Assistants 경로에서 401·404·410류 오류가 보이면, 먼저 deprecations 표의 종료일을 확인하면 됩니다. 키 만료나 일시 장애로만 단정하지 않는 편이 좋습니다. 종료일이 지났다면 대체 API 이전 티켓을 최상단으로 올리고, 모니터링 알림 이름에 Assistants가 남아 있다면 Responses·Conversations 기준으로 바꾸는 것이 자연스럽습니다.

참고 자료

OpenAI — Deprecations (Assistants API shutdown 2026-08-26)
OpenAI — Assistants migration guide

현재 팀에서는 Assistants API 종료 대응을 어떤 순서로 정리하고 계신가요?