Skip to main content
POST
Text-to-Image: generate at an explicit size from a text prompt
오른쪽의 대화형 Playground는 직접 온라인 테스트를 지원합니다. Authorization 필드에 API 키를 입력하고(형식: Bearer sk-xxx), promptsize를 설정한 뒤 전송하십시오.
범위: 이 페이지는 텍스트-투-이미지 생성용입니다. prompt만 입력하고 size — 이미지 업로드는 필요하지 않습니다. 기존 이미지를 편집하거나 합성하려면 이미지 편집 endpoint를 사용하십시오.gpt-image-2-all와의 차이: 호출 구조는 동일하고, size 필드 하나만 추가됩니다. 차원을 고정할 필요가 없고 가장 빠른 출력을 원하시면 대신 gpt-image-2-all을 사용하십시오.
🖥️ 브라우저 Playground 제한이 endpoint는 기본적으로 base64 문자열(b64_json)을 반환하므로 크기가 몇 MB에 이를 수 있어 브라우저 Playground에 请求时发生错误: unable to complete request가 표시될 수 있습니다 — 요청은 실제로 성공한 것입니다; 브라우저가 그처럼 긴 base64 문자열을 렌더링하지 못할 뿐입니다.권장 작업 흐름: 아래 코드 샘플을 복사해 로컬에서 실행하십시오 — 이미지를 디코딩하여 파일로 자동 저장합니다.
모든 image API는 동기식입니다 — 폴링할 task ID가 없으며, 클라이언트가 연결을 끊으면 요청은 계속 과금되는 동안 결과는 유실됩니다. 이 모델에는 넉넉한 timeout을 설정하십시오. Image API Essentials & Best Practices를 참조하십시오.
⚠️ 주요 매개변수 참고사항
  • size: 모델이 선택하게 하려면 auto를 전달하십시오(vip는 주어진 prompt에 대해 상대적으로 고정적/안정적인 크기로 수렴하는 경향이 있습니다). 또는 엄격하게 고정하려면 지원되는 30개 크기 중 하나(10개 비율 × 1K 빠름 / 2K 권장 / 4K 상세 — 개요 페이지의 전체 크기 표 참조)를 선택하십시오. 소문자 ASCII x를 사용하십시오. 예: 2048x1360, 3840x2160 — 절대 ×나 대문자 X는 사용하지 마십시오.
  • quality: ❌ 거부됨 — 전달하지 마십시오.
  • n: ❌ 거부됨 — 호출당 이미지 1장만 지원합니다. n=3를 보내면 3배가 과금되지만 여전히 이미지 1장만 반환합니다. 필드를 제거하십시오.
  • aspect_ratio: ❌ 거부됨 — 비율은 size에 의해 결정됩니다.
  • response_format: 생략하면 base64(원시, prefix 없음, 2026-07 검증)를 반환합니다. 이미지 URL을 받으려면 "url"를 전달하십시오. URL 출력에 의존하는 비즈니스는 base64 대체 없이 결정적인 URL 출력을 위해 token을 image2_OSS 그룹으로 전환해야 합니다.

코드 예제

Python

4K 디테일 티어 예시(배경화면 / 인쇄용):

cURL

Node.js

OpenAI SDK (Python, 권장)

매개변수

크기 치트시트 — 다음 항목들이 대부분의 경우를 포함합니다:
  • 이커머스 히어로 샷: 2048x1360 (3:2 2K) / 2048x2048 (1:1 2K)
  • 세로 포스터: 1536x2048 (3:4 2K) / 2480x3312 (3:4 4K)
  • 동영상 썸네일: 2048x1152 (16:9 2K) / 3840x2160 (16:9 4K)
  • 스토리 / 휴대폰 배경화면: 1152x2048 (9:16 2K) / 2160x3840 (9:16 4K)
전체 30개 크기 표: 개요 페이지.

응답 형식

기본값으로 base64를 반환합니다 (data[0].b64_json, 접두사 없는 raw base64, 2026-07 검증됨). 대신 이미지 URL을 받으려면 response_format: "url"을 명시적으로 전달하십시오. URL 출력에 의존하는 비즈니스는 안정적인 URL 출력을 위해 base64 대체 없이 token의 그룹을 **image2_OSS**로 변경해야 합니다. data[0]url 또는 b64_json 중 하나만 반환합니다 — 둘 다는 아닙니다. b64_json 모드 (기본값):
url 모드 (response_format: "url"을 명시적으로 전달하십시오; URL에 의존한다면 image2_OSS 그룹을 사용하십시오 — R2 CDN이 전역으로 가속됩니다):
호환성 참고: 2026년 7월 검증됨 — b64_json 필드는 data: 접두사가 없는 raw base64입니다. 파일에 쓰려면 디코딩하고, 렌더링하기 전에 직접 접두사를 붙이십시오. 이전 버전에는 접두사가 포함되어 있었습니다, 따라서 두 형태를 모두 처리하려면 항상 먼저 startsWith('data:') 검사를 실행하십시오.

관련 리소스

모델 개요 (전체 크기 표)

전체 30개 크기 표, 과금, 기술 사양

이미지 편집 API

/v1/images/edits 다중 이미지 융합 및 편집

자매 모델 gpt-image-2-all

고정 크기가 필요하지 않을 때는 동일한 호출 형식 — 더 빠른 출력(~30–60초)

인증

Authorization
string
header
필수

API Key from the API易 Console

본문

application/json
model
enum<string>
기본값:gpt-image-2-vip
필수

Model name, fixed to gpt-image-2-vip

사용 가능한 옵션:
gpt-image-2-vip
prompt
string
필수

Prompt — describe content, style, lighting, etc.

예시:

"Cinematic landscape, old lighthouse by the sea at dusk, photorealistic"

size
enum<string>

Output size. Pass auto to let the model decide (vip tends to converge on a relatively fixed size for a given prompt), or pick one of the 30 supported sizes (10 ratios × 1K Fast / 2K Recommended / 4K Detail) to lock it strictly. Format: WIDTHxHEIGHT with lowercase ASCII x, e.g., 2048x1360, 3840x2160. Flat $0.03/image across all tiers.

사용 가능한 옵션:
auto,
1280x1280,
848x1280,
1280x848,
960x1280,
1280x960,
1024x1280,
1280x1024,
720x1280,
1280x720,
1280x544,
2048x2048,
1360x2048,
2048x1360,
1536x2048,
2048x1536,
1632x2048,
2048x1632,
1152x2048,
2048x1152,
2048x864,
2880x2880,
2336x3520,
3520x2336,
2480x3312,
3312x2480,
2560x3216,
3216x2560,
2160x3840,
3840x2160,
3840x1632
예시:

"2048x1152"

응답

Image successfully generated. Defaults to base64 in data[0].b64_jsonurl is not returned in the same response.

Image generation response. Returns base64 by default (data[0].b64_json); to get a url, switch to the image2_OSS group with response_format=url. data[0] returns either url or b64_json, never both.

data
object[]

Result array (this model returns 1 image per call)

created
integer

Unix timestamp (seconds)

usage
object

Token usage statistics