FLUX 1.1 Pro на hiapi: возможности, цены и рабочие примеры кода

Краткий обзор

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 и первое поколение FLUX Pro отсутствуют в каталоге hiapi. Сейчас hiapi включает только флагманскую версию 1.1 Pro семейства FLUX.

В остальной части статьи рассказывается о его возможностях, о том, как 1.1 Pro на уровне модели соотносится со старыми уровнями FLUX, о четырёх выводах, которые мы реально получили через конечную точку hiapi, и о готовом к копированию примере кода.

Место FLUX 1.1 Pro в семействе

Black Forest Labs выпустила несколько вариантов FLUX, в которых легко запутаться, поэтому вот краткий обзор:

• FLUX.1 Dev — модель с открытыми весами, на которой сообщество начало строить. Сильное общее качество изображений, но некоммерческая лицензия, а отображение текста и детализация устарели. Большинство сторонних LoRA построено на ней.
• FLUX.1 Pro (первый «Pro») — первая закрытая API-модель BFL. Точность выше, чем у Dev, но медленнее и с консервативной настройкой.
• FLUX 1.1 Pro — текущий флагман. Основные улучшения — скорость генерации и заметный рост точности следования промпту и верхнего предела отображения короткого текста, при сохранении фирменного «фотореалистичного» общего вида серии Pro.

Если вы работали только с FLUX.1 Dev, самые заметные различия после перехода на 1.1 Pro: лица больше не имеют того шаблонного «AI-ощущения», короткий текст заголовков (вывески, плакаты, этикетки) чаще действительно выводит запрошенную строку, а модели требуется меньше подсказок в промпте для драматичного освещения и малой глубины резкости.

Примечание о сравнении: в текущем каталоге hiapi указан только flux-1.1-pro — мы не проводили бенчмарки Dev и первого Pro против 1.1 Pro внутри hiapi, поскольку их нельзя вызвать там таким же образом. Описанные различия относятся к самим моделям на уровне дизайна, а не к прямому сравнению цен/задержек на одной платформе.

Цены на hiapi

Напрямую из API цен hiapi:

Модель	Конечная точка	Цена за изображение	Надбавка за разрешение / пропорции
flux-1.1-pro	POST /v1/tasks	$0.05	Нет — фиксированная цена для любых пропорций

Стоит отметить несколько моментов:

• Без наценки за 2K/4K. У некоторых моделей изображений на hiapi есть множители качества (например, 2K = 1.5× базовой цены). У FLUX 1.1 Pro их нет — вы платите $0.05 независимо от того, нужен ли вам квадратный аватар или главное изображение 16:9.
• Оплата за изображение, а не за токены. Вы платите один раз за каждое завершённое изображение. Длина промпта не влияет на цену.
• Проверяйте перед тем, как обещать. Цены hiapi версионируются (pricing_version в ответе API), и мы видели, как уровни качества добавлялись и удалялись со временем. Перед тем как закладывать биллинг в свой сервис, обязательно заново получайте /api/pricing.

Для справки: $0.05/изображение ставит FLUX 1.1 Pro в один ценовой ряд с Google Nano Banana на hiapi (тоже $0.05 при 1K) и ниже GPT Image 2 Pro ($0.35/изображение при 1K). Его позиция — «реалистичный вариант по умолчанию», а не «премиальный экспертный вариант».

Как вызывать

FLUX 1.1 Pro предоставляется через асинхронную конечную точку задач, а не через /v1/chat/completions. Именно здесь большинство людей спотыкается при первом использовании. Вам нужно:

1. Отправить {"model": "flux-1.1-pro", "input": {"prompt": "...", "aspect_ratio": "16:9"}} на POST /v1/tasks → вернётся taskId.
2. Опрашивать GET /v1/tasks/<taskId>, пока data.status == "success".
3. Прочитать URL отрендеренного изображения из data.output[0].url. Этот URL находится на CDN hiapi и имеет метку времени 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 секунд от начала до конца (отправка → опрос → URL CDN). Это фактическое время, включая интервалы опроса; сама модель выводит быстрее. Если вы строите поверх этого UI, планируйте воспринимаемую задержку около 10–20 секунд на изображение и держите интервал опроса 5 секунд или больше, чтобы быть вежливыми.

Несколько практических замечаний:

• Используйте aspect_ratio, а не size. Входные данные задачи этой модели не принимают поле size. Передавайте стандартные пропорции, такие как "1:1", "4:3", "3:4", "16:9", "9:16". Передача size даст 400 invalid input и additional properties 'size' not allowed.
• URL CDN временные. Каждый ответ содержит expireAt (Unix-секунды). Изображения хранятся на cdn.hiapi.ai несколько дней — для долгосрочного хранения скопируйте их в собственное хранилище.
• Без стриминга, без прогресса. Задачи работают по схеме «отправил и опрашивай». Нет сигналов прогресса через SSE/WebSocket.

Четыре реальных вывода

Ниже — четыре изображения, отрендеренные через описанный выше путь кода. Все промпты оригинальны для этой статьи — ничего не переиспользовано из постов галереи FLUX. Время генерации — фактическое время от submit до появления URL CDN.

Портрет, 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 — плоская e-commerce композиция

Промпт: «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 обычно хорошо справляется с количеством до примерно трёх предметов, но становится небрежным, когда предметы разбросаны по кадру. Если количество важно, либо включайте числа в промпт несколько раз («три кружки», «ровно одна латунная ложка»), либо обрезайте после генерации.

Пейзаж с текстом, 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 — к фотореалистичным натюрмортам и надёжному короткому тексту. Если хотите посмотреть обе, API цен hiapi перечисляет их рядом в категории image / text-to-image.

Итог

Если вы сомневались, потому что не были уверены, что hiapi чисто предоставляет FLUX 1.1 Pro: он предоставляет, и поверхность интеграции мала.

• Одна асинхронная конечная точка (/v1/tasks), одна форма входных данных, с aspect_ratio вместо size.
• Фиксированная цена $0.05 за изображение при любых пропорциях.
• Надёжный фотореалистичный вывод и надёжное отображение короткого текста, при сохранении тех же оговорок, которые есть у всех генеративных моделей изображений в отношении незапрошенного текста и точного подсчёта.

Блок кода выше — минимальный работающий клиент. Оттуда главный вопрос — какие промпты подходят вашей области, и эта часть, как всегда, эмпирическая.