openai/gpt-image-2.5-flare에 대한 API 레퍼런스이며, OpenAI가 Comfy Router를 통해 제공합니다.
빠른 시작
Comfy 워크스페이스에서 키를 생성하고COMFY_API_KEY로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 동일한 호출을 raw HTTP로 수행한 것입니다.
Model ID: openai/gpt-image-2.5-flare
Endpoint: POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare
- Wait for the result
- Queue and collect later
스키마
입력
string
배경 투명도가능한 값:
transparent, opaquestring
이미지 생성에 사용할 모델 (예: gpt-image-1, gpt-image-1.5, gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst)
string
콘텐츠 검열 설정가능한 값:
low, autointeger
생성할 이미지 수 (1-10).
integer
JPEG 또는 WebP의 압축 수준 (0-100)
string
출력 이미지의 형식가능한 값:
png, webp, jpegstring
필수
원하는 이미지에 대한 텍스트 설명
string
생성된 이미지의 품질가능한 값:
low, medium, high, standard, hdstring
이미지 데이터의 응답 형식가능한 값:
url, b64_jsonstring
이미지 크기 (예: 1024x1024, 1536x1024, auto)
string
이미지의 스타일. 이 작업이 허용하는 gpt-image 모델에서는 사용되지 않습니다. dall-e-3 전용 파라미터였으며, OpenAI가 2026-05-12에 해당 id들을 종료하면서 폐기되었습니다.가능한 값:
vivid, naturalstring
최종 사용자 모니터링을 위한 고유 식별자
GET /v2/models/openai/gpt-image-2.5-flare/openapi.json에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다.
출력
object[]
string
Base64로 인코딩된 이미지 데이터
string
수정된 프롬프트
string
이미지의 URL
object
integer
object
integer
integer
integer
object
integer
integer
integer
string
생성된 이미지의 배경이 불투명인지 투명인지 여부. fal이 제공하는 분기에서만 채워지며, 해당 분기는
opaque를 보고합니다.integer
생성이 완료된 시점의 Unix 타임스탬프(초). 현재의 epoch 값이 2^31에 충분히 가까워 서식을 지정하지 않은
integer가 많은 SDK 생성기에서 32비트 필드를 만들기 때문에 int64로 선언되었습니다.형식: int64string
data[].b64_json에 있는 바이트의 인코딩 (예: png). fal이 제공하는 분기에서 채워지며, 호출자가 요청한 output_format이 우선하는 OpenAI 제공 분기에서는 존재하지 않습니다.string
생성이 실제로 실행된 품질 등급. fal이 제공하는 분기에서 이를 확인할 수 있을 때 채워지며, 그렇지 않으면 존재하지 않습니다.
string
생성이 실제로 실행된 픽셀 크기로,
<width>x<height> 형식입니다. fal이 제공하는 분기에서 이를 확인할 수 있을 때 채워지며, 그렇지 않으면 존재하지 않습니다.예제
입력
출력
배포 전 확인
SDK는Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다.
요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.
헤더
인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.
Router API 사용
모델 검색, 유효성 검사 오류, 재시도, 과금.
제한 사항
Router가 현재 지원하지 않는 기능과 대체 방법.