FLUX.3 Image API：как использовать? Запустите первое изображение за 5 минут

TL;DR

• FLUX.3 Image — модель изображений от Black Forest Labs, выпущенная в октябре 2026 года, имя модели flux-3-image. Одно имя модели управляет и генерацией из текста, и редактированием: при редактировании можно передать до 10 референсных изображений. Откройте страницу модели, чтобы попробовать онлайн.
• Оплата за изображение: 1K (по умолчанию) $0.048, 2K $0.10, 4K $0.607, до 31 октября скидка 20% на все тарифы. Каждая задача выдаёт 1 изображение.
• Самый быстрый способ вызова: POST /v1/tasks с prompt, опрос до статуса success, скачивание output[0].url. Не забывайте явно указывать resolution, проверяйте оба статуса ошибки — fail и failed.

Что такое FLUX.3 Image и что в ней нового?

• Генерация и редактирование под одним именем модели. Не передаёте image_urls — это генерация из текста; передаёте 1–10 референсных изображений — редактирование вокруг референсов, в промпте чётко опишите, за что отвечает каждое изображение.
• Пять уровней разрешения: от 768 ($0.041) до 4K ($0.607); 15 форматов от 21:9 до 9:21, плюс auto.
• Поиск в интернете дополняет детали. grounding включён по умолчанию: перед генерацией можно поискать в вебе и изображениях, чтобы дополнить информацию о сцене.
• 9-е место в рейтинге text-to-image Artificial Analysis.

Интерьер 1.5K, 3:2:

Architectural interior photograph of a cedar alpine reading cabin,
floor-to-ceiling window opening onto a misty mountain lake, linen armchair and a
small brass lamp, warm wood grain, quiet morning atmosphere, restrained
Scandinavian design, no text.

Сгенерировать с этим промптом → (1.5K, 3:2)

flux-3-image, 1.5K, 3:2, $0.07.

Два пути для старта

Онлайн-тест (без кода):

1. Откройте страницу модели FLUX.3 Image, войдите (новым пользователям при регистрации даётся 200 кредитов).
2. Вставьте промпт, выберите разрешение и формат, при необходимости загрузите референсные изображения.
3. Нажмите «Сгенерировать» и скачайте результат.

Вызов через API:

1. Создайте API Key в консоли.
2. POST /v1/tasks, "model": "flux-3-image".
3. Опрашивайте GET /v1/tasks/{taskId} или принимайте callback, сохраните output[0].url.

curl: запускаем первое изображение

1K, 4:3, $0.048:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image",
    "input": {
      "prompt": "A refined still life of a terracotta architectural model on ivory paper, brass desk lamp, olive leaves, soft late-afternoon sunlight, no text",
      "resolution": "1K",
      "aspect_ratio": "4:3"
    }
  }'

В ответе будет data.taskId. Опрашивайте GET /v1/tasks/{taskId}; когда status станет success, скачайте output[0].url.

Python: отправка, опрос, скачивание

# pip install requests; export HIAPI_KEY=ваш_ключ
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=300, **inp):
    # При повторной отправке той же задачи используйте тот же Idempotency-Key — списание будет только одно
    r = requests.post(API, json={"model": "flux-3-image", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

url = generate(
    prompt="A cinematic rainy Tokyo side street at blue hour, a small bookstore with warm amber windows, a red bicycle outside, no readable signs",
    resolution="2K", aspect_ratio="16:9",
)
ext = url.split("?")[0].rsplit(".", 1)[-1]  # сохраняем в соответствии с типом файла из ответа
with open(f"street.{ext}", "wb") as f:
    f.write(requests.get(url).content)

Редактирование с референсными изображениями

Передайте image_urls (1–10 публичных ссылок), в промпте укажите, что даёт каждое изображение и что из него не нужно переносить. Ниже — композиция из трёх изображений: изображение 1 даёт основной объект, изображение 2 — сцену, изображение 3 — только цветовую палитру.

Create a refined product photograph. Use the cobalt blue ceramic teapot and
walnut handle from Image 1 as the main subject, place it on a pale stone side
table inside the cedar reading cabin from Image 2. Borrow only the subtle teal
and amber lighting palette from Image 3. Preserve the teapot shape and glaze,
keep the lake window visible in the background, realistic scale, no lettering.

url = generate(
    prompt=open("teapot_prompt.txt").read(),
    image_urls=[
        "https://your-cdn.example.com/teapot.jpg",   # изображение 1: основной объект
        "https://your-cdn.example.com/cabin.jpg",    # изображение 2: сцена
        "https://your-cdn.example.com/street.jpg",   # изображение 3: только палитра
    ],
    resolution="1K", aspect_ratio="3:2",
)

flux-3-image, три референсных изображения, 3:2, $0.048. Референсные изображения не увеличивают стоимость.

Шпаргалка по параметрам

Поле	Значения	Описание
prompt	строка, обязательно, до 5000 символов	Опишите сцену или укажите, что изменить и что сохранить
image_urls	1–10 публичных ссылок, необязательно	Если не передавать — генерация из текста
resolution	768 / 1K / 1.5K / 2K / 4K, по умолчанию 1K	Определяет цену; фактические ширина и высота зависят от формата
aspect_ratio	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, по умолчанию auto	Для фиксированных макетов выбирайте соотношение явно
safety_tolerance	0–4, по умолчанию 2	0 — самый строгий
grounding	логическое, по умолчанию true	Поиск в вебе и изображениях перед генерацией

Что учесть перед запуском в продакшен

• Всегда указывайте resolution. Случайно поставите 4K — и одно изображение обойдётся уже не в $0.048, а в $0.607.
• Проверяйте и fail, и failed. В документации указано failed, но проверять оба надёжнее.
• Используйте callback вместо опроса: на том же уровне, что input, добавьте "callback": {"url": "https://your-app.example.com/hiapi/callback"} и дедуплицируйте по taskId.
• Сразу сохраняйте результат. output[0].url имеет срок действия — скачивайте вовремя или выбирайте постоянное хранилище при создании задачи.
• Передавайте заголовок Idempotency-Key: при повторной попытке с тем же Key задача создастся только один раз.

Частые вопросы

Сколько изображений выдаёт одна задача?

1. Если нужно несколько вариантов, отправляйте отдельные задачи.

Можно ли выбрать PNG или JPEG?

Эта модель не предоставляет выбор формата. Если нужен определённый формат, конвертируйте после скачивания.

Когда отключать поиск в интернете?

Когда у вас уже есть свои референсные изображения и направление творчества определено. Укажите grounding: false — цена не изменится.

Списываются ли деньги при неудачной генерации?

Нет. Оплата только за успешно сгенерированное изображение.

Цены по тарифам см. в ценах FLUX.3 Image API, больше промптов — в примерах промптов FLUX.3 Image, сравнение с предыдущим поколением на тех же промптах — в FLUX.3 Image vs FLUX.2. Также можно сразу сгенерировать этот кедровый домик на странице модели.