10월 23일 끝나는 o1·o3-mini·o4-mini — 바꿀 모델과 고칠 코드

OpenAI 가 2026년 4월 22일 「Legacy GPT model snapshots」 공지로 알린 묶음이에요. 원포트에서 부를 수 있는 모델 중에는 아래 여섯이 이날 끝나요. 후속 모델은 모두 지금 원포트에 있고, 부르는 주소는 표의 셋째 칸이에요.

단가는 후속마다 다르게 움직여요. o1 에서 옮기면 내려가지만, o3-mini·o4-mini·gpt-4.1-nano 에서 옮기면 같은 일에 크레딧을 더 사용해요.

OpenAI 는 이날 이 모델들의 접근을 닫아요. 10월 23일이 되면 원포트도 판매 목록에서 내려요. 22일까지 바꿔 두세요.

그 뒤 옛 이름으로 부르면 404 model_not_found 가 나고, 오류 문장에 OpenAI 가 끝낸 날이 같이 적혀요. 원포트는 고른 모델을 다른 모델로 바꿔 답하지 않아요. 후속은 위 표를 보고 직접 넣어 주세요.

base_url 과 키는 그대로 두고 model 값을 바꿔요. 아래는 o3-mini 를 쓰던 코드예요.

/v1/chat/completions 로 부르시면 저희가 max_tokens 를 max_completion_tokens 로 옮기고, 1 이 아닌 temperature·top_p, 0 이 아닌 presence_penalty·frequency_penalty 는 빼서 넘겨요. o 계열에서 하던 그대로라 o 계열에서 옮기면 이 칸들 때문에 몸통을 고칠 일은 없어요.

gpt-4.1-nano 에서 옮기면 달라져요. 지금까지 그대로 넘기던 1 이 아닌 temperature 같은 칸이 이제 빠지고, 도구를 쓰면 아래 400 이 나요. gpt-5.6-luna 는 추론 모델이라 답하기 전에 생각한 토큰도 출력으로 세어져 크레딧을 더 사용해요.

옮긴 칸은 응답 헤더 x-gateway-mapped-params 에, 뺀 칸 이름은 x-gateway-ignored-params 에 적혀요. 바꾼 뒤 한 번 불러서 이 두 헤더를 보면 무엇이 달라졌는지 알 수 있어요.

gpt-image-1 은 /v1/images/generations 에서 model 을 gpt-image-2.5-sunburst 나 gpt-image-2.5-flare 로 바꿔요. 크기·품질 같은 그림 옵션은 바꾼 뒤 한 번 불러 확인해 주세요.

from openai import OpenAI

client = OpenAI(
    api_key="sk-so-...",
    base_url="https://oneport.kr/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",  # 전에는 "o3-mini"
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(response.choices[0].message.content)

저희가 2026년 9월 23일에 재 보니 GPT-5.6 은 /v1/chat/completions 에서 도구와 기본 추론을 같이 보내면 400 이 나요. o 계열·gpt-4.1-nano 에서 도구를 붙여 쓰던 호출이라면 이름만 바꿔서는 막혀요.

추론 없이 도구만 쓰면 되는 일이면 reasoning_effort 를 "none" 으로 같이 보내요. 추론과 도구가 둘 다 필요하면 /v1/responses 로 보내요. 이 주소는 몸통 모양(input · 도구 정의 꼴 · max_output_tokens)이 달라서 코드를 고쳐야 해요.

reasoning_effort 는 GET /v1/models 의 supports_effort 가 true 인 모델이면 low·medium·high 를 받아요. 후속 gpt-5.6 셋은 모두 true 예요. 안 보내면 medium 으로 돌아요(OpenAI 추론 가이드).

공지가 권하는 후속은 gpt-5.6-sol 에 reasoning.mode 를 pro 로 준 것이에요. OpenAI 추론 가이드는 이 모드를 Responses API 에서 준다고 적어요. 그래서 지금처럼 /v1/responses 로, model 을 gpt-5.6-sol 로 바꾸고 reasoning 에 mode 를 넣어 보내요.

원포트의 /v1/responses 는 길이·샘플링 칸을 고치지 않고 넘겨요. 그래서 이 주소에선 길이 칸 이름이 max_output_tokens 이고, 1 이 아닌 temperature 를 보내면 OpenAI 가 400 을 내요. 채팅 주소처럼 저희가 옮기거나 빼 주지 않아요.

pro 모드는 답 하나에 모델이 더 많이 생각해서 오래 걸리고 토큰을 더 써요. 생각한 토큰도 max_output_tokens 안에 들어가서, 값이 작으면 보이는 답 없이 끝날 수 있어요. OpenAI 가이드는 처음엔 25,000 토큰 이상 잡으라고 해요.

오래 걸리는 답은 아래처럼 stream: true 로 받아 주세요. background: true 는 받지 않아요 — 저희 문엔 결과를 나중에 가져가는 길이 없어요. 한 요청은 5분 안에 끝나야 해요.

GET /v1/models 의 retirement 칸에는 o1-pro 후속이 gpt-5.6-sol 로만 적혀요. pro 모드는 몸통에 직접 넣어야 해요. 옮긴 뒤엔 짧은 질문으로 먼저 한 번 불러 답이 오는지 봐 주세요.

curl https://oneport.kr/v1/responses \
  -H "Authorization: Bearer sk-so-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "reasoning": {"mode": "pro"},
    "max_output_tokens": 25000,
    "stream": true,
    "input": "이 마이그레이션 계획에서 실패할 수 있는 곳을 찾아 주세요."
  }'

GET /v1/models 응답에는 모델마다 retirement 칸이 있어요. 벤더 공지 원문에서 옮겨 적은 종료일과 후속이 실려요. 비어 있으면(null) 저희 목록에 아직 날짜가 없다는 뜻이라, 벤더 공지 원문도 같이 봐 주세요.

사람이 읽기 쉬운 쪽은 「바뀐 것」이에요. 새로 들어온 모델과 끝나는 모델을 날짜순으로 모아 두고, 손님께 돌릴 안내 문장도 복사할 수 있어요.

curl https://oneport.kr/v1/models
# 끝나는 날이 정해진 모델: "retirement": {"date": "2026-10-23", "successors": ["gpt-5.6-sol"]}

바꾸기 전에 API 페이지의 「모델별 차감 단가」에서 후속 모델 줄을 봐 주세요. 키에 월 한도를 걸어 두셨다면, 단가가 오르는 후속으로 옮길 때 그 값도 같이 봐 주세요.

원포트 키가 아직 없으면 「원포트 AI API 크레딧」을 사면 바로 키를 만들 수 있어요. 여러 서비스를 한꺼번에 옮겨야 하거나 팀 단위로 키를 나눠야 하면 도입 문의로 알려 주세요.