Flux 画像生成

POST /flux/v1/ を呼び出してプロンプトから Flux 画像を生成し、リンクの有効期限が切れる前に get_result でステータスを追跡します。

POST /flux/v1/{model}

flux generate image

cURL

curl --request POST \
  --url https://api.cometapi.com/flux/v1/{model} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Hello"
}
'

200

{
  "id": "<string>",
  "polling_url": "<string>"
}

​

概要

/flux/v1/\{model\} エンドポイントは、Black Forest Labs の Flux モデルファミリーを使用して、テキストプロンプトから高品質な画像を生成します。URL パス内のモデル名を差し替えるだけで、異なる Flux バリアントを切り替えられます。

Flux シリーズのモデル間ではパラメータ一覧に大きな違いがあるため、詳細な使用方法については公式ドキュメントを参照してください。ここで示しているパラメータ一覧は参考用です。

生成後は、/flux/v1/get_result エンドポイントを使用して、生成された画像を取得したり、処理状況を監視したりできます。

BFL のサービスが返す画像 URL の有効期限は約 10 分 です。生成結果は速やかに保存してください。

承認

Authorization · string · header · 必須

Bearer token authentication. Use your CometAPI key.

ヘッダー

Content-Type · string

Must be application/json.

パスパラメータ

model · string · 必須

Flux model variant to use, e.g. flux-pro-1.1, flux-pro, flux-dev, flux-pro-1.1-ultra.

ボディ

application/json

prompt · string · デフォルト: Hello · 必須

Text prompt describing the image to generate.

image_prompt · string

URL of a reference image to guide the generation style or content.

width · integer

Output image width in pixels. Must be a multiple of 32. Range varies by model.

height · integer

Output image height in pixels. Must be a multiple of 32. Range varies by model.

steps · integer

Number of diffusion steps. Higher values improve quality but increase latency.

prompt_upsampling · boolean

When true, automatically enhances the prompt for more detailed results.

seed · integer

Random seed for reproducible outputs. Omit for random generation.

guidance · number

Guidance scale controlling how closely the output follows the prompt. Higher values increase prompt adherence.

safety_tolerance · integer

Safety filter tolerance level. Higher values are more permissive. Range: 0–6.

interval · integer

Diversity interval. Higher values produce more varied outputs at the cost of prompt adherence.

output_format · string

Output image format. Supported values: jpeg, png.

webhook_url · string

URL to receive a POST notification when the task completes.

webhook_secret · string

Secret string included in webhook payloads for request verification.

レスポンス

200 - application/json

OK

id · string

polling_url · string