FLUX 3 Image Klein API 가이드: 5단계 해상도 가격, 파라미터 및 호출 예시

FLUX 3 Image Klein이란

FLUX 3 Image Klein은 Black Forest Labs의 FLUX 3 시리즈에 속한 경량 이미지 모델입니다. HiAPI에서는 모델 ID가 하나뿐입니다: flux-3-image-klein. 텍스트로 이미지를 생성할 때와 참조 이미지 편집 모두 이 ID를 사용합니다. 프롬프트만 작성하면 텍스트-이미지 생성이고, image_urls를 추가하면 참조 이미지에 따라 화면을 수정하거나 여러 이미지의 스타일을 하나로 융합하는 편집이 됩니다.

장점은 저렴한 가격과 다양한 단계입니다. 768부터 4K까지 총 5단계 해상도를 제공하므로 대량 이미지 생성과, 작은 이미지로 시안을 시험한 뒤 큰 이미지로 최종 확정하는 워크플로에 적합합니다.

가격: 해상도 단계별, 장당 과금

• 768: $0.0092 / 장
• 1K (기본): $0.0103 / 장
• 1.5K: $0.0126 / 장
• 2K: $0.016 / 장
• 4K: $0.0412 / 장

참조 이미지는 별도 요금이 없으며, 1장을 첨부하든 10장을 첨부하든 같은 가격입니다. steps를 낮춰도 가격은 내려가지 않으며, 가격은 resolution에만 따라 결정됩니다. 작업이 실패하면 전액 환불됩니다.

예를 들어 768 단계로 스타일 시안 50장을 시험하면 $0.46이고, 그중 5장을 골라 4K로 최종 결과물을 만들면 $0.206입니다.

파라미터

model과 prompt를 제외한 모든 파라미터는 선택 사항입니다:

• prompt: 필수, 1–5000자.
• resolution: 768, 1K, 1.5K, 2K, 4K, 기본값 1K.
• aspect_ratio: 16개 선택값. 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21 및 auto(기본)를 포함합니다.
• image_urls: 공개 인터넷에서 접근 가능한 참조 이미지 1–10장. 작성하지 않으면 순수 텍스트-이미지 생성입니다.
• steps: 1–16, 기본값 16. 단계가 적을수록 이미지 생성이 빠르지만 세부 묘사가 줄어들 수 있습니다.
• seed: 0–4294967295. 시드를 고정하면 같은 파라미터로 최대한 유사한 결과를 재현합니다. 작성하지 않으면 무작위입니다.
• safety_tolerance: 0–4, 기본값 2. 숫자가 클수록 검열이 완화됩니다.
• output_format: jpeg(기본) 또는 png.

요청 예시

이미지 작업은 비동기입니다. 먼저 작업을 생성한 뒤 결과를 폴링합니다. model은 최상위에 두고, 나머지 파라미터는 input 안에 넣습니다.

텍스트-이미지 생성, 2K, 4:5 세로 이미지, 시드 고정:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "아침 햇살이 비치는 나무 테이블 위에 놓인 도자기 커피잔, 얕은 심도, 따뜻한 색조, 제품 사진",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

이 한 장은 $0.016입니다.

참조 이미지 편집, 두 이미지의 스타일 융합:

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "첫 번째 이미지의 건축 구조는 유지하고, 두 번째 이미지의 수채화 붓터치와 색상으로 다시 그려 주세요",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

생성에 성공하면 반환된 작업 ID로 GET https://api.hiapi.ai/v1/tasks/{taskId}를 호출해 폴링하고, 성공 후 출력에서 이미지 주소를 가져옵니다.

사용법 제안

• 작게 먼저, 크게 나중에: 768 또는 1K에 고정 seed로 프롬프트를 시험하고, 만족하면 resolution만 2K 또는 4K로 바꿔 다시 생성하세요.
• 대량 변형: 같은 프롬프트에 서로 다른 seed를 적용하면 구도는 다르지만 스타일이 일관된 후보군이 됩니다.
• 이미지 수정 시 무엇을 유지할지 명확히 작성: 참조 이미지를 사용할 때는 목표 화면만 묘사하는 것보다, 프롬프트에 무엇을 유지하고 무엇을 변경할지 설명하는 편이 더 안정적입니다.

현재 제한 사항

• 호출할 때마다 이미지 한 장을 반환합니다.
• 참조 이미지는 최대 10장이며, 공개 인터넷 http(s) 주소여야 합니다.
• 투명 배경 옵션은 없으며, png는 무손실 포맷으로 바꾸는 것일 뿐입니다.