Руководство по API FLUX 3 Image Klein: цены по пяти разрешениям, параметры и примеры вызова

Что такое FLUX 3 Image Klein

FLUX 3 Image Klein — лёгкая модель изображений из серии FLUX 3 от Black Forest Labs. В HiAPI у неё только один ID модели: flux-3-image-klein, и для генерации изображения по тексту, и для редактирования по референсам используется он. Если указать только промпт, получится текст-в-изображение; если добавить image_urls, модель изменит кадр по референсам или объединит стили нескольких изображений.

Её сильные стороны — низкая цена и много вариантов: пять разрешений от 768 до 4K, что подходит для пакетной генерации и процесса «сначала черновик в малом размере, потом финал в большом».

Цена: по разрешению, за изображение

• 768: $0.0092 / изображение
• 1K (по умолчанию): $0.0103 / изображение
• 1.5K: $0.0126 / изображение
• 2K: $0.016 / изображение
• 4K: $0.0412 / изображение

За референсные изображения доплата не берётся: с 1 и с 10 изображениями цена одна. Уменьшение steps тоже не снижает цену — она зависит только от resolution. При неудаче задачи средства возвращаются полностью.

Например: 50 стилевых черновиков в разрешении 768 обойдутся в $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. При фиксированном seed с теми же параметрами модель постарается воспроизвести похожий результат; если не указан — случайный.
• safety_tolerance: 0–4, по умолчанию 2. Чем больше число, тем мягче модерация.
• output_format: jpeg (по умолчанию) или png.

Примеры запросов

Задачи с изображениями асинхронны: сначала создаётся задача, затем опрашивается результат. model указывается на верхнем уровне, остальные параметры — внутри input.

Генерация по тексту, 2K, вертикальное изображение 4:5, фиксированный seed:

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"
  }
}

После успешного создания задачи опрашивайте результат через GET https://api.hiapi.ai/v1/tasks/{taskId} с полученным ID задачи, а после успеха возьмите адрес изображения из вывода.

Рекомендации по использованию

• Сначала мелко, потом крупно: проверяйте промпт в 768 или 1K с фиксированным seed, а после удачного результата поменяйте только resolution на 2K или 4K и сгенерируйте ещё раз.
• Пакетные варианты: один и тот же промпт с разными seed даёт набор кандидатов с разной композицией, но единым стилем.
• При редактировании явно указывайте, что сохранить: при использовании референсов опишите в промпте, что нужно сохранить, а что изменить, — это стабильнее, чем просто описывать целевой кадр.

Текущие ограничения

• Каждый вызов возвращает одно изображение.
• Не более 10 референсных изображений; они должны быть доступны по публичным адресам http(s).
• Нет опции прозрачного фона; png — это лишь другой формат без потерь.