gpt-image-2 API

정확한 모델 ID gpt-image-2를 사용하세요. 모델 필드는 이 페이지와 정확히 일치해야 합니다.

샘플 출력gpt-image-2POST /v1/images/generations

매개변수: size=1536x1024n=1

프롬프트: A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.

이 샘플을 생성한 요청

{
  "model": "gpt-image-2",
  "prompt": "A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.",
  "n": 1,
  "size": "1536x1024"
}

인증 및 엔드포인트

https://modelflare.dev/v1과 함께 Modelflare API 키를 사용합니다. 게이트웨이 진입점은 POST /v1/images/generations입니다.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

이미지 생성

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

요청 메모

OpenAI 호환 이미지 모델은 prompt, n, size 및 quality를 사용합니다. 공식 페이지에 문서화되어 있는 경우에만 편집을 사용하세요.

요청 매개변수

GPT Image은 OpenAI 호환 이미지 API를 사용합니다. 생성은 JSON을 사용합니다. 편집 및 마스크 안내 편집은 멀티파트를 사용합니다. GPT Image 2는 data[].b64_json에 Base64 이미지 데이터를 반환합니다.

필드	필수	노트
model	예	gpt-image-2
prompt	예	생성 또는 편집 지시
size	아니요	auto 또는 사용자 정의 WIDTHxHEIGHT
quality	아니요	low / medium / high / auto; 기본 auto
background	아니요	auto / opaque / transparent; 투명한 배경에는 PNG 또는 WebP 출력이 필요합니다.
output_format	아니요	png / jpeg / webp
output_compression	아니요	JPEG/WebP의 경우 0–100, 기본값은 100; PNG의 경우 무시됨
moderation	아니요	auto / low; 기본 auto
n	아니요	1~10개 출력; 기본값 1

응답 및 입력 제한

사용자 정의 크기는 두 가장자리가 모두 16의 배수, 1:33:1 종횡비, 최대 가장자리 3,840픽셀, 총 픽셀 655,3608,294,400이어야 합니다. 편집에는 최대 16개의 소스 이미지가 허용되며 각 소스와 마스크의 크기는 50MB 미만입니다. DALL·E 전용 response_format을 보내지 마십시오.

이미지 편집

GPT Image 2개의 편집은 멀티파트 image/image[]와 함께 /v1/images/edits을 사용합니다. 최대 16개의 입력 이미지가 허용되며 마스크는 첫 번째 이미지의 형식 및 크기와 일치해야 합니다.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=保持主体不变，将背景替换为暖色摄影棚渐变" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "output_format=png" \
  -F "n=1"

오류 및 실패한 작업

잘못된 모델 매개변수는 요청 ID와 함께 4xx를 반환합니다. 선택한 모델 계약에 정의된 응답 필드 및 오류 메시지를 사용합니다.

지원 범위

이 페이지에서는 Modelflare 모델 생성 및 편집 호출을 다룹니다. 검색 또는 지도 강화, 음성 관리 및 요소 라이브러리 관리는 이 공개 모델 호출 표면 외부의 리소스 API이며 필수 요청 필드가 아닙니다.

가격 및 청구

이 모델은 토큰 기반 청구를 사용합니다. 현재 고객 가격, 참조 정가 및 전체 사양은 모델 가격 페이지를 참조하세요.

참고

이 페이지는 Modelflare의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.