Как пользоваться FLUX.1 Kontext Max API? Первое изображение за 5 минут

TL;DR

• Что это: FLUX.1 Kontext Max от Black Forest Labs — генерация по тексту и редактирование одного изображения используют один и тот же ID модели. Уже доступен в HiAPI: откройте страницу модели и введите промпт, чтобы сгенерировать изображение; новым пользователям при регистрации дают 200 кредитов, это примерно 1,4 изображения.
• Сколько стоит: $0.0715 за изображение (143 кредита), генерация и редактирование по одной цене, за $10 получится около 139 изображений; за неудачные задачи предоплата возвращается.
• Как вызывать API: POST https://api.hiapi.ai/v1/tasks, в model укажите flux-1-kontext-max, после получения taskId опрашивайте статус или ждите callback, а результат скачивайте из data.output[0].url.

После запуска FLUX.1 Kontext Max часто спрашивают две вещи: можно ли при редактировании изменить только одну деталь и сколько времени займёт интеграция в собственный продукт. Сначала посмотрим на возможности, затем пройдём два пути освоения.

Что такое FLUX.1 Kontext Max и что в нём нового?

• Один ID модели обслуживает два типа задач. Если в input не передано изображение — это генерация по тексту, если передан input_image — это редактирование; код не нужно разделять на два набора.
• Редактирование выполняется по принципу «что изменить, что оставить». Можно менять материалы и стиль, добавлять и удалять элементы, цвета и освещение, текст на изображении; то, что не упомянуто в промпте, по возможности остаётся без изменений.
• Шесть форматов, при редактировании можно сохранить пропорции исходного изображения. Для aspect_ratio доступны 21:9, 16:9, 4:3, 1:1, 3:4, 9:16; при редактировании, если оставить поле пустым, вывод будет в пропорциях исходного изображения, а пиксели корректируются кратно 32 — 1280×720 превратится в 1328×752.
• Вывод в jpeg или png, примерно 1 миллион пикселей на изображение. Лимит prompt — 4 000 символов, китайский промпт автоматически переводится на английский перед генерацией.

Генерация по тексту, 16:9. Полный промпт — это та самая строка из curl ниже, её можно скопировать как есть.

Сгенерировать по этому промпту →

Два пути освоения: онлайн-проба или API?

Чтобы сначала увидеть результат — попробуйте онлайн, чтобы встроить в продукт — используйте API. Оба пути используют одну и ту же модель и одну и ту же цену.

Онлайн-проба (около 1 минуты)

1. Откройте страницу модели FLUX.1 Kontext Max или перейдите по ссылке под изображением выше — промпт подставится автоматически.
2. Зарегистрируйтесь или войдите; у нового аккаунта сразу есть 200 кредитов.
3. Выберите 16:9 и нажмите «Сгенерировать».
4. Если результат нравится — скачайте; если хотите отредактировать — на той же странице загрузите исходное изображение и напишите промпт для редактирования.

Интеграция через API (около 5 минут)

1. Создайте API Key (sk-...) в консоли HiAPI.
2. Создайте задачу через POST /v1/tasks, в ответе получите data.taskId.
3. Опрашивайте статус через GET /v1/tasks/{taskId} или ждите уведомления на callback.url; когда data.status станет success, скачайте изображение из data.output[0].url.

$0.0715 за изображение, за $10 получится около 139 изображений — достаточно, чтобы довести промпт до нужного результата. Полные параметры см. в документации на китайском.

Первое изображение: версия на curl

Создание задачи:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-1-kontext-max",
    "input": {
      "prompt": "A quiet reading corner by a tall window at golden hour: a linen armchair, a stack of art books and a ceramic cup on a walnut side table, warm afternoon light, soft shadows, editorial interior photography.",
      "aspect_ratio": "16:9",
      "output_format": "jpeg",
      "prompt_upsampling": false
    }
  }'

Возвращённый ID задачи находится в data.taskId:

{"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

Запрос результата:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-YOUR_KEY"

Обязателен только prompt. output_format по умолчанию jpeg, prompt_upsampling по умолчанию выключен, safety_tolerance по умолчанию 2 (0 — самый строгий).

Первое изображение: версия на Python

Создание, опрос и скачивание в одном фрагменте — подставьте свой Key и запускайте:

import requests, time

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer sk-YOUR_KEY"}

payload = {
    "model": "flux-1-kontext-max",
    "input": {
        "prompt": "A quiet reading corner by a tall window at golden hour: a linen armchair, a stack of art books and a ceramic cup on a walnut side table, warm afternoon light, soft shadows, editorial interior photography.",
        "aspect_ratio": "16:9",
    },
}

task_id = requests.post(API, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(2)

if data["status"] == "success":
    image_url = data["output"][0]["url"]
    with open("flux-1-kontext-max.jpg", "wb") as f:
        f.write(requests.get(image_url, timeout=60).content)
else:
    print(data.get("error"))

Режим редактирования: достаточно добавить input_image

Добавьте в input поле input_image, и тот же запрос превратится из генерации по тексту в редактирование. Возьмём то же изображение с уголком для чтения за исходное и заменим только кресло, добавив торшер:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-1-kontext-max",
    "input": {
      "prompt": "Change the linen armchair to a deep forest-green velvet armchair, add a slim brass floor lamp beside it, and keep the window, books, cup, table and afternoon light unchanged.",
      "input_image": "https://static.hiapi.ai/admin-assets/flux-1-kontext-max/2026/10/26/1793005013365-132a4d4eb55e0852-f-t2i-golden.jpg"
    }
  }'

input_image принимает URL изображения, доступного из интернета. При редактировании не указывайте aspect_ratio — вывод сохранит пропорции исходного изображения; для объединения нескольких изображений выберите редактирование изображений GPT Image 2, поддерживается 1–16 референсных изображений.

Как писать промпт для редактирования: сначала что изменить, затем что оставить

1. Изменение формулируйте одной четкой инструкцией. Конкретно указывайте объект и новое состояние: linen armchair заменить на deep forest-green velvet armchair.
2. Перечисляйте сохраняемое по пунктам. Окно, книги, чашка, стол, послеполуденный свет — пишите то, что важно сохранить на исходном изображении, и завершайте фразой keep ... unchanged.
3. Связанные изменения можно объединить в одном предложении. Заменить кресло и одновременно добавить латунный торшер — модель обработает это вместе; несвязанные правки отправляйте отдельно, так результат проще проверить.
4. При изменении текста на изображении сохраняйте и вёрстку. Например, заменить KYOTO на плакате на OSAKA и при этом указать, что макет, отступы и стиль шрифта остаются прежними.
5. Можно писать по-китайски. Система сначала переведёт на английский, затем сгенерирует; держите промпт в пределах 4 000 символов.

4 вещи, на которые стоит обратить внимание перед запуском

1. На сервере используйте callback. Добавьте в тело запроса "callback": {"url": "https://yourapp.com/webhook", "when": "final"} — по достижении задачей финального состояния уведомление придёт автоматически, и опрос не понадобится.
2. При тайм-ауте не повторяйте POST. Каждое создание — это новая задача и отдельная оплата; сначала сохраните taskId, а перед повтором выполните дедупликацию в своей системе.
3. Ссылки на результаты истекают. data.output[0].url — временная ссылка; скачивайте сразу после получения и переносите в собственное хранилище.
4. Пиксели выравниваются кратно 32. Если при редактировании оставить aspect_ratio пустым, пропорции исходного изображения сохранятся, а пиксели подстроятся кратно 32: 1280×720 даст 1328×752; если указать пропорцию, изображение обрежется или дополнится под неё.

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

Нужно ли менять модель для генерации по тексту и редактирования? Нет. Тот же flux-1-kontext-max, наличие или отсутствие input_image определяет путь, и цена такая же.

Сколько референсных изображений можно передать за раз? Одно. Для объединения нескольких изображений выберите редактирование изображений GPT Image 2, поддерживается 1–16 референсных изображений.

Можно ли использовать китайские промпты? Да. Лимит промпта — 4 000 символов, китайский автоматически переводится на английский перед генерацией.

Изменится ли формат после редактирования? Если не указать aspect_ratio, сохранятся пропорции исходного изображения, а пиксели скорректируются кратно 32; если указать — изображение обрежется или дополнится под указанную пропорцию.

Списываются ли деньги при неудачной задаче? Оплата идёт по количеству успешно сгенерированных изображений, каждый запрос возвращает 1 изображение, за неудачные задачи предоплата возвращается.

Скопируйте промпт с уголком для чтения из примера выше на страницу модели FLUX.1 Kontext Max, выберите 16:9, нажмите «Сгенерировать» один раз — посмотрите, как модель работает со светом и материалами, а затем решайте, стоит ли интегрировать её в проект.