텍스트-이미지 API 참조

GPT-Image 시리즈 텍스트-이미지 인터페이스 참조. 개요 및 모델 선택은 GPT-Image 이미지 생성을 참고하세요.

요청

POST https://api.4allapi.com/v1/images/generations

{
  "model": "gpt-image-2",
  "prompt": "극미니멀 스타일의 커피 브랜드 포스터, 크림색 배경, 화면 중앙에 라떼 한 잔",
  "n": 1
}

파라미터	필수	설명
model	✔	모델명; 화면 비율/해상도/속도는 접미사로 선택(-fast、-portrait、-2k、-4k 등)
prompt	✔	이미지 설명, 한국어·영어 및 복합 지시 지원
n		생성 장수, 기본값 1; 대량 생성 시 큰 n보다 여러 번 요청 권장
response_format		url(기본값) 또는 b64_json

응답

{
  "created": 1735900000,
  "data": [
    { "url": "https://…/xxx.png" }
  ]
}

• response_format: "b64_json" 설정 시 b64_json 필드가 반환되며, 응답 본문이 커질 수 있으니 주의;
• URL은 유효 기간이 있으므로 받는 즉시 저장하세요. 압축 및 출력 해상도를 참고하세요.

Python 예시

resp = client.images.generate(
    model="gpt-image-2-portrait-2k",
    prompt="도쿄 비 오는 밤 거리, 네온 반사, 영화적 감성",
)
print(resp.data[0].url)

과금 및 실패 처리

• 건당 과금: 성공한 이미지 한 장당 한 번 차감, 실패 시 차감 없음;
• 타임아웃 및 연결 끊김 처리는 연결 중단 문제 해결을 참고;
• 이미지 편집은 이미지 편집 API를 참고.