flux-pro-1-0-canny の技術仕様
| 仕様 | 詳細 |
|---|---|
| モデルID | flux-pro-1-0-canny |
| モデルファミリー | FLUX.1 Canny [pro] |
| 提供元 / 由来 | Black Forest LabsのFLUXファミリー。Replicateやfalなどのサードパーティ推論プラットフォームでも公開。 |
| モダリティ | 画像間変換／テキストプロンプトとCannyエッジ制御画像を併用した制御付き画像生成。 |
| 中核の制御手法 | 構造保持のためのガイダンスとしてのCannyエッジ検出。 |
| 主なユースケース | スケッチからの画像生成、構図を保持したままのリテクスチャリング、制御されたスタイル転送、建築やレイアウト制約を伴う可視化。 |
| 入力タイプ | プロンプト本文と制御画像／エッジマップ。公開デプロイの一般的なランタイムパラメータには、steps、guidance、seed、出力形式、安全性関連の制御が含まれます。 |
| 出力 | 提供されたエッジマップの構造に従った生成画像ファイル。 |
| 推論パターン | FLUXスタイルのAPIで一般的な非同期タスク送信と結果ポーリング。 |
flux-pro-1-0-canny とは？
flux-pro-1-0-canny は、FLUXエコシステムにおけるプロフェッショナル志向のエッジ誘導型画像生成モデル FLUX.1 Canny [pro] の、CometAPIによるプラットフォーム識別子です。構造的なコンディショニング信号として Canny エッジ検出を用いる点が特徴で、自然言語のプロンプトに応答しつつ、入力画像の構図や輪郭に従った新しい画像を生成できます。
実務的には、標準的なテキストから画像生成よりも高い制御性を求めるユーザー向けに設計されています。すべてを言葉だけで記述する代わりに、スケッチ、抽出したエッジマップ、構図の参照を与え、異なるスタイルや素材処理、シーンコンテキストでのレンダリングを指示できます。公開されたモデル説明では、変換タスクにおいてレイアウトや構造を保持する用途に特に有用と位置づけられています。
基盤となる FLUX API はジョブ送信とポーリングを用いることが多いため、この種のモデルとの統合は一般に非同期ワークフローとして構築されます。すなわち、リクエストを送信し、タスクIDを受け取り、処理完了後に結果を取得します。
flux-pro-1-0-canny の主な機能
- エッジ誘導による構造制御: 生成過程で Canny エッジマップを用い、元画像の構図、輪郭、主要形状を保持します。
- プロンプト駆動のリスタイリング: エッジ制御された入力とテキストプロンプトを組み合わせ、元の構造を損なうことなく外観、ムード、素材、作風を変更できます。
- スケッチから画像へのワークフローに適合: 公開例や説明では、スケッチやエッジ由来のガイドを洗練されたアートワークや実運用可能なビジュアルへと仕上げる点が強調されています。
- 構図を保ちながらのリテクスチャリング: レイアウトを安定させたままシーンやオブジェクトのテクスチャを再適用する用途に適しており、プロダクト、コンセプト、環境の可視化ワークフローで有用です。
- 有用なパラメータ制御: 公開APIでは、拡散ステップ、ガイダンス強度、seed、出力形式、安全許容度などの推論設定が一般的に公開され、再現性の確保やチューニングが可能です。
- プロダクション向きのAPI動作: FLUX API の統合ガイダンスは、エンドポイントベースのジョブ送信と結果ポーリングを重視しており、バックエンドの自動化やアプリケーションのパイプラインとの相性が良好です。
flux-pro-1-0-canny へのアクセスと統合方法
ステップ 1: APIキーの登録
CometAPI に登録し、ダッシュボードから API キーを生成します。安全に保管し、flux-pro-1-0-canny API にリクエストする前に、アプリケーションで環境変数として読み込んでください。
ステップ 2: flux-pro-1-0-canny API にリクエストを送信
CometAPI の Flux 互換エンドポイント POST /flux/v1/{model} を使用します。
curl https://api.cometapi.com/flux/v1/flux-pro-1-0-canny \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-d '{
"prompt": "A breathtaking landscape painting with golden hour lighting",
"width": 1024,
"height": 768,
"steps": 20,
"prompt_upsampling": true
}'
ステップ 3: 結果の取得と検証
API はタスクIDを返します。生成状況の確認と完了時の出力画像取得のために GET /flux/v1/get_result?id={task_id} をポーリングしてください。