텍스트로 이미지 생성
텍스트 프롬프트로 이미지를 생성합니다.
코드를 작성하지 않으신다면 내 도구에서 이미지 생성을 참고하십시오.
시작하기 전에
코드에 사용되는 값
API 주소
https://api.ofox.ai/v1모델 ID
openai/gpt-image-2.5-flareAPI 키코드의 YOUR_OFOX_API_KEY를 본인의 키로 바꿔 넣으십시오
Python 의존성
pip install openai코드
아래 예시는 모두 그대로 실행하여 확인했습니다. 결과는 현재 디렉터리에 output.png로 저장됩니다.
cURL
Terminal
curl -s https://api.ofox.ai/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)
- 크기
size: 너비와 높이 모두 16의 배수, 긴 변 ≤ 3840, 종횡비 1:3에서 3:1 사이, 총 픽셀 수 ≥ 655,360.768x768은 실패하고1024x768은 동작합니다. 생략하면 모델이 정하며, 실측에서는 1254×1254였습니다. 크기를 참고하십시오. - 품질
quality: 먼저low로 동작을 확인한 뒤 높이십시오. 생략하는 것은medium과 같지 않으며, 모델이 등급을 스스로 고릅니다.gpt-image-2에는xhigh와max가 없습니다. 등급별 사용량은 품질을 참고하십시오.
파라미터 값
이 시리즈에서 허용되는 값과 실측 기본값입니다. size와 quality는 개요 페이지의 크기와 품질을 참고하십시오.
필수
대소문자를 구분하며, 대소문자가 틀리면 404를 반환합니다. openai/ 접두사를 포함한 전체 ID를 입력하십시오.
자주 사용
장마다 별도로 청구됩니다. 10을 넘으면 400을 반환합니다.
세 가지 모두 동작을 실측으로 확인했습니다.
▶고급 · 4output_compression · background · moderation · partial_imagesExpand
jpeg와 webp에만 적용됩니다.
투명 배경에는 png 또는 webp가 필요합니다. jpeg는 투명도를 지원하지 않습니다.
콘텐츠 심사의 엄격도입니다.
stream: true와 함께 사용합니다. 생성 중에 보낼 중간 이미지의 수입니다.
자주 발생하는 오류
그 밖의 오류는 전체 오류 표를 참고하십시오.
공식 문서
OpenAI 문서는 OpenAI를 직접 호출할 때의 동작을 설명합니다. OfoxAI를 통해 호출할 때는 이 시리즈 문서의 실측 결과가 우선합니다. 예를 들어 편집 시 공급자를 지정할 필요가 없습니다.
Last updated on