어시스턴트 API가 어제 끊겼습니다 | DAKER 커뮤니티

OpenAI가 공식 폐기 일정에 적어 둔 Assistants API가 2026년 8월 26일에 종료되었습니다. /v1/assistants, /v1/threads, /v1/runs 경로로 돌리던 통합은 이제 Responses API와 Conversations API로 옮겨야 합니다. 유예 기간을 더 준다는 문장은 공식 폐기 페이지에 없습니다.

나온 것

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

2. 마이그레이션 안내가 따로 있습니다. Assistants migration guide는 Assistants → Prompts, Threads → Conversations, Runs → Responses, Run steps → Items로 대응표를 제시합니다. Responses는 입력 항목을 보내고 출력 항목을 받는 구조로, deep research·MCP·computer use 같은 기능을 이쪽에서 이어 간다고 적혀 있습니다. conversation 객체를 쓰면 previous_response_id를 매번 넘기지 않아도 맥락을 관리할 수 있다고 설명합니다.

3. 예고는 1년 전이었습니다. 공식 글은 2025년 3월 Responses API 출시 때 Assistants 기능을 Responses로 옮기고 2026년에 종료하겠다고 밝혔다고 적습니다. 2025년 8월 26일 메일·문서 공지 뒤 1년이 지난 일정입니다. “갑작스러운 당일 공지”로 팀에 설명하지 않습니다. 다만 종료일 이후에 호출이 실패하면, 그 실패는 예고된 일정에 따른 결과입니다.

4. 대체 API의 역할이 나뉩니다. migration guide 기준으로 Assistants가 묶던 모델·도구·지시문은 Prompts 쪽으로, Threads의 메시지 저장은 Conversations의 items 쪽으로, Runs의 실행은 Responses 쪽으로 옮깁니다. Conversations는 메시지뿐 아니라 도구 호출·출력 같은 항목도 담습니다. Threads를 자동으로 Conversations로 바꿔 주는 도구는 제공하지 않는다고 적혀 있습니다. 새 사용자 대화부터 Conversations·Responses로 옮기고, 오래된 스레드는 필요할 때 직접 옮기라는 안내입니다.

5. 공식 문서가 가리키는 다음 주소는 두 곳입니다. 폐기 표와 migration guide 모두 Responses API와 Conversations API를 대체로 적습니다. 새 통합을 설계할 때는 이 두 문서를 기준으로 삼습니다. 서드파티 블로그의 일정표보다 공식 deprecations 페이지를 먼저 엽니다.

6. 다른 폐기 일정과 섞지 않습니다. 같은 deprecations 페이지에는 오디오·리얼타임 모델 2027년 1월 종료, GPT-5·o3 스냅샷 2026년 12월 종료, Agent Builder·Evals·reusable prompts 2026년 11월 종료 같은 다른 줄이 있습니다. 오늘 본문은 Assistants API 종료만 다룹니다. 다른 줄을 한 제목에 묶으면 팀 마이그레이션 우선순위가 흐려집니다.

아닌 것

ChatGPT 구독이 끊긴 날이 아닙니다. 소비자 앱 요금제 이야기가 아닙니다. API에서 Assistants·Threads·Runs 객체를 쓰던 개발자 통합의 종료입니다.

마이그레이션 비용을 공식 페이지가 숫자로 적어 준 것도 아닙니다. 인건비·토큰비·다운타임 견적을 이 글에서 만들지 않습니다. 공식 문서에 없는 비용을 “대략 이만큼”으로 팀에 알리지 않습니다.

유예 기간이 더 붙었다는 공지도 아닙니다. deprecations 표의 Shutdown date는 2026-08-26입니다. 그 날짜를 연장한다는 문장을 공식 페이지에서 확인하지 못했습니다. “며칠만 더 된다”는 가정을 운영 계획에 넣지 않습니다.

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

Responses API 자체의 신규 출시 발표를 오늘 다시 쓰는 글도 아닙니다. Responses는 2025년 3월에 나왔고, 오늘은 Assistants 쪽 종료가 실제로 도래한 날의 정리입니다.

오늘 할 일

첫째, 공식 폐기 페이지를 엽니다. developers.openai.com/api/docs/deprecations의 Assistants API 행에서 종료일과 대체 API를 확인합니다. 사내 위키에 복사한 날짜가 있으면 공식 표와 대조합니다.

둘째, migration guide를 읽습니다. Assistants migration guide의 대응표와 예제 코드를 기준으로, 우리 저장소에서 beta.threads·assistants 호출이 남은 파일을 찾습니다.

셋째, 새 트래픽부터 Responses·Conversations로 보냅니다. 종료일이 지난 뒤에는 옛 경로에 재시도 루프를 붙여 두지 않습니다. 실패 로그가 Assistants 객체 이름이라면 대체 API로 바꾸는 작업이 먼저입니다.

넷째, 프롬프트·도구 설정을 어디에 둘지 정합니다. migration guide는 Assistants 묶음을 대시보드의 prompt로 옮기는 경로를 안내합니다. 다만 reusable prompts 자체도 별도 폐기 일정이 있으므로, 장기 저장은 애플리케이션 코드와 버전 관리에 두는 방안을 같이 검토합니다.

다섯째, 만든 결과는 링크로 남기십시오. DAKER에는 25만 빌더와 339+ 대회, 29억+ 규모의 기록이 쌓여 있습니다. 이전 체크리스트와 샘플 Responses 호출을 공개 링크로 남기면 같은 API를 쓰던 팀이 바로 대조할 수 있습니다. 배포가 제출입니다. 올린 링크가 제출입니다.

저장소에서 바로 확인할 항목

코드 검색 키워드를 고정합니다. beta.threads, assistants.create, /v1/assistants, /v1/threads, /v1/runs, OpenAI-Beta: assistants 헤더가 남아 있는지 저장소 전체에서 찾습니다. 예제 폴더와 내부 도구 스크립트까지 범위를 넓힙니다. 종료일이 지난 뒤에는 재시도 라이브러리가 옛 경로를 반복 호출하며 로그만 키울 수 있습니다.

런북의 첫 줄은 공식 폐기 페이지 주소입니다. 사내 위키에 복사한 날짜가 틀릴 수 있습니다. deprecations 표의 Assistants 행을 열어 Shutdown date가 2026-08-26인지 확인합니다. 대체 칸에 Responses API and Conversations API가 있는지도 같이 봅니다.

Threads 이전은 수동입니다. migration guide는 자동 이전 도구가 없다고 적습니다. 새 세션은 Conversations로 만들고, 꼭 필요한 옛 스레드만 메시지를 읽어 items로 넣는 방식이 안내되어 있습니다. “모든 히스토리를 오늘 밤 옮긴다”는 계획을 세우기 전에, 실제로 다시 열 스레드 목록을 먼저 고릅니다.

Prompts 경로를 쓸 때도 일정표를 같이 봅니다. Assistants 설정을 대시보드 prompt로 옮기는 안내가 있지만, reusable prompts 자체도 별도 폐기 일정이 같은 deprecations 페이지에 있습니다. 장기 운영 설정은 애플리케이션 코드와 버전 관리에 두는 방안을 병행합니다. 한쪽에만 의존하는 구조를 오늘 기본값으로 고정하지 않습니다.

다른 폐기 줄과 티켓을 섞지 않습니다. 오디오 모델 2027년 종료, Agent Builder 2026년 11월 종료 같은 줄은 각자 티켓으로 둡니다. 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 이전이 우선입니다. 마이그레이션 인건비·토큰비·다운타임 숫자는 공식 문서에 없으므로 이 글에서 만들지 않습니다. 같은 페이지의 다른 폐기 줄(오디오 모델, Agent Builder 등)은 별도 티켓으로 둡니다. 저장소에서는 beta.threads와 /v1/assistants·threads·runs 호출을 먼저 찾습니다. 런북 첫 줄에는 공식 deprecations와 migration guide 주소를 넣습니다. 이전 체크리스트와 샘플 호출은 공개 링크로 남깁니다. 그 링크가 제출입니다.

장애 대응 문장도 짧게 고정합니다. Assistants 경로에서 401·404·410류 오류가 보이면, 먼저 deprecations 표의 종료일을 확인합니다. 키 만료나 일시 장애로만 단정하지 않습니다. 종료일이 지났다면 대체 API 이전 티켓을 최상단으로 올립니다. 모니터링 알림 이름에 Assistants를 남겨 두었다면 Responses·Conversations 쪽으로 이름을 바꿉니다. 고객에게 안내할 때는 “예고된 API 종료”와 “임시 장애”를 같은 문장에 쓰지 않습니다.

출처: OpenAI — Deprecations (Assistants API shutdown 2026-08-26) · OpenAI — Assistants migration guide