responses.create() 는 OpenAI 가 권장하는 새 shape 의 API 야. Chat Completions 가 deprecated 된 건 아니지만 — 새 기능은 (built-in tools, semantic streaming, background mode, reasoning controls) 전부 Responses 부터 ship 돼. 새 코드는 Responses 위에서 시작하는 게 맞아.
핵심 차이 셋
- previous_response_id 로 stateful — 매 turn 메시지 배열 다시 보내는 거 아니라, previous_response_id 만 넘기면 서버가 history 를 들고 있어. Stateful by default, 부수적으로 cheaper.
- response.output_text — assistant 의 plain text 를 한 줄로 꺼낼 수 있어.
completion.choices[0].message.content안 걸어도 됨. - instructions= top-level 파라미터 — system-style 지시는 message 안에 넣지 말고 instructions 로 lifted up.
이전 호기 (chat.completions) 는 어떻게?
지금 돌아가는 코드 굳이 안 바꿔도 돼. 새 기능 ship 할 때 같이 옮기는 게 합리적 — 한 파일 손볼 때마다 같이 마이그레이션 하면 세 달 후엔 자연스럽게 끝나 있어.