openai/gpt-image-2.5-sunburst에 대한 API 레퍼런스이며, Comfy Router가 OpenAI에서 제공합니다.
Quick start
your Comfy workspace에서 키를 생성하고COMFY_API_KEY로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다.
Model ID: openai/gpt-image-2.5-sunburst
Endpoint: POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst
- 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-sunburst/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이 서비스하는 분기에서 채워지며, OpenAI가 서비스하는 분기에서는 존재하지 않습니다. 이 경우 호출자가 요청한 output_format이 기준이 됩니다.string
생성이 실제로 실행된 품질 등급. fal이 서비스하는 분기에서 이를 확인할 수 있을 때 채워지며, 그렇지 않으면 존재하지 않습니다.
string
생성이 실제로 실행된 픽셀 크기로,
<width>x<height> 형식입니다. fal이 서비스하는 분기에서 이를 확인할 수 있을 때 채워지며, 그렇지 않으면 존재하지 않습니다.예시
입력
출력
배포 전 확인
SDK는Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다.
요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.
헤더
인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.
Router API 사용
모델 검색, 유효성 검사 오류, 재시도, 과금.
제한 사항
Router가 현재 지원하지 않는 기능과 대체 방법.