Skip to Content
모델 사용법GPT Image텍스트로 이미지 생성

텍스트로 이미지 생성

텍스트 프롬프트로 이미지를 생성합니다.

코드를 작성하지 않으신다면 내 도구에서 이미지 생성을 참고하십시오.

POST/v1/images/generations공통 파라미터 체험하기

시작하기 전에

필요한 것설명
API 키OfoxAI 콘솔 에서 생성한 뒤 코드의 YOUR_OFOX_API_KEY를 바꿔 넣으십시오
실행 환경cURL은 이미지 디코딩에 jq가 필요합니다. Python은 pip install openai가 필요합니다. Node.js는 18 이상이면 되며 의존성이 없습니다
타임아웃클라이언트 타임아웃을 600초로 설정하십시오. 고품질, 큰 크기, 편집은 몇 분이 걸릴 수 있습니다
코드에 사용되는 값
API 주소https://api.ofox.io/v1
모델 IDopenai/gpt-image-2.5-flare
API 키코드의 YOUR_OFOX_API_KEY를 본인의 키로 바꿔 넣으십시오
Python 의존성pip install openai

코드

아래 예시는 모두 그대로 실행하여 확인했습니다. 결과는 현재 디렉터리에 output.png로 저장됩니다.

Terminal
curl -s https://api.ofox.io/v1/images/generations \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2.5-flare", "prompt": "A red apple on a white table, soft natural light", "size": "1024x1024", "quality": "low" }' \ -o response.json # 이미지는 base64로 반환됩니다. 디코딩하여 저장합니다(jq 필요, 오류 시 response.json을 확인하십시오) jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

자주 바꾸는 설정

위 요청에서 파라미터 하나만 바꾸면 됩니다.

원하는 결과바꿀 파라미터참고
다른 크기size사용자 지정 크기는 네 가지 규칙을 만족해야 합니다
더 좋은 품질quality등급이 높을수록 비용이 늘고 시간도 오래 걸립니다. 품질 참고
더 작은 파일output_format, output_compressionjpeg 또는 webp로 바꾼 뒤 압축률을 지정하십시오
여러 장 생성n1–10, 장마다 별도로 청구됩니다

크기(size)와 품질(quality)

  • 크기 size: 너비와 높이 모두 16의 배수, 긴 변 ≤ 3840, 종횡비 1:3에서 3:1 사이, 총 픽셀 수 ≥ 655,360. 768x768은 실패하고 1024x768은 동작합니다. 생략하면 모델이 정하며, 실측에서는 1254×1254였습니다. 크기를 참고하십시오.
  • 품질 quality: 먼저 low로 동작을 확인한 뒤 높이십시오. 생략하는 것은 medium과 같지 않으며, 모델이 등급을 스스로 고릅니다. gpt-image-2에는 xhigh와 max가 없습니다. 등급별 사용량은 품질을 참고하십시오.

파라미터 값

이 시리즈에서 허용되는 값과 실측 기본값입니다. size와 quality는 개요 페이지의 크기와 품질을 참고하십시오.

필수
model필수string· 허용 값openai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

대소문자를 구분하며, 대소문자가 틀리면 404를 반환합니다. openai/ 접두사를 포함한 전체 ID를 입력하십시오.

자주 사용
ninteger· 기본값 1· 허용 값1–10

장마다 별도로 청구됩니다. 10을 넘으면 400을 반환합니다.

output_formatstring· 기본값 png· 허용 값pngjpegwebp

세 가지 모두 동작을 실측으로 확인했습니다.

▶고급 · 4output_compression · background · moderation · partial_imagesExpand
output_compressioninteger· 허용 값0–100

jpeg와 webp에만 적용됩니다.

backgroundstring· 기본값 opaque· 허용 값opaquetransparentauto

투명 배경에는 png 또는 webp가 필요합니다. jpeg는 투명도를 지원하지 않습니다.

moderationstring· 허용 값autolow

콘텐츠 심사의 엄격도입니다.

partial_imagesinteger· 허용 값0–3

stream: true와 함께 사용합니다. 생성 중에 보낼 중간 이미지의 수입니다.

자주 발생하는 오류

오류원인해결 방법
moderation_blocked프롬프트가 상위 안전 시스템에 의해 차단되었습니다프롬프트를 바꿔 다시 시도하십시오. 그대로 재시도하면 결과가 같습니다
Transparent background is not supported for JPEG output formatjpeg에 투명 배경을 요청했습니다png 또는 webp를 사용하십시오
404 model_not_found모델 ID의 철자나 대소문자가 잘못되었습니다이 페이지에서 모델 ID를 복사하십시오
Invalid size크기가 위의 네 가지 규칙 중 하나를 어겼습니다크기와 품질의 설명에 따라 조정하십시오
does not support quality 'xhigh'gpt-image-2에 xhigh 또는 max를 보냈습니다high를 사용하거나 2.5로 전환하십시오
Invalid value: 'standard'quality를 standard 또는 hd로 지정했습니다low부터 max까지의 값을 사용하십시오
429 rate_limit_exceeded분당 100회를 초과했습니다(팀 단위)잠시 후 다시 시도하십시오

그 밖의 오류는 전체 오류 표를 참고하십시오.

공식 문서

OpenAI 문서는 OpenAI를 직접 호출할 때의 동작을 설명합니다. OfoxAI를 통해 호출할 때는 이 시리즈 문서의 실측 결과가 우선합니다. 예를 들어 편집 시 공급자를 지정할 필요가 없습니다.

Last updated on