사용 가이드

GPT Image API 가이드: 모델 ID, 라우팅 및 마이그레이션

장기적으로 유효한 지도: 기존 OpenAI 이미지 이름에서 GPT Image 2까지, 현재 HiAPI 모델 ID, 은퇴한 Pro 대체안, 그리고 각 다음 단계에서 어느 페이지를 봐야 하는지를 다룹니다.

Jun 24, 2026

간단한 답변

새로운 OpenAI 직접 연결 이미지 통합의 경우 현재 모델 ID는 gpt-image-2입니다. 새로운 HiAPI 통합의 경우 작업이 프롬프트에서 시작하면 gpt-image-2/text-to-image를, 작업이 하나 이상의 참조 이미지에서 시작하면 gpt-image-2/image-to-image를 사용하세요.

이 이름들은 혼동하기 쉽습니다. 사람들이 "GPT-4o image", "ChatGPT image generation", "GPT Image API", "GPT Image 2"로 관련은 있지만 서로 다른 제품 인터페이스를 가리키기 때문입니다. 안전한 방법은 먼저 어떤 API를 호출할지 확인한 다음, 그 API에 해당하는 모델 ID와 요청 계약을 사용하는 것입니다.

인터페이스	현재 모델 또는 선택기	요청 모드
OpenAI Image API	`gpt-image-2`	OpenAI `/v1/images/generations` 또는 `/v1/images/edits`
OpenAI Responses API	지원되는 주력 모델과 이미지 생성 도구	`/v1/responses`를 통한 대화형 또는 다단계 이미지 작업
HiAPI 텍스트→이미지	`gpt-image-2/text-to-image`	`POST https://api.hiapi.ai/v1/tasks`
HiAPI 이미지→이미지	`gpt-image-2/image-to-image`	`POST https://api.hiapi.ai/v1/tasks`

HiAPI는 OpenAI Image API의 요청 본문을 프록시하지 않습니다. 통합된 비동기 작업 계약을 통해 GPT Image 라우트를 제공하므로, 호스트 이름만 바꾸는 것으로는 마이그레이션이 완료되지 않습니다.

개발자가 알아야 할 GPT Image 계보

유용한 계보는 실행 가능한 마이그레이션 지도입니다. 아래 이름들이 모두 상호 교환 가능한 API 모델을 가리키는 것은 아닙니다.

기존 코드나 검색 결과에서 볼 수 있는 이름	현재 상태	지금 해야 할 일
"GPT-4o image generation" 또는 "ChatGPT image generation"	제품 인터페이스 또는 UI 표현이며, 새 이미지 요청에 붙여 넣을 수 있는 현재 이미지 모델 ID가 아님	먼저 API 인터페이스를 선택한 다음, 해당 인터페이스의 현재 모델과 요청 계약을 사용
`chatgpt-4o-latest`	폐기된 ChatGPT 모델 별칭. OpenAI 현재 모델 페이지는 이미지 입력을 나열하며 이미지 출력은 아님	이미지 생성의 마이그레이션 대상으로 사용하지 마세요
`gpt-image-1`	OpenAI가 이전 세대의 폐기된 이미지 생성 모델로 표시	새 이미지 작업을 `gpt-image-2`로 마이그레이션
`gpt-image-1.5`	OpenAI가 이전 세대의 폐기된 이미지 생성 모델로 표시	새 이미지 작업을 `gpt-image-2`로 마이그레이션
`dall-e-2` 또는 `dall-e-3`	폐기되어 OpenAI API에서 제거됨	OpenAI는 현재 생성 및 편집에 `gpt-image-2` 사용을 권장
`gpt-image-2`	OpenAI의 현재 직접 연결 이미지 모델 ID	OpenAI Image API와 함께 사용하거나, 작업을 아래의 HiAPI 슬래시 ID로 매핑

OpenAI의 현재 문서는 gpt-image-2를 가장 진보된 이미지 생성 모델로 설명하며 텍스트→이미지 생성과 이미지 편집을 다룹니다. OpenAI 이미지 생성 가이드는 또한 일회성 Image API와 Responses API를 통한 대화형 이미지 생성을 구분합니다. 위 모델 상태 설명은 다음 공식 페이지에서 가져왔습니다: GPT Image 2, GPT Image 1.5, GPT Image 1, DALL-E 2, DALL-E 3, ChatGPT-4o. 확인 날짜는 2026년 8월 31일입니다.

UI 워크플로에서 API 워크플로로 전환

ChatGPT 이미지 세션은 모델 선택, 상태, 재시도, 파일 처리를 대화 뒤에 숨깁니다. API 통합은 이러한 결정을 명시적으로 내려야 합니다.

OpenAI 공식 가이드는 단일 생성 또는 편집에는 Image API를, 대화형 다중 턴 이미지 작업에는 Responses API를 사용할 것을 권장합니다. HiAPI는 세 번째 계약을 사용합니다. 모든 이미지 작업이 하나의 비동기 작업입니다. 백엔드가 작업을 제출하고 반환된 taskId를 저장하며, 콜백이나 나중의 작업 상세 요청을 통해 최종 결과를 받습니다.

UI 세션에서 만든 창의적 브리프는 여전히 유용한 시작 프롬프트이지만, API의 실제 요청 스키마로 옮기고 출력을 테스트해야 합니다. UI 제품 이름을 model 필드에 복사해 넣고 그것이 안정적인 API ID라고 가정하지 마세요.

HiAPI의 경우 API key를 서버에 보관하고 다음과 같이 작업을 제출하세요:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A clean launch poster with the exact headline SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

callback 객체는 model 및 input과 나란히 최상위에 있어야 합니다. 로컬 디버깅이나 대조 확인을 위해서는 GET https://api.hiapi.ai/v1/tasks/{taskId}를 폴링하세요. 작업이 성공하면 data.output[].url에서 이미지를 다운로드하고, 임시 출력 URL을 영구 저장소로 취급하지 마세요.

이 허브 페이지는 의도적으로 요청 하나만 보여줍니다. 라우트별 필드, 콜백, 폴링, 복사해 붙여넣을 수 있는 예시는 텍스트→이미지 API 문서 또는 이미지→이미지 API 문서를 참고하세요.

기존 OpenAI 이미지 호출을 HiAPI로 마이그레이션

OpenAI 모델 마이그레이션과 제공자 계약 마이그레이션은 두 가지 별개의 변경입니다. 먼저 현재 이미지 작업을 선택한 다음 HiAPI의 작업 API에 맞게 요청을 다시 작성하세요.

기존 입력	현재 OpenAI 직접 연결 대상	현재 HiAPI 대상
`gpt-image-1`, `gpt-image-1.5` 또는 DALL-E ID를 사용한 텍스트→이미지	`gpt-image-2` 생성	`gpt-image-2/text-to-image`
`gpt-image-1` 또는 `gpt-image-1.5`를 사용한 이미지 편집	`gpt-image-2` 편집	`gpt-image-2/image-to-image`
UI 전용 ChatGPT 또는 GPT-4o 이미지 워크플로	상호작용 설계에 따라 OpenAI Image API 또는 Responses API 선택	HiAPI 텍스트→이미지 또는 이미지→이미지 작업 라우트 선택

HiAPI로 마이그레이션할 때는 동기 또는 OpenAI 특유의 응답 처리를 taskId 영속화, 종료 상태 처리, 출력 다운로드로 대체하세요. 프롬프트와 출력을 다시 검증하고, 인터페이스 간 결과가 픽셀 단위로 동일하다고 약속하지 마세요.

기존 HiAPI 모델 이름 마이그레이션

HiAPI는 이제 작업별 슬래시 ID와 최상위 라우트 선택기를 사용합니다. 새 코드는 아래의 표준 요청 형태를 사용해야 합니다.

기존 HiAPI 이름	현재 요청
`gpt-image-2`	`model: "gpt-image-2/text-to-image"`
`gpt-image-2-image-to-image`	`model: "gpt-image-2/image-to-image"`
`gpt-image-2-beta`	`model: "gpt-image-2/text-to-image"`에 `route: "beta"` 추가
`gpt-image-2-ext`	`model: "gpt-image-2/text-to-image"`에 `route: "ext"` 추가
`gpt-image-2-i2i-ext`	`model: "gpt-image-2/image-to-image"`에 `route: "ext"` 추가

공개 가격 데이터는 라우트가 포함된 항목을 gpt-image-2/text-to-image@ext 또는 gpt-image-2/image-to-image@ext로 표기할 수 있습니다. HiAPI는 라우트 한정 형식도 허용하지만, 모델 문서는 기본 슬래시 ID에 최상위 route 필드를 추가하는 방식을 사용합니다. 이렇게 하면 라우트별 입력 스키마를 더 쉽게 볼 수 있기 때문입니다.

은퇴한 HiAPI Pro ID 대체

HiAPI는 2026년 7월 2일에 두 개의 기존 Pro ID를 은퇴시켰습니다. 이들은 더 이상 현재 공개 가격 데이터에 나타나지 않으며 새 예시에 남겨두어서도 안 됩니다.

은퇴한 ID	대체안
`gpt-image-2-pro`	`gpt-image-2/text-to-image`
`gpt-image-2-image-to-image-pro`	`gpt-image-2/image-to-image`

이번 모델 마이그레이션이 기존 Pro의 모든 파라미터가 완전히 동일한 효과를 낸다고 보장하지는 않습니다. 해당 모델 문서에서 현재 라우트 스키마를 확인한 다음, 프로덕션 전환 전에 대표적인 프롬프트와 참조 이미지 테스트를 실행하세요.

다음 단계로 볼 곳

이 페이지는 이름, 계보, 마이그레이션을 다룹니다. 답하려는 질문에 따라 적절한 목적지를 선택하세요:

시작과 통합

GPT Image 2 모델 페이지에서 현재 모델과 Playground를 확인하세요.
GPT Image 2 이미지→이미지 모델 페이지에서 Playground의 참조 이미지 편집을 확인하세요.
GPT Image 2 텍스트→이미지 문서에서 standard, beta, ext 요청 필드를 확인하세요.
GPT Image 2 이미지→이미지 문서에서 참조 이미지 명명 차이를 포함한 standard 및 ext 편집 필드를 확인하세요.
GPT Image 2 API 가격에서 현재 라우트 표, 참조 이미지 추가 항목, 예산 계산을 확인하세요.
HiAPI 실시간 가격에서 전체 현재 모델 카탈로그를 확인하세요.

사용 사례와 실측 증거

비교와 선택

자주 묻는 질문

현재 GPT Image API 모델 ID는 무엇인가요?

OpenAI의 직접 연결 Image API의 경우 gpt-image-2입니다. HiAPI의 경우 작업이 텍스트에서 시작하는지 참조 이미지에서 시작하는지에 따라 gpt-image-2/text-to-image 또는 gpt-image-2/image-to-image를 사용하세요.

HiAPI에 순수 모델 이름 `gpt-image-2`를 보낼 수 있나요?

새 HiAPI 코드에서는 순수 이름을 사용하지 마세요. 현재 표준 ID는 위에 제시된 작업별 슬래시 이름이며, 이들은 가격, 스키마, 모델 페이지 라우팅을 더 명확하게 만듭니다.

HiAPI는 OpenAI의 `/v1/images/generations` 엔드포인트를 사용하나요?

아니요. HiAPI 이미지 모델은 POST /v1/tasks를 사용하고, 이후 최종 콜백 또는 GET /v1/tasks/{taskId}로 결과를 가져옵니다. OpenAI Image API와 HiAPI 작업 API의 요청 및 응답 계약은 다릅니다.

콜백은 어디에 두어야 하나요?

callback을 model 및 input과 나란히 작업 본문 최상위에 두세요. callback.when: "final"을 사용하고, 성공과 실패 모두 종료 상태 결과이므로 수신 서비스가 taskId 기준으로 멱등성을 유지하도록 하세요.

`gpt-image-2-pro`를 무엇으로 대체하나요?

gpt-image-2/text-to-image를 사용하세요. 은퇴한 이미지→이미지 Pro ID의 경우 gpt-image-2/image-to-image를 사용하세요. 전환 전에 현재 입력 스키마를 확인하고 대표적인 작업을 테스트하세요.

태그이미지 API 마이그레이션

모든 아티클 보기 →