Skip to main content
POST
Generate an image from a text prompt
Интерактивная песочница справа поддерживает отладку в реальном времени. Заполните свой API Key в заголовке Authorization (формат: Bearer sk-xxx), выберите модель и размер, введите prompt и отправьте.
Используйте эту страницу для «генерация изображения по тексту» — нужен только prompt, загрузка не требуется. Для редактирования или слияния нескольких референсов существующих изображений см. эндпоинт редактирования изображений.
⚠️ Ключевые отличия / неподдерживаемые параметры
  • URL результата действителен только 10 минутdata[0].url нужно скачать немедленно, истекшие URL возвращают 404
  • width / height должны быть кратны 16 — иначе возвращается 400
  • prompt_upsampling не поддерживается в FLUX.2 [klein] — игнорируется без предупреждения
  • Общий лимит пикселей — 4MP (~2048×2048) — превышение возвращает 400
  • grounding search только на flux-2-max — другие модели не запустят live search даже с prompt, чувствительными ко времени
Все image API работают синхронно — здесь нет task ID для опроса, и если ваше соединение будет разорвано, результат будет потерян, хотя запрос все равно тарифицируется. Установите достаточно большой timeout для этой модели; см. Основы и лучшие практики Image API.

Примеры кода

Python (подстановка OpenAI SDK)

Python (Native requests · с синтаксисом width/height)

cURL

Node.js (нативный fetch)

JavaScript в браузере (прямой рендер)

Справочник параметров

Поддерживаемые ID моделей

Подробные ограничения, допустимые значения и примеры видны в подсказках полей Playground справа. Все поля enum поддерживают выбор из выпадающего списка.

Формат ответа

⚠️ data[0].url действительно только 10 минут
  • URL размещен на delivery-eu.bfl.ai / delivery-us.bfl.ai, подпись истекает через 10 min
  • CORS отключен — браузерная fetch заблокирована, но <img src>-рендеринг работает
  • Production-сервисы должны скачивать на стороне сервера в свой OSS / CDN
  • В отличие от gpt-image-2 OpenAI (которая возвращает b64_json), FLUX возвращает только URL — без base64.
FLUX не возвращает поле usage (тарифицируется за изображение, а не за token). Фактическая тарификация следует таблице цен на этом сайте. Заголовок ответа x-request-id используется для трассировки обращений в поддержку.

Авторизации

Authorization
string
header
обязательно

API Key from the APIYI Console

Тело

application/json
model
enum<string>
по умолчанию:flux-2-pro
обязательно

FLUX model ID. For FLUX.2 prefer flux-2-pro / flux-2-max; legacy versions in the Historical Versions page.

Доступные опции:
flux-2-max,
flux-2-pro,
flux-2-flex,
flux-2-klein-9b,
flux-2-klein-4b,
flux-pro-1.1-ultra,
flux-pro-1.1,
flux-pro,
flux-dev
prompt
string
обязательно

Prompt, up to 32K tokens. Supports natural language, hex codes, and structured JSON.

Пример:

"A cinematic shot of a futuristic city at sunset, 85mm lens"

size
string
по умолчанию:1024x1024

OpenAI-style size string. Pick either size or width+height. Common: 1024x1024 / 1536x1024 / 1024x1536 / 1920x1080 / 1440x2048 / 2048x2048. Custom must satisfy: multiples of 16, 64×64–4MP.

Пример:

"1920x1080"

width
integer
по умолчанию:1024

BFL-native syntax, alternative to size. Must be a multiple of 16, between 64 and 2048.

Требуемый диапазон: 64 <= x <= 2048
Пример:

1920

height
integer
по умолчанию:1024

BFL-native syntax. Must be a multiple of 16, between 64 and 2048.

Требуемый диапазон: 64 <= x <= 2048
Пример:

1080

seed
integer

Fix for reproducibility — same seed + same other params yields the same result.

Пример:

42

safety_tolerance
integer
по умолчанию:2

Moderation level. 0 = strictest, 6 = most permissive, default 2.

Требуемый диапазон: 0 <= x <= 6
output_format
enum<string>
по умолчанию:jpeg

Output format.

Доступные опции:
jpeg,
png
prompt_upsampling
boolean
по умолчанию:false

Auto-expand the prompt. Not supported on FLUX.2 [klein] (silently ignored).

steps
integer
по умолчанию:50

Only flux-2-flex. Inference steps, max 50.

Требуемый диапазон: 1 <= x <= 50
guidance
number
по умолчанию:4.5

Only flux-2-flex. Guidance scale. 1.5–10, higher = closer to prompt.

Требуемый диапазон: 1.5 <= x <= 10
n
enum<integer>
по умолчанию:1

Number of images. Only 1 supported.

Доступные опции:
1

Ответ

Image generated

created
integer

Unix timestamp

Пример:

1776832476

data
object[]

Result array (single image per call)