flux-pro-1-0-fill-finetuned の技術仕様
flux-pro-1-0-fill-finetuned は、Black Forest Labs の FLUX.1 Fill [pro] ファインチューニング版の画像編集エンドポイントに対する CometAPI のプラットフォーム識別子です。入力画像に加えて別マスクまたはアルファマスクを与え、テキストプロンプトに基づいて指定領域のみを編集するインペインティングのワークフロー向けに設計されています。
モデル概要
- モデル ID:
flux-pro-1-0-fill-finetuned - 提供元 / 基盤モデルファミリ: Black Forest Labs FLUX.1 Fill [pro] finetune.
- 主要モダリティ: 画像から画像、画像編集、マスク付きインペインティング。
- 商用利用: CometAPI にて商用利用対応と記載。(cometapi.com)
- CometAPI 価格: クロール時点の CometAPI モデルページで 1 リクエストあたり $0.096。(cometapi.com)
ドキュメント記載のリクエスト入力
finetune_id: 適用するファインチューニング済みモデルの必須 ID。image: 必須の base64 エンコード済みソース画像。mask: オプションの白黒マスク。元画像にアルファマスクが含まれる場合は省略可。prompt: 希望する編集内容を記述するテキスト指示。finetune_strength: デフォルト 1.1、許容範囲 0 〜 2.0。steps: デフォルト 50、許容範囲 15 〜 50。guidance: デフォルト 60、許容範囲 1.5 〜 100。prompt_upsampling: より創造的なプロンプトの書き換えを行うためのオプションのブール値。seed: 再現性のためのオプション整数。output_format:jpegまたはpng、デフォルトjpeg。safety_tolerance: 0 〜 6 の整数、デフォルト 2。- 非同期配信サポート:
webhook_urlおよびwebhook_secretに対応。
ドキュメント記載のレスポンス項目
id: 生成タスク ID。polling_url: タスク状態の確認用 URL。cost、input_mp、output_mp: 利用状況および画像サイズ関連メタデータ。
flux-pro-1-0-fill-finetuned とは？
flux-pro-1-0-fill-finetuned は、パーソナライズドなインペインティングに特化した FLUX の画像編集モデルエンドポイントです。実運用では、高度な FLUX.1 Fill [pro] の編集ワークフローとユーザーが訓練したファインチューニングを組み合わせ、既存画像の選択領域のみを変更しつつ、被写体・製品・ブランド・スタイルの整合性を維持できます。
Black Forest Labs は、FLUX Pro のファインチューニングシステムを、特定の人物、ペット、衣類、ステッカー、ブランド、ビジュアルスタイルなど、ユーザー自身のサンプル画像を用いて FLUX.1 [pro] をカスタマイズする手段と説明しています。また、FLUX.1 Fill [pro] とファインチューニングを組み合わせることで、所定の画像に対する反復的な編集のためのパーソナライズド・インペインティングが可能になるとしています。
そのため、既にファインチューニング済みの FLUX Pro コンセプトモデルを保有している場合、このエンドポイントは新規画像をゼロから生成するのではなく、学習済みコンセプトをマスク領域内に選択的に適用できる“編集版”として機能します。これは、とりわけ広告クリエイティブのリフレッシュ、製品レタッチ、キャラクター一貫性のある編集、ブランド資産の改訂、ローカライズ済み画像の更新などに有用です。これは、エンドポイントの挙動と Black Forest Labs によるファインチューニングの説明に基づく推測です。
flux-pro-1-0-fill-finetuned の主な機能
- パーソナライズド・インペインティング: 既存画像のマスク部分のみを編集し、ファインチューニング済みコンセプトモデルを用いて、カスタム被写体やスタイルに整合する結果を得ます。
- ファインチューニング対応編集:
finetune_idが必須で、事前に訓練済みの FLUX Pro ファインチューニングを編集時に適用する設計です。 - マスクベースの制御: 個別マスクとアルファマスクの両ワークフローをサポートし、正確なオブジェクト置換、クリーンアップ、強化、領域別の再設計を実用的に行えます。
- プロンプト主導の変換: 自然言語のプロンプトで選択領域内の変更内容を指定し、手動合成なしで柔軟な視覚編集を可能にします。
- スタイル影響の調整:
finetune_strengthにより、ファインチューニング済みコンセプトの影響度を微妙な寄与から強いパーソナライズまで調整できます。 - 品質と創造性のコントロール:
steps、guidance、prompt_upsamplingなどのパラメータで、忠実度、プロンプト遵守度、創造的変化を制御できます。 - 再現可能な出力: オプションの
seedサポートにより、クリエイティブ資産のバージョン間での再テストや制御された反復が容易になります。 - 本番向け非同期ワークフロー: タスク ID とポーリング URL を返し、パイプライン自動化のための Webhook もサポートします。
- 商用展開パス: CometAPI 上で商用利用可能モデルとして掲載。(cometapi.com)
flux-pro-1-0-fill-finetuned へのアクセスと統合方法
ステップ 1: API キーに登録
CometAPI に登録し、ダッシュボードから API キーを作成します。キーを取得したら、flux-pro-1-0-fill-finetuned API へのリクエストを認証してアプリケーション統合を開始できます。CometAPI は、統合を支援するサンプルコードや API リソースとともに、このモデルをプラットフォーム上で利用可能として掲載しています。(cometapi.com)
ステップ 2: flux-pro-1-0-fill-finetuned API にリクエスト送信
任意の HTTP クライアントまたは SDK から flux-pro-1-0-fill-finetuned API へリクエストを送信します。API キー、モデル ID flux-pro-1-0-fill-finetuned、およびユースケースに必要なリクエストペイロードを含めてください。本モデルでは、通常、ソース画像、マスクまたはアルファマスク、プロンプト、そしてインペインティング時に学習済みコンセプトを適用するための finetune_id を提供します。Black Forest Labs は、このエンドポイントを POST /v1/flux-pro-1.0-fill-finetuned として文書化しており、finetune_strength、steps、guidance、output_format、任意の Webhook 設定などのパラメータを設定できます。
ステップ 3: 結果の取得と検証
API から返されるレスポンスメタデータを用いて生成結果を取得します。flux-pro-1-0-fill-finetuned では、タスク id と polling_url、さらに cost、input_mp、output_mp といった使用量関連の項目が返されます。編集結果が意図したマスク領域に一致し、周囲のコンテキストを保持し、ファインチューニングしたコンセプトが一貫して反映されていることを確認してから、本番ワークフローへ反映してください。