메인 콘텐츠로 건너뛰기
POST
GPT-Image-2.6 · 텍스트-이미지

소개

GPT-Image-2.6은 빠른 반복 작업을 위한 Flare와 정밀한 시각 작업을 위한 Sunburst로 구성된 OpenAI 이미지 모델 시리즈입니다. POST /v1/images/generations를 사용해 텍스트 설명으로 포스터, 상품 이미지, 브랜드 일러스트, 아이콘 및 인포그래픽을 생성할 수 있습니다. 두 모델은 PNG, JPEG, WebP 정적 이미지뿐 아니라 GIF 애니메이션과 SVG 벡터 출력도 지원합니다. 사용 가능 여부는 프로젝트 권한과 채널에 따라 다릅니다. GIF는 반복 동작에, SVG는 크기 조절이나 경로·색상 편집이 필요한 아이콘 및 일러스트에 적합합니다. quality는 렌더링 품질을, 별개의 complexity는 렌더링 전 계획 수준을 제어합니다. 크기와 배경을 설정한 뒤 텍스트, 레이아웃 및 세부 표현을 확인하며 조정하세요. 응답 속도가 우선이면 Flare, 복잡한 구성과 세부 표현이 중요하면 Sunburst를 선택할 수 있습니다.

모델 선택

두 모델은 이 페이지의 엔드포인트, 매개변수 및 응답 구조를 공유합니다. 예시는 Flare를 사용하며 model만 바꾸면 Sunburst로 전환할 수 있습니다. 나머지 필드는 작업에 맞게 설정하세요.

인증

string
필수
Bearer $GRAVITEX_API_KEY
string
필수
application/json

요청 매개변수

요청 예시

예시는 터미널 환경 변수 GRAVITEX_API_KEY에서 플랫폼 토큰을 읽습니다. 업로드 시 curl -F가 Content-Type과 boundary를 자동 생성하므로 multipart/form-data 헤더를 직접 고정하지 마세요.

기본 생성

GIF 애니메이션

SVG 출력

이 채널에서 SVG 생성 시 svg.model이 필수이며 생략하면 missing_required_parameter를 반환합니다. gpt-6.1-sol과 reasoning.effort=low는 2026-11-09 테스트에 성공했습니다. 다른 작성 모델은 채널 지원 여부를 확인하세요.

SVG 작성 모델 지정

예시는 2026-11-09 이 채널에서 SVG 작성에 성공한 gpt-6.1-sol을 사용합니다. 다른 채널이나 프로젝트에서는 사용 가능한 작성 모델로 바꾸세요.

필드 설명

2.6 이미지 모델을 SVG 작성 모델 대신 지정하지 마세요. 사용 가능한 작성 모델과 effort 값은 프로젝트와 선택한 모델에 따라 다릅니다.
data[0].b64_json을 디코딩하여 .svg로 저장합니다. 참조 이미지 usage와 작성 모델 svg_usage는 각각 해당 모델 요금으로 과금됩니다. user는 호환성용이며 더 이상 권장되지 않습니다. safety_identifier가 비어 있지 않으면 우선 사용하고 없거나 비어 있으면 user로 대체합니다.

스트리밍

제한 및 참고 사항

GIF size는 프레임별 크기입니다. 프레임 수, n 및 모델 픽셀 예산을 함께 고려하며 auto를 우선 사용하세요. GIF는 미리보기 접근 권한이 필요합니다. mask, stream, partial_images, 사용자 지정 output_compression은 지원하지 않습니다. 프레임 수, 크기와 n은 요청 픽셀 예산을 공유하므로 초과 시 줄이거나 size=auto를 사용하세요. SVG는 생성 엔드포인트에서만 사용하며 프로젝트 접근 권한이 필요합니다. n=1로 설정하고 stream, partial_images, output_compression, prompt_rewriter를 생략하세요. 이 채널은 svg.model이 필수입니다. complexity는 별도 수수료가 없지만 지연과 결과에 영향을 줄 수 있습니다. 낮은 complexity가 고정 응답 시간이나 이미지별 비용을 보장하지는 않습니다.

응답 예시

다음은 비스트리밍 응답 구조 예시입니다. 이미지 데이터와 토큰 수는 실제 생성 결과가 아닙니다. b64_json을 디코딩하여 해당 형식으로 저장하고 Base64 텍스트를 이미지 파일로 직접 저장하지 마세요.
stream=true는 SSE 이벤트로 미리보기와 최종 이미지를 읽습니다. 전체 응답을 단일 JSON 객체로 파싱하지 마세요.

응답 및 과금

비스트리밍 예시는 b64_json으로 이미지를 반환합니다. response_format=url로 이미지 링크를 기대하지 마세요. 같은 토큰 단가가 이미지당 같은 비용을 뜻하지 않으므로 실제 usage를 확인하세요. data[].b64_json을 디코딩하여 선택한 형식으로 저장합니다. usage는 토큰 사용량입니다. SVG는 별도 과금되는 작성 모델의 svg_usage도 반환할 수 있습니다. 아래는 OpenAI 표준 가격이며 GravitexAI 요금은 콘솔 기준입니다.

공식 참고 문서