AI API 종료 전 migration audit를 완료하는 방법
Dependencies, control requests, tool calls, streaming, errors, 이전·신규 path 비교, cutover와 rollback을 포함한 audit 계획입니다.
Model 이름이나 Base URL 변경만으로 migration은 끝나지 않습니다. 공식 source, 확인 날짜, 이전·대체 endpoint/model, shutdown date와 owner를 기록합니다. 날짜가 없으면 unknown으로 둡니다.
Protocol, payload, tools, streaming, errors, prompts, SDK, services, cron, workflows, CI, secret 이름을 inventory에 넣습니다. 개인정보를 제거한 text, JSON, tool call, no-tool, stream, 4xx, transient failure case를 만들고 문구가 아닌 schema, arguments, result, stream 종료, retry를 비교합니다.
같은 fixtures로 이전과 신규 path를 실행합니다. BetterToken transport 확인은 공식 가이드에 따라 https://www.bettertoken.ai/v1/chat/completions, Bearer Key, 현재 Model ID를 사용합니다. 이는 model equivalence 증명이 아닙니다.
Cutover에는 feature flag, owner, 관찰 기간, metrics와 rollback 조건이 필요합니다. 두 contract를 지원하도록 deploy하고 controlled traffic부터 시작해 criteria 통과 시만 확대하며 invariant 위반 시 되돌립니다. Shutdown 이후에는 이전 API로 rollback할 수 없습니다.
Source/date, owner가 있는 inventory, versioned tests와 dual run, 차이별 decision, 측정 가능한 cutover/rollback runbook의 다섯 artifact가 필요합니다. HTTP 200 하나면 여전히 migration_in_progress입니다.
2026-08-25 확인: https://developers.openai.com/api/docs/deprecations, https://docs.bettertoken.ai/api-reference/chat-completions