Skip to main content
Comfy Router가 Bria에서 제공하는 bria/fibo의 API 레퍼런스입니다.

배포 전 확인

SDK는 Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다. 요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.

헤더

인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.

Router API 사용

모델 검색, 유효성 검사 오류, 재시도, 과금.

제한 사항

Router가 현재 지원하지 않는 기능과 대체 방법.

Quick start

Create a key in your Comfy workspace and export it as COMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk, npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP. Model ID: bria/fibo Endpoint: POST https://api.comfy.org/v2/models/bria/fibo

스키마

입력

number
기본값:"5"
생성된 이미지가 지시 사항을 얼마나 충실히 따를지 결정합니다.범위: 3 ~ 5형식: float
string[]
필수
편집할 소스 이미지입니다. 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 값입니다. 허용 형식은 JPEG, JPG, PNG, WEBP입니다. 항목이 정확히 하나만 포함되어야 합니다.
string
텍스트 기반 편집 지시 사항입니다(예: “make the sky blue”, “add a cat”). instruction 또는 structured_instruction 중 하나는 반드시 제공해야 합니다.
boolean
기본값:"false"
참이면 지시 사항에 잠재적인 IP 콘텐츠가 있는 경우 경고를 반환합니다.
string
선택적 마스크 이미지 URL 또는 Base64로 인코딩된 값입니다. 검정색 영역은 보존되고, 흰색 영역은 편집됩니다.
string
사용할 모델의 버전입니다. Comfy Router는 {model} 경로 세그먼트에서 이 값을 제공하므로 해당 위치에서는 생략합니다. Bria가 실행하는 값은 FIBO이며, v1 라우트에서도 이 필드가 없을 때 이 값이 기본값으로 사용됩니다. 이 쪽에서는 enum으로 제한되지 않습니다. Router는 호출자의 본문이 검증된 이후에 값을 기록합니다.
string
편집된 이미지에서 제외할 개념, 스타일 또는 객체를 지정하는 텍스트 프롬프트입니다.
boolean
기본값:"true"
참이면 지시 사항 검열 실패 시 422를 반환합니다.
integer
결정적 생성을 위한 시드입니다. 생략하면 무작위 시드가 사용됩니다.
integer
기본값:"50"
diffusion 단계 수입니다.범위: 20 ~ 50
string
JSON 형식의 구조화된 편집 지시 사항을 담은 문자열입니다. 정밀하고 프로그래밍 방식의 제어가 필요할 때 instruction 대신 사용하세요.
boolean
기본값:"true"
참이면 이미지 또는 마스크 검열 실패 시 422를 반환합니다.
boolean
기본값:"true"
참이면 시각적 출력 검열 실패 시 422를 반환합니다.
Router가 GET /v2/models/bria/fibo/openapi.json에서 제공하는 스키마에서 생성된 문서로, 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다.

출력

object
오류 객체(status가 ERROR일 때만 존재)
integer
오류 코드입니다.
string
추가 오류 세부 정보입니다.
string
오류 메시지입니다.
string
요청의 고유 식별자입니다.
object
결과 객체(status가 COMPLETED일 때만 존재)
string
생성/편집된 이미지의 URL입니다.
string
원본 프롬프트입니다.
string
프롬프트의 정제된 버전이며, Bria가 정제하지 않은 COMPLETED 생성에서는 null입니다. 키가 생략된 것이 아니라 null을 담은 채 존재하기 때문에 nullable입니다. bria/image-edit-gen-fill에서 실제로 관찰되었습니다.
integer
생성에 사용된 시드입니다.
string
상세한 JSON 구조화 프롬프트입니다.
string
생성된 비디오의 URL입니다.
string
요청의 현재 상태입니다.가능한 값: IN_PROGRESS, COMPLETED, ERROR, UNKNOWN

예시

입력

출력

배포 전 확인

SDK는 Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다. 요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.

헤더

인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.

Router API 사용

모델 검색, 유효성 검사 오류, 재시도, 과금.

제한 사항

Router가 현재 지원하지 않는 기능과 대체 방법.