はじめに
元画像を 1 枚送り、欲しい結果を書きます。強度で出力が元画像からどこまで離れるかが決まり、白黒のマスクを加えると白い部分だけが描き直され、残りはそのまま保たれます。FLUX.1 [dev] 向けに学習した LoRA ファイルを最大 3 つ読み込め、料金は 1 枚ごとの一律で、フィルターはかかりません。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | テキストから画像と画像編集（強度、任意のインペイント用マスク）、いずれも LoRA 対応 |
| ベースモデル | FLUX.1 [dev]。Black Forest Labs の 120 億パラメーターの Rectified Flow Transformer |
| LoRA の入力 | 最大 3 要素。各要素は {path, scale}。path は .safetensors ファイルへの直接の HTTPS URL |
| LoRA の強度 | 要素ごとに 0〜4（既定は 1） |
| ガイダンス | 0〜20（既定は 3.5） |
| 出力サイズ | 約 100 万画素。1:1 で 1024 x 1024、16:9 で 1344 x 768、21:9 で 1536 x 640 |
| アスペクト比 | 1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9、9:21 |
| 出力形式 | JPEG（既定）、PNG、WebP |
主な機能とハイライト
レンダーではなく、写真
Super Realism LoRA と、雨の窓辺の深夜のボックス席。暖かいペンダントランプの下で身を寄せ合う 2 人の男性。肌、生地、窓の光が写真のように見えます。
トリガー 1 つで雑誌のルックに
「MJ v6」と Midjourney 風の LoRA が、FLUX につやのあるエディトリアルの仕上がりを与えます。大理石の階段で横から光を受ける、バックレスの赤いサテンのガウン。
表現媒体をまるごと差し替える
手足の長いカートゥーン LoRA を 1.2 で使うと、同じモデルがピンナップのイラストレーターに変わります。赤い傘、濡れた石畳の通り、誇張されたプロポーション。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 返ってきてほしい画像全体を書きます。マスクを使う場合は、白い部分に描きたいものを書いてください。 1 文字以上 · 5000 文字以内 |
image_url | はい | 編集したい画像です。結果は形を保ったまま約 70 万画素で返ります。 |
mask_url | いいえ | 任意です。元画像と同じサイズの白黒画像で、白い部分はプロンプトに沿って描き直され、黒い部分はそのまま残ります。 |
strength | いいえ | 元画像からどこまで離れるかで、0〜1（既定 0.8）です。マスクを使うときは、白い部分が確実に変わるよう 0.9〜1 にしてください。 |
loras | いいえ | FLUX.1 [dev] 向けに学習した {path, scale} を最大 3 件指定できます。scale は 0〜4 で、1 が標準です。 デフォルト値: |
guidance_scale | いいえ | 結果がプロンプトにどれだけ従うかで、0〜20（既定 3.5）です。リアル系の LoRA は少し下げたほうが自然に見えることがよくあります。 |
steps | いいえ | ノイズ除去のステップ数で、1〜50（既定 28）です。多いほど生成に時間がかかります。 |
output_format | いいえ | 既定は JPEG で、必要なら PNG か WebP も選べます。料金は変わりません。 |
seed | いいえ | 強度やマスクを調整するあいだ、結果を比べやすくします。同じ seed でも同一の画像になるとは限りません。 |
料金
$0.018 / 枚
1 枚ごとの一律料金です。マスク、強度、ステップ数、LoRA に追加料金はかかりません。
ユースケース
見つけた LoRA をそのまま
欲しいルックが Hugging Face やコミュニティハブに FLUX の LoRA としてあるなら、ここで普通の API 呼び出しとして動かせます。ファイルのリンクを貼り、scale を決め、プロンプトを書くだけです。
ファッションやエディトリアルの静止画
リアル系や雑誌風の LoRA なら、大理石の階段に立つバックレスのガウンも、雨の窓辺の深夜のボックス席も、説得力のある光と肌の質感で描けます。
スタイルをそろえたキャンペーン
カートゥーン、ピンナップ、イラストの LoRA で、1 つのプロンプトテンプレートを 9 種類のアスペクト比にわたる統一されたシリーズにできます。
規制なしの静止画
規制のない LoRA も審査なしで読み込め、出力にフィルターもかかりません。そうした自由を求めるユーザーのいるプラットフォームに向いています。
プロンプトガイドと実践のヒント
LoRA のトリガーを調べる
FLUX の LoRA の多くは、「Super Realism」や「MJ v6」のようなトリガーフレーズをモデルカードに記載しています。それをプロンプトの冒頭に置き、続けて画を説明してください。
リアル系 LoRA ではガイダンスを調整
ガイダンスの既定は 3.5 です。リアル系 LoRA は 2 から 3.5 のあたりのほうが自然に見えることが多く、値を上げすぎると、つやが強くシャープすぎる仕上がりに寄っていきます。
強いスタイルには scale を上げる
スタイル LoRA の中には、scale を 1 より上げないと効きが出ないものもあります。当社のカートゥーンの例は 1.2 で動かしました。1 から始め、0.2 刻みで動かしてください。
ファイルが公開されているか確かめる
.safetensors ファイルを直接ダウンロードできるリンクを使ってください。アクセス制限のあるリポジトリは HTTP 401 を返し、画像が作られる前にリクエストが失敗します。
はじめに
FLUX.1 Dev LoRA 画像編集は、Black Forest Labs の FLUX.1 [dev] で元画像を 1 枚作り変えます。プロンプトと、自分で用意した LoRA ファイル最大 3 つで方向を決めます。マスクなしでは画面全体のスタイルを変え、0〜1 の強度で元画像からどこまで離れるかを決めます。白黒のマスクを使うと白い部分だけを描き直し、残りはそのまま保ちます。結果は JPEG、PNG、WebP のいずれかで一律料金で返り、フィルターはかかりません。
手元の素材でモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 全体か一部を変えたい画像 | FLUX.1 Dev LoRA 画像編集 |
| 文章の説明だけ | FLUX.1 Dev LoRA テキストから画像 |
主な機能とハイライト
マスクによるインペイント
変えたい部分を白、それ以外を黒で塗ります。当社のテストでは、スタジオ撮影の人物の上半身にマスクをかけると、その部分だけが変わり、顔、髪、ズボンはそのまま残りました。
読みやすい強度
既定の 0.8 はポーズと構図を保ち、0.95 では顔も含めてほぼすべてが描き直されます。マスクを使うときは 0.9〜1 にすると、白い部分が確実に変わります。
無修正、自分のウェイトで
元画像、プロンプト、ウェイト、結果のいずれもフィルターされません。強度 0.95 では、スタジオポートレートは当社の最も強いテストの指示どおりに編集され、規制のない LoRA を使うかどうかは問いませんでした。
ユースケース
写真の一部だけを変える
衣装、背景、小物を差し替え、ほかはそのままにできます。商品のバリエーション、衣装合わせ、ポートレートのレタッチなどに使えます。
コミュニティの LoRA でスタイルを変える
1,000 以上ある FLUX の LoRA のどれかに写真を通せば、構図を保ったままフィルム調、エディトリアル調、イラスト調に変えられます。
プロンプトガイドとコツ
指示ではなく結果を書く
完成した画像に何が写っているべきかを書きます。マスクを使う場合は、白い部分に入るものだけを「黒いベルベットのトップス、やわらかいスタジオ光」のように書いてください。
マスクの硬い縁をぼかす
硬い長方形のマスクは、残した部分との境目に継ぎ目が見えます。マスクの縁をぼかすか、置き換えたい物の輪郭に沿って塗ってください。
0.8 から始め、0.05 ずつ動かす
元画像が透けて見えるなら強度を上げ、顔が変わってしまうなら下げます。比べるあいだは seed を固定し、変わるのが強度だけになるようにしてください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-1-dev-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
