flux-pro-1.0-depth API

flux-pro-1-0-depth の技術仕様

flux-pro-1-0-depth とは？

flux-pro-1-0-depth は、Black Forest Labs の FLUX Pro 1.0 Depth モデルに対する CometAPI のプラットフォーム識別子であり、プロンプトに基づく変換を適用しつつシーンの3D構造を保持するよう設計された、深度対応の画像生成・編集モデルです。画像を平面的なピクセル集合として扱うのではなく、深度ガイダンスによる制御を用いることで、編集がパース、オブジェクトの配置、相対的なスケールをより適切に尊重できるようにします。

そのため、既存画像の空間的一貫性を損なわずにリスタイルや改変を行いたい場合に特に有用です。FLUX.1 Depth に関する公開説明では、Black Forest Labs およびエコシステムのドキュメントが、建築シーン、プロダクトビジュアライゼーション、構造を保持するスタイル転移、現実的なジオメトリの維持が重要となる編集といったユースケースを強調しています。

また、このモデル名を冠した元の Black Forest Labs のエンドポイントは、2025年10月31日付で廃止された点にも留意が必要です。ここで使用すべき CometAPI のモデルコード自体は変わりませんが、長期的な互換性や移行計画を評価する開発者にとって関連する情報です。

flux-pro-1-0-depth の主な特徴

• 深度認識型コントロール：モデルは深度ガイダンスを用いて、生成・編集結果がシーンのジオメトリやパースにより自然に整合するよう設計されています。
• 空間関係の保持：オブジェクト間の3D関係を維持するよう設計されており、変換後も合成の説得力を保ちます。
• 構造を保持する画像変換：FLUX の深度ワークフローは、リテクスチャリング、制御されたリスタイリング、構造化入力をレイアウトを保ったまま豊かなビジュアルへ変換するといった用途に有用と記述されています。
• 可視化ワークフローへの高い適合性：公開ドキュメントは、建築ビジュアライゼーション、プロダクト配置、正確なシーン合成を主な強みとして強調しています。
• プロンプトのみの生成より高いクリエイティブコントロール：テキスト指示に加えて画像構造にも追従できるため、一貫性とコントロール性が重要な編集に適しています。これは、深度ガイド設計および明示されたユースケースに基づく推論です。
• FLUX エコシステムへのプロフェッショナル統合：高度な画像生成・編集ワークフロー向けの FLUX Pro ツールセットに属します。
• 上流エンドポイントの廃止ステータス：Black Forest Labs は、2025年10月31日付で元の flux-pro-1.0-depth エンドポイントを廃止している点に注意が必要です。

flux-pro-1-0-depth へのアクセスと統合方法

ステップ1: APIキーの作成

まず CometAPI にサインアップし、ダッシュボードから API キーを発行します。flux-pro-1-0-depth API へのすべてのリクエスト認証にこのキーを使用します。

ステップ2: flux-pro-1-0-depth API へリクエストを送信

CometAPI の Flux 互換エンドポイント POST /flux/v1/{model} を使用します。

curl https://api.cometapi.com/flux/v1/flux-pro-1-0-depth \
  -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} をポーリングします。