OpenAI

GPT Image 2.5

gpt-image-2.5-flare

OpenAI의 2단계 이미지 생성 및 편집 모델로, Flare는 속도를, Sunburst는 정밀도를 중시하며 텍스트-이미지 생성과 다중 턴 이미지 수정을 모두 지원합니다

경로

default pro

gpt-image-2.5-flare gpt-image-2.5-sunburst

gpt-image-2.5-flare 사용해 보기

입력

작품 갤러리

모든 작품 보기

출력

image

파라미터를 입력하고 생성하면 결과가 여기에 표시됩니다.

가격

gpt-image-2.5-flare per image

사양	단가
low	$0.0172
medium	$0.0672
high	$0.1829
xhigh	$0.3572
max	$0.7143
auto	$0.3572

포지셔닝 소개

gpt-image-2.5-flare는 OpenAI gpt-image-2.5 이미지 시리즈 중 속도와 품질의 균형에 중점을 둔 버전으로, HiAPI.ai에서 통합 인터페이스를 통해 호출되며 텍스트-이미지 생성과 참조 이미지 기반 이미지 편집을 모두 지원합니다. 안정적인 이미지 생성이 필요한 상업용 비주얼 제작, 콘텐츠 대량 생성 및 이미지 정교화 워크플로에 적합하며, 최대 3840px 해상도, 투명 배경 및 다양한 화면 비율과 형식의 이미지를 출력할 수 있습니다.

핵심 하이라이트

속도 우선이지만 품질 타협 없음——이전 세대 GPT-Image-2 대비 품질을 높이면서 지연을 크게 줄여, 이미지 생성 속도가 중요한 대량 작업에 적합합니다.
텍스트-이미지 생성과 편집이 동일한 라인——동일한 모델이 프롬프트로 처음부터 생성할 수도 있고, 참조 이미지를 전달해 편집, 합성 및 피사체 스타일 유지도 할 수 있습니다.
화면 비율과 해상도 폭넓게 지원——1:1부터 16:9, 9:16 등 다양한 비율과 최대 3840x2160 픽셀 크기까지 직접 출력할 수 있습니다.
투명 배경과 형식 제어 가능——투명 배경과 png, jpeg, webp 출력 형식을 선택할 수 있어 소재를 실제로 활용한 뒤의 2차 처리를 줄입니다.

기능 설명

텍스트-이미지 생성: 설명형 프롬프트로 화면을 생성하며, 긴 구조화 프롬프트와 복잡한 레이아웃 요구를 지원해 텍스트에서 바로 사용 가능한 이미지를 만들어냅니다.

참조 이미지 편집 및 유지: 최대 16장의 참조 이미지를 전달해 편집, 합성 또는 수정 중 피사체와 스타일 유지에 사용할 수 있어 반복적인 파라미터 조정을 줄입니다.

화질 단계 선택: low부터 max 및 auto까지 화질 단계를 제공하며, 개발자는 상황에 따라 생성 속도와 디테일 표현 사이에서 선택할 수 있습니다.

해상도 및 화면 비율 제어: 비율 또는 구체적인 픽셀 크기를 지정할 수 있으며, 1024, 1536, 2048, 3840 등의 단계를 포함하고 auto는 모델이 자체적으로 결정합니다.

출력 형식 및 배경: png, jpeg, webp 세 가지 형식과 자동, 투명, 불투명 배경 설정을 지원해 바로 사용 가능한 소재 파일을 생성합니다.

적용 시나리오

브랜드 및 마케팅 팀의 상업용 이미지——브랜드 비주얼 설명이나 참조 이미지를 입력해 프레젠테이션, 랜딩 페이지 및 광고용 이미지를 생성하고 통합 인터페이스를 통해 소재 라이브러리로 대량 전달합니다.
콘텐츠 크리에이터의 소셜 미디어 이미지 생성——스크립트나 주제에 따라 프롬프트를 대량 제출해 여러 화면 비율의 이미지를 얻어 소셜 미디어 게시 및 콘텐츠 일정에 사용합니다.
이커머스 및 제품 페이지 소재 제작——제품 참조 이미지와 수정 지시를 입력으로 사용해 상황별 전시 이미지를 생성하고 상품 상세 페이지 및 비주얼 검색 소재로 직접 사용합니다.
디자인 워크플로의 반복 정교화——기존 이미지를 기반으로 여러 차례 편집해 피사체와 레이아웃 일관성을 유지하며 프로토타입 검증 및 디자인 시안 반복에 사용합니다.

제한 사항 및 선택 가이드

폐쇄형 모델이므로 로컬 배포나 자체 미세 조정이 불가능하며, 출력은 인터페이스 호출에 의존합니다. 고해상도 이미지 생성은 더 높은 연산 및 시간 비용을 초래하며, 밀집된 작은 글씨 텍스트와 복잡한 도표는 여전히 오류가 발생하기 쉬운 영역이므로 사람의 검수가 필요합니다. 작업이 세부 충실도를 매우 높게 요구하고 더 긴 대기를 감수할 수 있다면 gpt-image-2.5-sunburst가 더 적합하며, 낮은 지연의 일상적 대량 이미지 생성을 추구한다면 이 라인이 기본 선택입니다. 콘텐츠 규정 준수는 해당 사용 정책을 따라야 합니다.

생성 작업 제출

POST https://api.hiapi.ai/v1/tasks

헤더

Authorizationstring필수

계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기

Content-Typestring선택

요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.

Idempotency-Keystring선택

멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.

멱등 키

네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.

본문

modelstring필수

현재 고정 값: gpt-image-2.5-flare

routestring선택

현재 고정 값: pro

inputobject필수

gpt-image-2.5-flare 및 루트 pro의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.

promptstring필수minLength 1maxLength 20000

생성할 화면 내용을 설명하거나, 참조 이미지에 수행해야 할 수정 사항을 설명합니다. 문자열 형식이며 최대 20000자입니다.

qualitystring선택기본값: "medium"

출력 이미지의 디테일 수준, 생성 속도 및 가격 등급을 제어합니다. 문자열 형식이며 기본값은 medium입니다.

옵션:lowmediumhighxhighmaxauto

backgroundstring선택기본값: "auto"

출력 이미지의 배경 모드(자동, 투명 또는 불투명)를 제어합니다. 문자열 형식이며 기본값은 auto입니다.

옵션:autotransparentopaque

image_urlsarray선택minItems 1maxItems 16

선택적 참조 이미지 배열입니다. 전달되면 이미지 편집, 합성 또는 주체와 스타일 유지에 사용되며, 요소는 이미지 주소입니다.

Array [ string ]

aspect_ratiostring선택기본값: "1:1"

출력 화면 비율 또는 픽셀 크기를 제어합니다. 문자열 형식이며 기본값은 1:1입니다. auto로 설정하면 모델이 요청에 따라 자체적으로 결정합니다.

옵션:1:13:22:34:33:416:99:16auto

전체 보기(10개)

1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

output_formatstring선택기본값: "webp"

출력 이미지의 파일 형식을 제어합니다. 문자열 형식이며 기본값은 webp입니다.

옵션:pngjpegwebp

callbackobject선택

종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.

콜백(Webhook)

생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.

urlstring필수

callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.

whenstring선택기본값: "final"

현재는 final만 지원(success / fail 모두 알림).

옵션:final

storagestring선택기본값: "temp"

산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.

옵션:temppersistent

요청 예시

# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.5-flare@pro",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "background": "auto",
    "aspect_ratio": "1:1",
    "output_format": "webp"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2.5-flare@pro",
    input: {
      "prompt": "…",
      "quality": "medium",
      "background": "auto",
      "aspect_ratio": "1:1",
      "output_format": "webp"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2.5-flare@pro",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "background": "auto",
          "aspect_ratio": "1:1",
          "output_format": "webp"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

작업 상세 조회

GET https://api.hiapi.ai/v1/tasks/:id

응답 필드

taskIdstring필수

태스크 ID. 접두사는 항상 tk-hiapi-.

modelstring필수

확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.

routestring선택

route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.

statusstring필수

태스크 상태.

상태 값

queued 대기 중, 아직 시작되지 않음. handling 처리 중. archiving 처리 완료, 산출물 준비 중. success 종료: 완료. 산출물 사용 가능(output 반환). fail 종료: 실패(error 반환). 제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.

creatednumber필수

태스크 생성 시각(Unix 초).

completednumber필수

종료 상태가 된 Unix 초. 비종료 상태에서는 0.

outputarray선택

status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).

Array [ object ]

배열 항목

urlstring필수

산출물 URL. 바로 다운로드할 수 있습니다.

typestring필수

현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.

expireAtnumber필수

산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.

errorobject선택

status == fail일 때만 나타납니다.

codestring필수

비즈니스 오류 코드.

messagestring필수

오류 설명.

응답 예시

성공

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

처리 중(비종료)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

실패

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}