FLUX 3 Image API
Roko предоставляет FLUX 3 Klein через Kie AI под ID flux-3-image. Без референсов запрос создаёт изображение, с референсами автоматически выбирает редактирование. Доступны 1K, 2K и 4K, от 1 до 4 результатов за запрос.
- Публичный ID модели
flux-3-image- Уровни вывода
1K / 2K / 4K (1K по умолчанию)- Биллинг
За запрос по разрешению- Эндпоинт
POST /v1/images/tasks- Снимок каталога
Что такое FLUX 3 Image?
Публичный ID flux-3-image сейчас использует FLUX 3 Klein через Kie AI. Полный набор функций API FLUX 3 Image от BFL здесь не предоставляется.
Используйте один ID: без референсов создаётся новое изображение, а при передаче 1–10 публичных URL автоматически выбирается редактирование.
Выберите 1K, 2K или 4K и 1–4 результата. Отправьте асинхронную задачу и опрашивайте её статус. Стоимость зависит от разрешения и числа успешно полученных изображений.
Ключевые возможности
Генерация по тексту
Опишите объект, фон и стиль без ручного выбора модели у поставщика.
Редактирование по референсам
Передайте 1–10 референсов и укажите, что изменить и сохранить. Проверьте результат вручную.
Несколько результатов
n принимает 1–4; расчёт ведётся по успешным результатам.
Три разрешения
Выберите 1K, 2K или 4K и поддерживаемое соотношение сторон.
Цены на API FLUX 3 Image
Цены берутся из текущего каталога Roko и списываются за изображение по выбранному разрешению. На дату проверки они совпадали с стандартным прайсом Kie AI, но цены и акции провайдера не определяют списание Roko; сверяйтесь с оценкой и итоговым расчётом Roko.
| Разрешение | Цена | Единица |
|---|---|---|
| 1k | $0.01 | за изображение |
| 2k | $0.016 | за изображение |
| 4k | $0.036 | за изображение |
Примеры стоимости
Уровень по умолчанию — стандартная стоимость веб- и соцматериалов.
Расчёт по успешным результатам. Пример использует текущий снимок цен.
Параметры и поддерживаемый объём
Поля соответствуют текущему подключению Kie. Для референсов нужны публичные HTTP / HTTPS URL. Специальные параметры размещения по рамкам, grounding и safety_tolerance не предоставляются.
| Параметр | Значения | Примечания |
|---|---|---|
prompt | textarea | Опишите изображение, которое нужно создать, или изменения для референсов. · Обязательно |
images | url · 1–10 | Укажите до 10 публичных HTTP / HTTPS URL изображений. Base64 и браузерные адреса blob: не принимаются. · Опционально |
aspect_ratio | auto / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 9:21 | При редактировании auto следует референсу. Для генерации по тексту auto или пропуск означают 1:1. · По умолчанию: auto · Опционально |
resolution | 1k / 2k / 4k | Выбирает доступный для модели уровень разрешения; значение может напрямую влиять на цену. · По умолчанию: 1k · Опционально |
n | 1–4 | Количество изображений за один запрос; больше результатов — выше расходы. · По умолчанию: 1 · Опционально |
output_format | png / jpeg / webp | Формат файла сгенерированных изображений: png или jpeg. · По умолчанию: png · Опционально |
enhance_prompt | boolean | Опционально |
seed | integer | Опционально |
Вызов FLUX 3 Image через Roko API
Работайте через асинхронные задачи: отправьте задачу, получите task_id, затем опросите результат. Не exposing ключ API в клиентском коде.
Отправить генерацию
curl https://api.rokoapi.com/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
-d '{
"model": "flux-3-image",
"prompt": "A ceramic mug on a white studio background, soft side lighting.",
"aspect_ratio": "16:9",
"resolution": "2k"
}'Запросить задачу восстановления
curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $API_KEY"POST /v1/images/tasks возвращает 202 с task_id; после завершения генерации запрашивайте GET /v1/tasks/{task_id} для результата или причины сбоя. Idempotency-Key должен быть уникальным; повтор с тем же ключом возвращает исходную задачу без повторного списания.
Подходящие сценарии
Эскизы товарных сцен
Опишите товар, свет и фон; сначала проверьте композицию в 1K.
A ceramic mug on a white studio background, soft side lighting.
Изменение фона и цвета
Добавьте референсы и точные инструкции, не предполагая неизменность остальных пикселей.
Change the mug to blue while keeping its shape and the white background.
Композиция из нескольких референсов
Объясните, какой объект, стиль или окружение задаёт каждый референс.
Use the product from image 1 and the background from image 2.
Подбор вариантов
Запросите до четырёх результатов через n, затем проверьте и выберите вариант.
Create alternative studio compositions of a ceramic mug.
Ограничения, которые важно знать
- Принимаются 1–10 публичных HTTP / HTTPS URL; Base64, Data URL и адреса blob: не поддерживаются.
- Доступны девять фиксированных соотношений сторон. Для редактирования можно использовать auto; при генерации по тексту auto или пропуск дают 1:1.
- Подключение Klein не гарантирует точное сохранение пикселей вне области правки и не предоставляет специальные настройки компоновки или веб-поиска полной версии API.
- Отправка подтверждает лишь приём задачи. Дождитесь конечного статуса и проверьте изображение перед использованием.
FLUX 3 Image или другая модель изображений?
Выбирайте по задаче, ограничениям референсов, разрешению и текущим ценам каталога. Сравнительные испытания качества и скорости здесь не проводились.
Все модели →FAQ по FLUX 3 Image
Какой ID модели использовать для FLUX 3 Image?
Используйте публичный ID Roko API — flux-3-image, как указано, в поле model.
Сколько стоит FLUX 3 Image API?
Оплата за изображение по выбранному разрешению: $0.008 на 1K, $0.0125 на 2K, $0.0325 на 4K. На дату проверки значения совпадали с стандартным прайсом Kie AI, но списание Roko определяется оценкой проекта и итоговым расчётом при отправке.
Нужны разные ID для генерации и редактирования?
Нет. Используйте flux-3-image: без референсов для генерации, с референсами для автоматического выбора редактирования.
Как передать референсы?
Передайте 1–10 публичных HTTP / HTTPS URL в image_urls или images. Также поддерживаются image и input_reference.
Какие разрешения и соотношения сторон доступны?
1K, 2K и 4K; фиксированные соотношения: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 и 9:21. При редактировании доступно auto, для генерации по тексту auto означает 1:1.
Через какой эндпоинт вызывать FLUX 3 Image?
Отправляйте асинхронные задачи через POST /v1/images/tasks, получайте task_id и опрашивайте GET /v1/tasks/{task_id} для результата или причины сбоя.
Это полная версия API BFL?
Эта маршрутизация использует FLUX 3 Klein через Kie AI. Специальные параметры размещения по рамкам и веб-поиска не предоставляются; нельзя предполагать доступность всех функций полной версии.
Сколько изображений можно запросить?
n принимает значения 1–4, по умолчанию 1. Расчёт зависит от числа успешных результатов и выбранного разрешения.