Создавайте с CometAPIНужен один API для нескольких моделей?Протестируйте рабочий процесс в Playground, затем создайте API-ключ, когда модель и стоимость подойдут для вашего сценария.
Используйте FLUX 3 Image в CometAPI для генерации и редактирования. Узнайте о параметрах изображений, обработке асинхронных заданий, примерах промптов и ценах.
Deon GoodwinКоманда исследователей AI-моделей и API
Создавайте продуктовые фотографии, постеры и правки на основе референсов с помощью FLUX 3 Image, доступного через CometAPI как flux-3-image, с ценами от $0.0384 за запрос. Это руководство проведет вас через выбор настроек изображения, подготовку запроса, обработку асинхронной задачи и проверку готового изображения. Вам понадобятся аккаунт CometAPI, ключ API и конфигурация запроса FLUX 3 Image, предоставленная для вашего аккаунта.
Основные выводы
Выбирайте text-to-image для новых композиций и редактирование с опорой на референсы, когда продукт или объект должны оставаться узнаваемыми.
Используйте небольшой черновик для проверки композиции перед рендером финального большого изображения.
Применяйте учетные данные CometAPI и модель-специфичную схему запроса; BFL-нативные ключи и примеры относятся к другой интеграции.
Проверено на ясность, указание источников и актуальную терминологию API.
Оценивайте стоимость по соответствующему тарифу CometAPI, затем считайте расходы на один принятый результат.
Выполните полный цикл: отправка, получение результата, загрузка и визуальная проверка — прежде чем запускать пакет.
Что такое FLUX 3 Image API?
FLUX 3 Image — модель Black Forest Labs для создания и редактирования статичных изображений. Текстовый промпт описывает новую сцену; референсные изображения предоставляют визуальный материал для сохранения, комбинирования или изменения. Для e-commerce это может означать разработку продуктовой сцены по брифу, а затем повторное использование утвержденного продукта с изменением окружения.
Выберите рабочий процесс до написания промпта. Для нового визуала укажите объект, окружение, свет и кадрирование. Для правки определите исходное изображение, назовите изменение и перечислите детали, которые должны остаться неизменными. Для композиции с несколькими референсами назначьте каждому роль, чтобы идентичность продукта и визуальный стиль не вступали в конфликт.
Характеристики FLUX 3 Image и параметры API
Планируйте изображение с помощью настроек ниже. Управление моделью следует BFL FLUX 3 Image API reference; аутентификация и маршрутизация запроса — вашей интеграции CometAPI. Используйте имена полей, принимаемые вашим маршрутом FLUX 3 Image в CometAPI.
Возможность / настройка
Что контролирует
Как использовать в CometAPI
Идентичность модели
FLUX 3 Image; ID в каталоге flux-3-image
Используйте модель-специфичный маршрут и схему маршрутизации из примера вашего аккаунта.
Генерация / промпт
Сцена, композиция или инструкция для правки
Начинайте с одного четко обозначенного объекта и одного целевого результата.
Референсы / native images
Упорядоченный список из 1–10 референсов, передаваемых как HTTP(S) URL или base64 в нативном API.
Уточните имя поля, формат ввода и лимит референсов на шлюзе.
Соотношение сторон / native aspect_ratio
Пропорции холста. При auto приоритет у соотношения, указанного в промпте; иначе правки сохраняют кадрирование первого референса.
Выберите соотношение для формата поставки и подтвердите допустимые значения.
Разрешение / native resolution
Нативные уровни: 768sq, 1k (по умолчанию), 1.5k, 2k и 4k. Точные размеры зависят от соотношения сторон.
Для правок match_input сохраняет размер первого референса, уменьшенный до 4 MP, если он больше; явный aspect_ratio выбирает ближайший уровень. Явные width и height имеют приоритет.
Точные размеры / width + height
Укажите оба целых числа, каждое 256–6256 px. Они переопределяют resolution и aspect_ratio. Площадь ограничена 16,822,272 px, или 4,194,304 px при использовании референсов.
Используйте точные размеры для фиксированного холста, например 1024 × 1280. Убедитесь, что ваш маршрут CometAPI принимает эти нативные параметры.
Управление компоновкой
Подсказки по размещению элементов с помощью ограничивающих прямоугольников
Используйте задокументированный синтаксис layout, когда важно точное размещение.
Точечные правки
Изменения выделенных объектов или областей
Выберите размеры одним из трех способов: уровень resolution плюс aspect ratio, width плюс height для точного холста или match_input для правки. Держите исходный референс под рукой, чтобы сравнить кадрирование и детали после генерации. Нативная конечная точка отклоняет неподдерживаемые поля; используйте схему для вызываемого маршрута.
FLUX.2 и FLUX 3 Image: сравнение
Параметр
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
Практическая оценка
Сценарий
Сильный text-to-image/редактирование, семейства вариантов
Детальная композиция и правки с сохранением пикселей
Доступны через CometAPI как FLUX 2 PRO и FLUX 2 MAX
Доступна через CometAPI как flux-3-image
Валидируйте модель-специфический запрос перед сменой боевого маршрута
Оценка
Используйте точный вариант, задеплоенный сегодня
Запускайте тот же промпт и набор референсов
Сравните принятые результаты и общую стоимость рабочего процесса
Сохраняйте текущую интеграцию FLUX.2 как базу сравнения при оценке FLUX 3 Image. Пропустите одинаковые брифы и референсы через оба процесса, затем сравните принятые результаты, время и общую стоимость.
Как сгенерировать изображение с FLUX 3 Image API в CometAPI?
POST https://api.cometapi.com/flux/v1/flux-3-image
Аутентификация использует Bearer-токен (стиль CometAPI). Запросы асинхронные по умолчанию.
3. Базовый пример text-to-image (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Опросите до тех пор, пока status не станет "Ready". URL изображения появится в result.sample (скачайте сразу: временные подписанные ссылки истекают).
Для синхронного ожидания в том же запросе добавьте "async": false в тело (соединение останется открытым; используйте увеличенный таймаут клиента).
5. Пример на Python (отправка + опрос)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image поддерживает чистый text-to-image и редактирование/мульти-референс в одном и том же endpoint — просто добавьте images и опишите, как их использовать, в промпте (без отдельного поля “mode”).
Альтернатива: маршрут, совместимый с OpenAI
Можно также использовать унифицированный images endpoint с ID модели:
POST https://api.cometapi.com/v1/images/generations
(Нативный `/flux/v1/...` предпочтителен для полного набора параметров FLUX 3.)
### Советы
* Проверяйте текущую доступность и точные цены на странице модели [CometAPI Flux 3 Image](https://www.cometapi.com/models/flux/flux-3-image/).
* Всегда быстро скачивайте URL из `result.sample`.
* За актуальным списком параметров и примерами Playground обращайтесь к документации Flux в CometAPI и официальной справке FLUX 3 Image от Black Forest Labs.
Это зеркалирует официальный поток BFL при использовании аутентификации и инфраструктуры CometAPI.
## Как писать промпты для FLUX 3 Image? Примеры
### Пример: промпт для предметной съемки
Используйте этот промпт для первого теста предметной съемки.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Замените значение prompt в request.json этим брифом, сохранив тело запроса, ожидаемое вашим маршрутом CometAPI. Холст 4:5 подходит для вертикальной продуктовой композиции. Если ваш маршрут принимает нативные параметры размеров, 1024 × 1280 — точный вариант 4:5; указывайте оба значения вместе.
Начните с небольшого черновика и проверьте силуэт флакона, этикетку, отражения и наличие лишних объектов. Если важна точная идентичность продукта, используйте референс продукта, а не полагайтесь на восстановление по тексту. Зафиксируйте промпт и настройки вывода до изменения.
### Пример: типографика и макет постера
Промпт постера с явно указанным заголовком.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Используйте этот бриф как промпт в запросе CometAPI и выберите вертикальный холст. Начните с черновика, чтобы проверить позицию заголовка и расположение персонажей, затем увеличьте размер для финальной работы.
Точность букв — измеряемый критерий приемки. Проверьте каждую букву и знак пунктуации в итоговом разрешении; впечатляющие примеры из галереи не гарантируют нулевых ошибок на вашем конкретном бренд-тексте.
## Как редактировать изображения с референсами
Для правки опишите и желаемые изменения, и детали, которые нужно сохранить. Нативный FLUX 3 Image API принимает референсы в images; сопоставьте их с соответствующим полем ввода в вашем примере CometAPI. Поместите референс продукта первым и сохраняйте этот порядок в промпте.
### Правка одного изображения: сменить фон, сохранить продукт
Держите edit.py рядом с submit.py, poll.py и download.py. Установите PRODUCT_IMAGE_URL на общедоступный HTTPS-URL фото продукта, затем выполните python edit.py. Пример ниже требует маршрута, принимающего нативный массив images. Используйте тело запроса для правок без конфликтующих полей исходного изображения и измените сопоставление, если ваш пример CometAPI использует иное поле ввода. Чтобы возобновить сохраненную задачу правки, выполните python poll_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Выберите четкое фото продукта с читаемой этикеткой и ясным силуэтом. Передайте его в формате входа изображения, поддерживаемом вашим маршрутом CometAPI. Если маршрут поддерживает нативный параметр resolution, используйте match_input, чтобы сохранить кадрирование и размер референса в пределах ограничений модели для правок.
[BFL gallery](https://bfl.ai/models/flux-3-image) демонстрирует локализованную правку путем добавления двух дайверов. Эти официальные “до/после” материалы иллюстрируют, что проверять; они не являются результатами запроса через CometAPI для этой статьи.
Официальный пример правки BFL, до: исходная подводная сцена с одним дайвером.
Официальный пример правки BFL, после: в сцену добавлены два дайвера. Проверьте неизменившийся фон, а также новые объекты.
### Правка с несколькими референсами: объединить стиль и идентичность продукта
Оставляйте продукт первым, а референс освещения/стиля — вторым. Установите PRODUCT_IMAGE_URL и STYLE_IMAGE_URL, сохраните код ниже как multi_edit.py рядом с тремя клиентскими файлами и выполните python multi_edit.py. Этот пример требует маршрута, принимающего как минимум два референса в images. Начните с тела запроса для правок без конфликтующих полей исходника. Возобновите сохраненную задачу командой python poll_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Прикрепляйте оба референса в модель-специфичном формате CometAPI. Сначала проверьте, сохранил ли продукт свою идентичность; затем оцените, передал ли второй референс желаемые свет и цвет. Если он также вносит нежелательные объекты или надписи, упростите этот референс или сделайте промпт более явным.
## Как использовать ограничивающие прямоугольники для контроля компоновки
Применяйте боксы, когда флакон и заголовок должны занимать предсказуемые области. Напишите описание сцены с ID для каждого элемента, затем добавьте к промпту массив JSON. Формат BFL использует bbox в порядке [top, left, bottom, right] на сетке 0–1000; боксы указываются внутри промпта, а не в отдельном поле API.
Пример ниже резервирует место для заголовка над флаконом. Сохраните вертикальные настройки вывода в request.json и сохраните этот файл как layout.py рядом с submit.py. Выполните python layout.py, затем python poll_download.py layout-task.json. Используйте маршрут, поддерживающий этот синтаксис компоновки; проверьте, заняли ли флакон и заголовок нужные области.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Сохраняйте соотношение сторон согласованным с макетом. Боксы направляют размещение, а не обрезают объект по жесткой границе. Проверьте написание и интерлиньяж заголовка в сохраненном изображении; финальные бренд-надписи добавляйте в графическом редакторе, когда нужна точная типографика.
## Сколько стоит FLUX 3 Image API?
CometAPI предлагает FLUX 3 Image от [$0.0384 за запрос](https://www.cometapi.com/models/flux/flux-3-image/) (9 ноября 2026 г.). Используйте эту стартовую ставку для первичного бюджета, затем примените ставку, указанную для вашей конфигурации. Примеры ниже предполагают, что каждый тарифицируемый запрос идет по стартовой цене.
| Тарифицируемые запросы | Предполагаемая ставка за запрос | Показательная стоимость |
| ---------------------- | -------------------------------- | ----------------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Перед запуском пакета проверьте ставку для выбранной конфигурации и аккаунта. Публичная стартовая цена не устанавливает стоимость для каждого разрешения или опции правок. Отслеживайте отклоненные креативы наряду с одобренными: если вы потратили $3.84 на 100 запросов и приняли 80 результатов, стоимость API на один принятый результат составит $0.048, без учета ручной проверки и хранения. Это иллюстративный расчет, а не измеренная конверсия.
### Выбор разрешения по рабочим процессам
| Рабочий процесс | Первый тест | Критерий утверждения |
| ---------------------------- | -------------------------------------------- | -------------------------------------------------- |
| Исследование промптов | Минимально полезный поддерживаемый уровень | Композиция и размещение объектов |
| Товарные изображения | Черновик с планируемым кропом | Геометрия продукта, этикетки и детали по краям |
| Кампания/редакционная графика| Черновик, затем увеличение после утверждения | Типографика и детали в размер поставки |
| Правки по референсам | Поддерживаемая настройка под исходник | Неизменные области, идентичность продукта и освещение |
## Когда использовать FLUX 3 Video?
Используйте FLUX 3 Image для статичных активов: герой-продукт, постер, кадр кампании. Если нужен motion, посмотрите [FLUX 3 Video в CometAPI](https://www.cometapi.com/models/flux/flux-3/), с отдельным ID модели flux-3. Его [видеопроцесс](https://apidoc.cometapi.com/api/video/flux-3/create) использует параметры и биллинг для видео. Разделяйте запросы для изображений и видео; длительность, звук и кадры видео не относятся к запросу неподвижного изображения.
Для кампании с обоими форматами сначала утвердите композицию статичного кадра, затем отдельно подготовьте бриф для motion. Проверьте требования видеомодели к референсам, прежде чем использовать утвержденное изображение как исходник.
## Заключение
Начните с одного продуктового брифа и одного небольшого задания. Отправьте его через ваш маршрут FLUX 3 Image в CometAPI, сохраните ID задачи, получите готовое изображение и проверьте результат, прежде чем масштабировать. Используйте width и height, когда нужен точный холст, или match_input для правки по референсу, где поддерживается. Сопоставляйте общий расход с количеством принятых изображений, чтобы бюджет отражал пригодные результаты.
## SEO-метаданные
Meta title: Руководство по FLUX 3 Image API: генерация, редактирование и CometAPI
Meta description: Используйте FLUX 3 Image в CometAPI для генерации и редактирования. Узнайте про параметры изображений, асинхронную обработку задач, примеры промптов и цены от $0.0384 за запрос.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, редактирование изображений FLUX 3, цены FLUX 3, генерация по референсам, миграция с FLUX.2
URL slug: flux-3-image-api-guide
Сравнивайте исходник и результат в областях, которые должны остаться без изменений.
Аутентификация
Ключ API CometAPI для запросов к шлюзу
Следуйте заголовкам аутентификации из примера CometAPI; храните ключ на сервере.
Обработка результата
Асинхронная генерация: отправьте задачу, отслеживайте ее ID и получите готовое изображение.
Используйте шаблон на Python ниже, если ваш маршрут аккаунта следует задокументированному контракту задач CometAPI FLUX.
Ценообразование
Цены CometAPI начинаются от $0.0384 за запрос (9 ноября 2026 г.).
Используйте раздел о ценах ниже для примерного бюджета; подтвердите выбранную конфигурацию.
Дополнительные поля
Нативные и шлюзовые схемы отличаются между поколениями моделей
Нативный FLUX 3 Image принимает width и height. Не используйте seed или input_image от старой модели; для нативного ввода референсов применяйте images и следуйте схеме шлюза CometAPI.
