Bria FIBO 2.0 텍스트-투-이미지 및 이미지-투-이미지: 파라미터, 프롬프트, 호출 예시

Bria FIBO 2.0의 두 가지 모델 진입점

Bria FIBO 2.0은 플랫폼에서 두 가지 모델을 제공합니다: Bria FIBO 2.0 텍스트-투-이미지(fibo-2.0/text-to-image)는 프롬프트 한 줄로 이미지를 생성하고, Bria FIBO 2.0 이미지-투-이미지(fibo-2.0/image-to-image)는 기존 이미지에 자연어 지시로 편집을 가합니다. 두 모델의 가격은 동일하게 장당 $0.0572이며, 출력은 약 100만 픽셀로 1:1 비율일 때 1024×1024입니다.

Bria는 라이선스 데이터로 모델을 학습시켜 상업적 용도에 적합합니다. 카메라 앵글, 조명, 심도, 구도 같은 사진적 요소에 대한 제어력이 강하며, 이것이 이 모델을 사용할 때 가장 활용할 만한 부분입니다. 형용사를 쌓기보다 이런 요소들을 명확하게, 단락별로 조정 가능한 서술로 작성하는 편이 좋습니다.

이 모델에 맡기기 좋은 세 가지 작업

• 기존 소재의 앵글과 조명 조정: 촬영해 둔 상품 사진이나 인물 사진이 있고, 시점만 45도 부감으로 바꾸고 조명만 정오에서 황혼으로 바꾸고 싶으며 인물의 자세, 의상, 배경은 그대로 두고 싶은 경우. 이미지-투-이미지는 한 가지 속성만 바꾸고 나머지는 그대로 유지하는 데 능하므로 이런 요구에 딱 맞습니다.
• 지정 스타일의 장면 콘셉트 이미지: 구조화된 서술로 장면, 앵글, 조명을 명확히 쓰고, Kodak Film, Hard Flash, Hazy Dreamy, Rough Realism 중 하나의 스타일을 선택하여 초기 비주얼 방향 탐색에 사용합니다.
• 마스크를 사용한 부분 교체: 화면의 특정 영역만 바꾸는 경우, 예를 들어 책상 위의 소품을 교체하거나 배경의 간판 하나를 바꾸는 경우, 흑백 마스크로 범위를 지정하고 나머지는 그대로 유지합니다.

파라미터 사용법

두 모델의 입력 구조는 다릅니다: 텍스트-투-이미지의 핵심 필드는 prompt, 이미지-투-이미지의 핵심 필드는 instruction입니다. 필드명은 비슷하지만 값과 제약에는 차이가 있으므로 따로 보는 편이 안전합니다.

Bria FIBO 2.0 텍스트-투-이미지(fibo-2.0/text-to-image)

aspect_ratio의 21가지 값에는 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 16:10, 10:16, 2:1, 1:2, 21:9, 9:21, 3:1, 1:3, 4:1, 1:4, 5:1, 1:5가 포함됩니다. 전달하지 않으면 1:1로 출력됩니다. 출력 총량은 약 100만 픽셀이며, 비율은 가로세로 배분만 바꿉니다.

style과 image_url은 공존할 수 없으며, 이 점은 코드에서 사전 검증해야 합니다: 고정 스타일이 필요하면 style을, 특정 이미지의 시각적 특징을 참조하려면 image_url을 전달하며 둘 중 하나만 선택해야 합니다. 파라미터 충돌은 생성 측에서 자동으로 해소되지 않으므로 미리 차단하는 편이 사후 디버깅보다 수월합니다.

Bria FIBO 2.0 이미지-투-이미지(fibo-2.0/image-to-image)

image_urls의 순서는 의미가 있습니다: 첫 번째가 편집 대상 주체를 결정하고, 나머지 몇 장은 instruction에서 참조될 때만 작용하며, 참조 방식은 instruction에 <image_1>, <image_2>를 쓰는 것입니다. 참조 이미지를 instruction에 쓰지 않으면 사용되지 않은 것과 같습니다.

aspect_ratio를 전달하지 않으면 첫 번째 이미지를 따르며, 단일 이미지 편집은 항상 원본 비율을 유지합니다. mask_url은 변경 범위를 한정해야 할 때만 사용합니다: 마스크는 흑백 이미지로 흰색이 변경할 영역을 나타내며, 크기가 원본 이미지와 일치해야 정렬됩니다. 마스크가 있을 때 image_urls는 1장만 제출할 수 있고 참조 이미지를 추가할 수 없습니다.

이미지-투-이미지를 사용할 때 지시는 하나의 속성만 대상으로 하는 것이 좋습니다. 앵글, 조명, 시간, 의상, 재질 중 하나만 고르고 나머지 서술은 '변경하지 않음'으로 작성하면 결과가 기준을 충족했는지 판단하기 쉽습니다.

프롬프트 작성법

권장 서술 순서는 주체와 동작 → 장면 → 앵글 시점 → 조명 시간대 → 심도 초점 → 재질 화질입니다. 이 6단으로 작성하면 화면을 독립적으로 조정 가능한 여섯 개의 변수로 나누는 셈입니다: 앵글을 바꾸고 싶으면 세 번째 단만, 시간대를 바꾸고 싶으면 네 번째 단만 고치고 나머지 서술은 그대로 두면, 변경으로 인한 차이를 명확히 귀인할 수 있습니다. 사진적 요소에 대한 제어가 이 모델의 강점이며, 이 6단이 대체로 그 강점 범위를 포괄합니다.

예시 1: 텍스트-투-이미지의 prompt

짙은 회색 울 코트를 입은 여성이 비 온 뒤의 거리 모퉁이에 서서 검은 장우산을 접고 있다.
거리 양쪽은 이른 아침 아직 문을 열지 않은 가게들이고, 셔터가 반쯤 내려져 있으며 바닥에 물이 고여 있다.
35mm 시점, 약간 낮은 앵글, 인물의 왼쪽 앞에서 촬영, 인물은 화면 오른쪽 삼분할 선에 위치.
흐린 아침의 산란광, 색온도는 차갑고 직사광선은 없다.
f/2 얕은 심도, 인물의 얼굴은 선명하고 배경 건물은 점차 흐려진다.
울 소재의 촘촘한 결이 보이고, 금속 우산살에 약간의 하이라이트가 있으며, 전체적으로 입자가 고르다.

제출할 때 style을 Kodak Film, aspect_ratio를 3:2, seed를 5555로 지정합니다. 6단 서술은 각각 독립적이므로, 나중에 Hard Flash의 하드 라이트 스타일로 바꾸고 싶다면 style과 조명 단만 바꾸고 나머지 다섯 줄은 그대로 두면 차이를 비교할 수 있습니다.

예시 2: 이미지-투-이미지의 instruction

<image_1>의 앵글을 정수리 위 부감으로 바꾸고, 인물의 자세, 의상, 위치는 그대로 유지한다.
<image_2>를 의상 재질 참조로 사용하고, 코트의 직물 결와 광택은 <image_2>에 따라 처리한다.

여기서 image_urls에는 두 장을 전달합니다: 첫 번째는 편집할 원본 이미지, 두 번째는 재질 참조 이미지이므로 instruction에서 <image_1>, <image_2>로 명확히 지칭해야 합니다. 지시 자체는 두 가지 일만 합니다—앵글 변경, 참조 이미지에 따라 재질 처리—이것이 바로 이미지-투-이미지가 잘하는 범위입니다: 한 번에 하나의 속성만 바꾸고 나머지는 최대한 건드리지 않습니다. 변경을 단일 차원으로 통제하면 재작업을 줄이고 이번 호출이 기대에 부합하는지 판단하기도 쉽습니다.

가격과 콘텐츠 안전

두 모델 모두 장당 $0.0572이며, 과금 규칙은 비율, 스타일, 참조 이미지 장수, 마스크 여부와 전혀 무관합니다. 1:1과 21:9는 같은 가격이고, 4장을 전달하든 1장을 전달하든 같은 가격이며, mask가 있든 없든 같은 가격입니다. 비용은 오직 출력 이미지 장수로만 결정됩니다: 100장은 $5.72, 1000장은 $57.2입니다.

콘텐츠 안전에 관해서는 미리 알아야 할 점이 있습니다: 설명에 규정에 맞지 않는 내용이 포함되면 인터페이스는 오류를 반환하지 않고, 모델이 프롬프트를 안전한 내용으로 재작성한 뒤 계속 이미지를 생성합니다. 재작성된 화면은 원래 의도와 무관할 수 있지만 이번 호출은 정상적으로 과금됩니다. 따라서 프롬프트는 제출 전에 자체 점검해야 하며, 특히 인물, 의상, 장면과 관련된 민감한 서술—문제가 생기면 오류가 아니라 무관한 이미지 한 장과 비용 한 건이 남습니다.

API 호출 예시

두 모델 모두 비동기 작업 인터페이스를 사용합니다: 먼저 POST /v1/tasks로 작업을 제출하고, 응답에서 작업 id를 받은 뒤, GET /v1/tasks/{id}를 폴링하여 이미지 주소를 가져옵니다.

curl -X POST "$HIAPI_BASE_URL/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fibo-2.0/text-to-image",
    "input": {
      "prompt": "짙은 회색 울 코트를 입은 여성이 비 온 뒤의 거리 모퉁이에 서 있고, 35mm 시점, 약간 낮은 앵글, 흐린 아침의 산란광, f/2 얕은 심도, 울 소재의 촘촘한 결이 보인다.",
      "style": "Kodak Film",
      "aspect_ratio": "3:2",
      "seed": 5555
    }
  }'

curl "$HIAPI_BASE_URL/v1/tasks/{id}" \
  -H "Authorization: Bearer $HIAPI_API_KEY"

이미지-투-이미지도 동일한 작업 인터페이스를 사용하며 model과 input만 바꿉니다:

curl -X POST "$HIAPI_BASE_URL/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fibo-2.0/image-to-image",
    "input": {
      "instruction": "<image_1>의 앵글을 정수리 위 부감으로 바꾸고, 인물의 자세와 의상은 그대로 유지한다. <image_2>를 의상 재질 참조로 사용한다.",
      "image_urls": [
        "https://example.com/scene.jpg",
        "https://example.com/fabric.jpg"
      ],
      "seed": 5555
    }
  }'

자주 묻는 질문

style과 image_url을 함께 전달할 수 있나요?

할 수 없습니다. 둘은 상호 배타적이며 동시에 전달하면 충돌합니다. 스타일을 지정해야 하면 style을, 특정 이미지의 시각적 특징을 참조해야 하면 image_url을 사용하며 둘 중 하나만 선택합니다.

mask_url을 전달한 뒤에도 image_urls에 여러 장을 전달할 수 있나요?

할 수 없습니다. 마스크가 있을 때 image_urls는 1장만 가능하며, 그것이 바로 편집 대상 이미지입니다. 마스크 자체는 흑백 이미지로 흰색 영역이 변경할 부분을 나타내며, 크기는 반드시 원본 이미지와 일치해야 합니다.

동일한 이미지를 재현하려면 어떻게 해야 하나요?

seed를 고정합니다. 값 범위는 0–2147483647이며 기본값은 5555입니다. 동일한 seed와 동일한 프롬프트로 결과를 재현할 수 있습니다. 이미지-투-이미지의 seed 기본값도 5555입니다.