Skip to main content
POST
Generate an image from a text prompt
右側のインタラクティブなプレイグラウンドはライブデバッグをサポートしています。Authorization ヘッダーに API Key を入力し(形式: 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 searchflux-2-max でのみ利用可能です — 時間に敏感な prompt でも、他のモデルではライブ検索は起動しません
すべての image API は 同期式 です。ポーリング用の task ID はなく、クライアントが切断されると、リクエストが課金されたままでも結果は失われます。このモデルでは十分に長いタイムアウトを設定してください。詳しくは Image API の基本とベストプラクティス を参照してください。

コード例

Python (OpenAI SDK ドロップイン)

Python (ネイティブ 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分後に期限切れになります
  • CORS は無効です — ブラウザの fetch はブロックされますが、<img src> のレンダリングは動作します
  • 本番サービスでは、必ずサーバー側で自分の OSS / CDN にダウンロードしてください
  • OpenAI の gpt-image-2b64_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)