gpt-image-2.5-sunburst API

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

샘플 출력gpt-image-2.5-sunburstPOST /v1/images/generations

매개변수: size=1536x1024n=1

프롬프트: The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

이 샘플을 생성한 요청

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, 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.5-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

요청 메모

GPT Image 2.5 Sunburst는 더 높은 충실도, 더 높은 제어 제어 생성 및 편집을 목표로 합니다. 두 작업 모두에 대해 images[], image[], mask, xhigh/max 및 출력 컨트롤을 유지합니다.

요청 매개변수

GPT Image 2.5는 OpenAI 호환 Images API를 사용합니다. 생성은 JSON을 사용합니다. 편집에는 JSON 이미지 참조 또는 멀티파트 파일이 허용됩니다. 응답은 data[].b64_json에 Base64 이미지 데이터를 반환합니다.

필드	필수	노트
model	예	gpt-image-2.5-sunburst
prompt	예	생성 또는 편집 지침, 1~32,000자
images[]	조건부	JSON 편집의 경우 최대 16개의 file_id 또는 image_url 객체
images[].file_id	조건부	업로드된 파일 API ID
images[].image_url	조건부	이미지 URL 또는 Base64 데이터 URL; 데이터 URL은 20,971,520자로 제한됩니다.
image	조건부	하나의 멀티파트 소스 파일; 여러 파일에 대해 image[]을 사용하십시오.
image[]	조건부	멀티파트 편집의 경우 최대 16개의 소스 파일
mask	아니요	첫 번째 소스 형식/크기와 일치하고 50MB 미만인 알파 마스크
size	아니요	auto 또는 사용자 정의 WIDTHxHEIGHT; 16픽셀 배수, 1:33:1 화면 비율, 최대 가장자리 3,840픽셀, 총 픽셀 655,3608,294,400
quality	아니요	low / medium / high / xhigh / max / auto; 기본 auto
background	아니요	auto / opaque / transparent; 투명한 배경에는 PNG 또는 WebP 출력이 필요합니다.
output_format	아니요	png / jpeg / webp; 기본 png
output_compression	아니요	JPEG/WebP의 경우 0–100, 기본값은 100; PNG의 경우 무시됨
moderation	아니요	auto / low; 기본 auto
n	아니요	1~10개 출력; 기본값 1

응답 및 입력 제한

GPT Image 2.5 Flare 및 Sunburst는 최대 16개의 편집 입력을 지원합니다. JSON 편집에서는 file_id 또는 image_url와 함께 images[]을 사용합니다. 멀티파트 편집은 image/image[]를 사용하며 각 소스 이미지와 마스크는 50MB 미만입니다. 프롬프트는 132,000자입니다. 품질은 low/medium/high/xhigh/max/auto을 지원합니다. 크기 규칙은 16픽셀 배수, 가로 세로 비율 1:33:1, 최대 가장자리 3,840픽셀, 총 픽셀 655,360~8,294,400입니다. 투명한 배경에는 PNG 또는 WebP가 필요합니다. 압축은 JPEG/WebP에만 적용되며 PNG에서는 무시됩니다. 2560x1440 이상의 해상도는 실험적입니다. data[].b64_json를 읽으십시오; DALL·E 전용 response_format을 보내지 마십시오. Flare는 일상적인 생성 및 편집을 위한 빠르고 고품질의 기본 기능입니다. Sunburst는 충실도와 제어 수준이 높은 작업을 위한 것입니다.

이미지 편집

GPT Image 2.5는 /v1/images/edits을 통한 JSON 이미지 참조 및 멀티파트 파일 업로드를 지원합니다. JSON은 file_id 또는 image_url를 사용하여 최대 16개의 객체를 허용합니다. 멀티파트는 최대 16개의 소스 파일을 허용합니다. 한 번의 요청으로 images와 image/image[]를 혼합하지 마십시오.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=xhigh" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

응답 형태

data[]에서 생성 및 편집된 결과를 읽습니다. GPT Image 2.5는 Base64 이미지 데이터를 반환합니다. 응답을 URL 출력으로 처리하지 마십시오.

필드	노트
created	Unix 타임스탬프로 생성 시간(초)
data	생성 또는 편집된 이미지 결과
data[].b64_json	Base64로 인코딩된 이미지 데이터
background	최종 배경 모드: opaque 또는 transparent
output_format	반환된 이미지 형식: png, jpeg 또는 webp
quality	사용된 품질 등급
size	최종 크기(WIDTHxHEIGHT)

오류 및 실패한 작업

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

지원 범위

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

가격 및 청구

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

참고

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