gpt-image-2.5-flare API

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

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

매개변수: size=1536x1024quality=mediumn=1

프롬프트: Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.

이 샘플을 생성한 요청

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.",
  "n": 1,
  "size": "1536x1024",
  "quality": "medium"
}

인증 및 엔드포인트

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-flare",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

요청 메모

GPT Image 2.5 Flare는 일상적인 생성 및 편집을 위한 빠른 고품질 기본값입니다. images[], image[], mask 및 전체 출력 컨트롤을 유지합니다.

요청 매개변수

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

필드	필수	노트
model	예	gpt-image-2.5-flare
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-flare",
    "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": "high", "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-flare" \
  -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=high" \
  -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의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.