hiapi의 FLUX 1.1 Pro: 기능, 가격, 실행 가능한 코드 예시

요약

FLUX 1.1 Pro는 Black Forest Labs의 현재 플래그십 텍스트-이미지 모델로, 사실적 출력, 깔끔한 텍스트 렌더링, 유연한 종횡비를 내세웁니다. hiapi를 통해 사용하려면 실제로 알아야 할 핵심은 다음과 같습니다:

• hiapi에서: 이미지당 $0.05, 고정 가격. 해상도 배율도, 품질 티어도 없습니다——1:1, 9:16, 16:9 및 기타 종횡비 모두 같은 가격입니다.
• 엔드포인트: /v1/tasks(비동기 작업 모드), 모델명 flux-1.1-pro. 그것은 /v1/chat/completions 또는 OpenAI 호환 images 엔드포인트를 통해 제공되지 않습니다.
• 잘하는 것: 사실적 인물 사진, 제품 사진, 영화 같은 장면, 짧은 간판/제목 텍스트. 텍스트 렌더링은 대부분의 팀이 처음 사용하던 구버전 Dev 티어보다 확실히 더 안정적입니다.
• hiapi에 없는 것: 구버전 FLUX.1 Dev와 1세대 FLUX Pro는 hiapi 카탈로그에 없습니다. hiapi는 현재 FLUX 패밀리의 1.1 Pro 플래그십만 수록하고 있습니다.

이 글의 나머지 부분에서는 기능, 1.1 Pro가 모델 수준에서 구버전 FLUX 티어 대비 어떤 위치에 있는지, 우리가 hiapi 엔드포인트로 실제 실행해 얻은 네 장의 출력, 그리고 바로 복사할 수 있는 코드 예시를 소개합니다.

패밀리 내에서 FLUX 1.1 Pro의 위치

Black Forest Labs는 여러 FLUX 변형을 출시해 혼동하기 쉽습니다. 빠르게 정리하면:

• FLUX.1 Dev —— 커뮤니티가 구축을 시작한 오픈 웨이트 모델. 범용 이미지 품질은 강하지만 비상업 라이선스이며 텍스트 렌더링과 디테일 표현이 구버전입니다. 대부분의 서드파티 LoRA 작업이 이를 기반으로 합니다.
• FLUX.1 Pro(초기 "Pro") —— BFL의 첫 클로즈드소스 API 모델. Dev보다 충실도가 높지만 더 느리고 조정이 보수적입니다.
• FLUX 1.1 Pro —— 현재 플래그십. 주요 개선점은 생성 속도, 그리고 프롬프트 충실도와 짧은 텍스트 렌더링 상한의 뚜렷한 향상이며, Pro 시리즈 특유의 "사진급" 전반적 느낌은 유지합니다.

FLUX.1 Dev만 써봤다면 1.1 Pro로 전환할 때 가장 눈에 띄는 차이는: 얼굴에 더 이상 천편일률적인 "AI 느낌"이 없고, 짧은 제목 텍스트(간판, 포스터, 라벨)가 요청한 문자열을 실제로 렌더링할 가능성이 더 높으며, 모델이 극적인 조명과 얕은 심도를 처리할 때 프롬프트 유도가 덜 필요하다는 점입니다.

비교에 관한 설명: hiapi의 현재 카탈로그에는 flux-1.1-pro만 나열되어 있습니다——우리는 hiapi 내에서 Dev와 초기 Pro를 1.1 Pro와 벤치마크하지 않았습니다. 같은 방식으로 호출할 수 없기 때문입니다. 위 차이는 모델 자체의 설계 수준 차이이지, 단일 플랫폼 내 가격/지연 정면 비교가 아닙니다.

hiapi에서의 가격

hiapi 가격 API에서 직접 가져온 내용:

모델	엔드포인트	이미지당 가격	해상도 / 종횡비 추가 요금
flux-1.1-pro	POST /v1/tasks	$0.05	없음——모든 종횡비 고정 가격

몇 가지 주목할 점:

• 2K/4K 할증 없음. hiapi의 일부 이미지 모델에는 품질 배율이 있습니다(예: 2K = 기본가의 1.5배). FLUX 1.1 Pro는 없습니다——정사각형 아바타든 16:9 히어로 이미지든 $0.05를 냅니다.
• 토큰이 아닌 이미지 단위 과금. 완성된 이미지마다 한 번 과금합니다. 프롬프트 길이는 가격에 영향을 주지 않습니다.
• 약속 전에 확인하세요. hiapi의 가격은 버전 관리됩니다(API 응답의 pricing_version). 품질 티어가 시간에 따라 추가되거나 제거되는 것을 보았습니다. 자체 서비스에 과금을 연동하기 전에 반드시 /api/pricing을 다시 가져오세요.

참고로 $0.05/장은 FLUX 1.1 Pro를 hiapi의 Google Nano Banana(1K에서 역시 $0.05)와 같은 가격대에 두며, GPT Image 2 Pro(1K에서 $0.35/장)보다 낮습니다. "사실적 기본款"이지 "고급 전문가용"이 아닙니다.

호출 방법

FLUX 1.1 Pro는 /v1/chat/completions가 아닌 비동기 작업 엔드포인트를 통해 제공됩니다. 대부분이 처음 사용할 때 실수하는 지점입니다. 다음이 필요합니다:

1. POST /v1/tasks에 {"model": "flux-1.1-pro", "input": {"prompt": "...", "aspect_ratio": "16:9"}}를 전송 → taskId 반환.
2. GET /v1/tasks/<taskId>를 data.status == "success"가 될 때까지 폴링.
3. data.output[0].url에서 렌더링된 이미지 URL을 읽습니다. 이 URL은 hiapi CDN에 있으며 expireAt 타임스탬프가 있습니다——보관하려면 다운로드하세요.

이 글의 네 이미지를 실제로 렌더링하는 데 사용한 최소 Python 예시:

import json, os, time, urllib.request

TOKEN = os.environ["HIAPI_API_KEY"]
BASE  = "https://api.hiapi.ai"

def submit(prompt: str, aspect_ratio: str = "16:9") -> str:
    body = json.dumps({
        "model": "flux-1.1-pro",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
    }).encode()
    req = urllib.request.Request(
        f"{BASE}/v1/tasks",
        data=body,
        headers={
            "Authorization": f"Bearer {TOKEN}",
            "Content-Type":  "application/json",
        },
    )
    with urllib.request.urlopen(req, timeout=60) as r:
        data = json.loads(r.read())
    if data.get("code") != 200:
        raise RuntimeError(f"submit failed: {data}")
    return data["data"]["taskId"]

def wait_for(task_id: str, timeout_s: int = 240) -> str:
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        time.sleep(5)
        req = urllib.request.Request(
            f"{BASE}/v1/tasks/{task_id}",
            headers={"Authorization": f"Bearer {TOKEN}"},
        )
        with urllib.request.urlopen(req, timeout=30) as r:
            data = json.loads(r.read())
        status = data.get("data", {}).get("status")
        if status == "success":
            return data["data"]["output"][0]["url"]
        if status in ("failed", "canceled"):
            raise RuntimeError(f"task {task_id} {status}: {data}")
    raise RuntimeError(f"task {task_id} timed out after {timeout_s}s")

prompt = (
    "Wide-angle photograph of an old roadside diner at dusk, neon sign "
    "on the roof clearly reading 'MIDNIGHT DINER', warm interior lights "
    "spilling onto an empty parking lot, distant mountains silhouetted "
    "against a deep blue twilight sky, cinematic film still feel"
)
task_id = submit(prompt, aspect_ratio="16:9")
url     = wait_for(task_id)
print(url)

네 이미지 실행에서 각 작업은 종단 간 약 14–19초(제출 → 폴링 → CDN URL)였습니다. 폴링 간격을 포함한 실제 소요 시간이며, 실제 모델 추론은 더 빠릅니다. 위에 UI를 구축한다면 이미지당 약 10–20초의 체감 지연을 계획하고, 예의를 지키기 위해 폴링 간격을 5초 이상으로 유지하세요.

몇 가지 실용적 설명:

• size가 아닌 aspect_ratio를 사용하세요. 이 모델의 작업 입력은 size 필드를 받지 않습니다. "1:1", "4:3", "3:4", "16:9", "9:16" 같은 표준 비율을 전달하세요. size를 전달하면 400 invalid input과 additional properties 'size' not allowed이 발생합니다.
• CDN URL은 임시입니다. 모든 응답에 expireAt(Unix 초)이 포함됩니다. 이미지는 cdn.hiapi.ai에 며칠간 보관됩니다——장기 보존이 필요하면 자체 스토리지로 복사하세요.
• 스트리밍 없음, 진행 상황 없음. 작업은 제출 후 폴링 방식입니다. SSE/WebSocket 진행 신호가 없습니다.

네 장의 실제 출력

아래는 위 코드 경로로 렌더링한 네 이미지입니다. 모든 프롬프트는 이 글의 오리지널입니다——FLUX 갤러리 게시물에서 재사용한 것이 없습니다. 생성 시간은 submit부터 CDN URL이 유효해질 때까지의 실제 소요 시간입니다.

인물, 9:16——사실적 캐릭터

프롬프트: "Photorealistic portrait of a 28-year-old marine biologist standing on a windy seaside cliff at sunrise, navy waterproof jacket, salt spray in her hair, distant lighthouse out of focus behind her, natural cool morning light with warm sun on her face, eye-level frame, magazine cover composition, natural skin texture, shallow depth of field."

실제 소요 시간: 약 14초.

잘된 점: 피부 질감과 눈 디테일이 설득력 있고, 왁스 같은 "AI 얼굴" 느낌이 없습니다. 머리카락 가장자리가 복잡한 배경 앞에서도 잘 유지됩니다. 등대는 제대로 초점에서 벗어나 있습니다.

부족한 점: 재킷 가슴 부위에 요청하지 않은 작은 자동 생성 브랜드 표시가 나타났고, 그것도 살짝 왜곡된 문자열이었습니다. FLUX 1.1 Pro는 요청된 텍스트에서 구버전보다 훨씬 낫지만, 여전히 의류와 제품 표면에 장식적 텍스트를 환각할 수 있습니다. 실제 브랜드를 위해 이미지를 생성한다면, 해당 영역을 인페인팅하거나 "의류에 텍스트 없음" 지시를 명시하고, 부정 프롬프트 준수가 완벽하지 않음을 받아들일 계획을 세우세요.

제품, 1:1——평면 이커머스 이미지

프롬프트: "Top-down product photograph of three handmade ceramic mugs in matte sage green arranged on a sun-dappled oak table, scattered coffee beans and a brass spoon between them, soft morning light from a window casting realistic shadows, editorial e-commerce style, crisp focus on mug rims, neutral color grading, premium catalogue aesthetic."

실제 소요 시간: 약 19초.

잘된 점: 얼룩진 빛과 그림자, 커피콩이 사진처럼 보입니다——그림자 방향이 일관되고, 나뭇결이 그럴듯하며, 세라믹의 무광 유약이 깔끔합니다. 이런 출력은 최소한의 리터칭으로 실제 제품 카탈로그의 무드보드에 넣을 수 있습니다.

부족한 점: 우리는 한 개의 황동 스푼을 원했지만 두 개를 얻었습니다. FLUX 1.1 Pro는 수량이 약 3개 이하일 때 대체로 잘하지만, 사물이 화면 전체에 흩어져 있으면 느슨해집니다. 수량이 중요하다면 프롬프트에 숫자를 여러 곳에 포함하거나("세 개의 컵", "정확히 한 개의 황동 스푼"), 생성 후 크롭하세요.

텍스트가 있는 풍경, 16:9——네온 간판 렌더링

프롬프트: "Wide-angle photograph of an old roadside diner at dusk, neon sign on the roof clearly reading 'MIDNIGHT DINER', warm interior lights spilling onto an empty parking lot with one parked classic pickup truck, distant mountains silhouetted against a deep blue twilight sky, cinematic film still feel, subtle lens flare, photoreal detail."

실제 소요 시간: 약 14초.

잘된 점: 네온 텍스트 "MIDNIGHT DINER"가 적힌 그대로 정확히 출력되었습니다, 자간이 올바르고 분홍/마젠타 빛이 사실적입니다. 이것이 핵심 역량입니다——사진 장면 속 짧은 전대문자 간판 텍스트. 트럭, 산 실루엣, 황혼 그라데이션이 모두 일관됩니다.

부족한 점: 메인 간판 아래 작은 보조 텍스트 패널은 읽을 수 없습니다. 경험칙: FLUX 1.1 Pro는 이미지당 하나의 짧은 문자열에 안정적이며, 더 많이 요구하면 최소한 하나는 대개 퇴화합니다.

커버, 16:9——정물 디테일

이 글 상단의 메인 이미지(풍화된 나무 위 황동 필름 카메라)는 같은 코드 경로로 생성했습니다.실제 소요 시간: 약 15초. 창문 빛 방향, 가죽 노트북의 주름, 배경 보케가 전체 해상도에서도 견딥니다.

이것도 솔직히 말하면: 카메라 바디의 브랜드 텍스트는 자동으로 지어낸 횡설수설입니다. 이것은 반복되는 패턴입니다——요청된 텍스트는 잘 렌더링되지만, 사물에 요청되지 않은 장식적 텍스트는 신뢰할 수 없습니다.

FLUX 1.1 Pro를 언제 선택할까

이 네 번의 실행에서 실제로 관찰한 내용을 바탕으로 한 빠른 가이드:

• 적합: 사실적 인물, 제품 평면 이미지, 영화적 풍경, 짧은 제목/간판 텍스트. "사진급" 기반 레이어가 필요하고 부정 프롬프트를 많이 쓰지 않아도 되는 모든 장면.
• 아마 적합: 스타일화된 일러스트(할 수는 있지만 다른 모델이 이에 더 특화됨), 여러 줄 타이포그래피 이미지(짧은 문자열 하나는 괜찮음——여러 줄 포스터 텍스트는 흐트러짐).
• 부적합: 브랜드 충실도 요구가 높은 로고와 상표(즉흥적으로 만들어냄), 수량이 정확해야 하는 엄격한 카운팅 구도, 이 정확한 모델에서 이미지-투-이미지 워크플로가 필요한 모든 작업(여기의 /v1/tasks 라우트는 텍스트-투-이미지만 지원).

hiapi 내 가격 비교에서 가장 가까운 이웃은 Nano Banana, $0.05/장입니다——그것은 더 빠른 처리와 Gemini 패밀리의 캐릭터 일관성 장점에 치우치고, FLUX 1.1 Pro는 사실적 정물 이미지와 신뢰할 수 있는 짧은 텍스트에 치우칩니다. 둘 다 보고 싶다면 hiapi 가격 API가 image / text-to-image 카테고리 아래 나란히 나열합니다.

마무리

hiapi가 FLUX 1.1 Pro를 깔끔하게 노출하는지 확신이 없어 망설였다면: 노출합니다, 그리고 통합 표면이 작습니다.

• 비동기 엔드포인트 하나(/v1/tasks), 입력 형태 하나, size가 아닌 aspect_ratio 사용.
• 모든 종횡비에서 이미지당 고정 가격 $0.05.
• 신뢰할 수 있는 사실적 출력과 신뢰할 수 있는 짧은 문자열 텍스트 렌더링, 동시에 모든 생성형 이미지 모델이 프롬프트되지 않은 텍스트와 정확한 카운팅 측면에서 여전히 지니는 동일한 주의사항.

위의 코드 블록이 최소 실행 가능 클라이언트입니다. 거기서부터 주요 문제는 어떤 프롬프트가 당신의 도메인에 맞는가이며, 이 부분은 언제나 그렇듯 경험적입니다.