Solutions Choose your path
For individuals Build, learn, and create with simple usage-based access. For business Scale teams, billing, governance, and model workflows. More English 繁體中文 日本語 한국어 Français Deutsch Español Italiano Português Русский العربية ไทย Tiếng Việt Bahasa Indonesia Bahasa Melayu Türkçe Polski Nederlands Danish Norsk Қазақ اردو
無料で始める 無料で始める
500+ AI Model API, All In One API.
Just In CometAPI © 2026 CometAPI · All rights reserved
Home Blog CometAPI での FLUX 3 Image API の使用方法 guide / CometAPIリサーチ
CometAPI での FLUX 3 Image API の使用方法 CometAPI で FLUX 3 Image を使用して生成と編集を行う。画像パラメータ、非同期ジョブの処理、プロンプト例、料金について学ぶ。
Deon Goodwin AIモデルとAPIの調査チーム CometAPI で FLUX 3 Image を使用して生成と編集を行う。画像パラメータ、非同期ジョブの処理、プロンプト例、料金について学ぶ。
この要約で素早く答えを把握し、ガイドで背景、例、実装詳細を確認してください。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_COMETAPI_KEY",
base_url="https://api.cometapi.com/v1",
)
response = client.chat.completions.create(
model="gpt-5-mini",
messages=[{"role": "user", "content": "Build this workflow."}],
)
print(response.choices[0].message.content)TL;DR
FLUX 3 Image を使って、プロダクト写真、ポスター、参照画像に基づく編集を作成できます。CometAPI の flux-3-image 経由で利用可能で、価格はリクエストあたり $0.0384 から。ここでは、画像設定の選択、リクエスト準備、非同期ジョブの処理、生成画像のレビューまでを案内します。CometAPI アカウント、API キー、アカウントに割り当てられた FLUX 3 Image リクエスト設定が必要です。
Key Takeaways
新規構図にはテキストからの生成、被写体の同一性を保つ必要がある場合は参照ガイド付き編集を選ぶ。
小さなドラフトで構図を確認してから、最終の大きな画像に予算を投じる。
CometAPI の認証情報とモデル固有のリクエストスキーマを使用する。BFL ネイティブのキーや例は別統合向け。
適用される CometAPI レートからコストを見積もり、承認済み成果物あたりで実支出を計測する。
バッチ実行前に、投稿→結果取得→ダウンロード→目視レビューを一度完了する。
What Is FLUX 3 Image API?
FLUX 3 Image は、静止画像の生成と改変を行う Black Forest Labs のモデルです。テキストプロンプトは新しいシーンを記述し、参照画像は保持・結合・変更すべき視覚要素を提供します。例えば e コマースチームでは、ブリーフからプロダクトシーンを作り、その後は承認済みの製品写真を再利用しながら周囲を差し替えるといった使い方が可能です。
プロンプトを書く前にワークフローを選びます。新規ビジュアルなら、被写体・設定・ライティング・フレーミングを指定します。編集なら、元画像を特定し、変更内容を明示し、保持すべきディテールを指示します。複数参照での合成なら、各参照の役割を割り当て、製品アイデンティティとビジュアルスタイルが競合しないようにします。
明確性、出典の帰属、最新のAPI用語について確認済みです。
FLUX 3 Image Specifications and API Parameters 以下の設定で画像を計画してください。モデル制御は BFL FLUX 3 Image API リファレンスに従い、認証とリクエスト経路は CometAPI 統合に従います。CometAPI の FLUX 3 Image ルートが受け付けるフィールド名を使用してください。
Model identity FLUX 3 Image。カタログ ID は flux-3-image モデル固有のルートと、アカウント例のルーティング規約を使用します。 Generation / prompt シーン、構図、または編集指示 1 つの明確な被写体と 1 つの意図した出力から始めます。 Reference images / native images 1～10 枚の参照画像の順序付きリスト。HTTP(S) URL またはネイティブ API では base64 を受け付けます。 ゲートウェイのフィールド名、入力形式、参照上限を確認します。 Aspect ratio / native aspect_ratio キャンバスの縦横比。auto の場合、プロンプトで要求した比率が優先。編集ではデフォルトで最初の参照のフレーミングを保持します。 納品形式に合わせた比率を選び、受け付ける値を確認します。 Resolution / native resolution ネイティブ階層: 768sq、1k（デフォルト）、1.5k、2k、4k。正確な寸法はアスペクト比に依存します。 編集では match_input が最初の参照のサイズを保持し、4 MP を超える場合は縮小。明示的な aspect_ratio は最も近い階層を選択。明示的な width と height が優先されます。 Exact dimensions / width + height 両方の整数を指定（各 256～6256 px）。resolution と aspect_ratio を上書き。総ピクセル数は 16,822,272 未満、参照画像使用時は 4,194,304 未満。 固定納品サイズ（例: 1024 × 1280）には明示寸法を使用。CometAPI ルートがこれらのネイティブ制御を受け付けるか確認。 Layout control 要素配置のためのバウンディングボックス指示 正確な配置が重要な場合は、ドキュメント化されたレイアウト構文を使用します。 Targeted edits 特定の被写体または領域への変更 変更すべきでない領域について、ソースと結果を比較します。 Authentication ゲートウェイリクエスト用の CometAPI API キー CometAPI の例にある認証ヘッダーに従い、キーはサーバー側に保持します。 Result handling 非同期生成: ジョブを送信し、タスク ID を追跡、完成画像を取得します。 アカウントのルートが CometAPI の FLUX タスク契約に従う場合、下記の Python テンプレートを使用します。
寸法は 3 通りのいずれかで指定します。resolution 階層＋ aspect_ratio、width＋height による正確なキャンバス、または編集での match_input。生成後にフレーミングとディテールを比較できるよう、元参照を保持してください。ネイティブエンドポイントは未対応フィールドを拒否します。呼び出すルートのスキーマに従ってください。
FLUX.2 vs FLUX 3 Image Use case 強力なテキスト生成/編集、ファミリー内バリアント ディテール豊かな画像合成とピクセルを保つ編集 同じブランドのプロンプトで比較 Resolution バリアントに依存した高解像度生成 明示的な 2K/4K ネイティブショーケース フルズームで精細部を検査 Editing 一部バリアントでのマルチ参照機能 ローカライズされた編集のデモンストレーション 未編集領域のドリフトを測定 Cost バリアントとプラットフォームにより異なる 選択構成に対応する CometAPI 価格 承認画像あたりで比較 CometAPI access CometAPI で FLUX 2 PRO と FLUX 2 MAX を提供 CometAPI で flux-3-image として提供 本番ルーティング変更前にモデル固有リクエストを検証 Evaluation 現在運用中のバリアントをそのまま使用 同じプロンプトと参照セットを実行 受理出力と総ワークフローコストを比較
現行の FLUX.2 統合を比較用ベースラインとして維持しつつ FLUX 3 Image を評価してください。同じブリーフと参照アセットを両方のワークフローで実行し、承認出力、ターンアラウンド、総コストを比較します。
1. Prerequisites export COMETAPI_KEY="your_cometapi_key"
2. Endpoint POST https://api.cometapi.com/flux/v1/flux-3-image
認証は Bearer トークン（CometAPI 方式）を使用します。リクエストはデフォルトで非同期です。
3. Basic text-to-image example (cURL) curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
{
"id": "<task_id>",
"status": "Pending",
"result": {},
"polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}
4. Poll for the result curl "https://api.cometapi.com/flux/v1/get_result?id=<task_id>" \
-H "Authorization: Bearer $COMETAPI_KEY"
status が "Ready" になるまでポーリングします。画像 URL は result.sample に表示されます（署名付き URL は一時的なため、速やかにダウンロードしてください）。
同一リクエスト内で同期待機するには、ボディに "async": false を追加します（接続を維持し、クライアントのタイムアウトを十分長く設定）。
5. Python example (submit + poll) import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image は、同一エンドポイントで純粋なテキスト生成と編集／マルチ参照の両方をサポートします。images を含め、プロンプトでそれらの使い方を記述します（別の “mode” フィールドは不要）。
Alternative: OpenAI-compatible route 統合イメージエンドポイントでモデル ID を指定して試すこともできます:
POST https://api.cometapi.com/v1/images/generations
{
（最新の FLUX 3 パラメータをすべて使うには、ネイティブの `/flux/v1/...` を推奨。）
### Tips
* CometAPI の Flux 3 Image モデルページで最新の提供状況と正確な価格を確認してください。
* result.sample の URL はすぐにダウンロードしてください。
* 最新のパラメータ一覧やプレイグラウンド例は、CometAPI の Flux ドキュメントと Black Forest Labs の公式 FLUX 3 Image リファレンスを参照してください。
これは、CometAPI の認証と統合基盤を使いながら、公式 BFL のフローを反映したものです。
## How to Prompt FLUX 3 Image? Examples
### Example: Product Photography Prompt
最初のプロダクト撮影テスト用プロンプトとして、以下を使用します。
A premium amber perfume bottle centered on matte limestone,
CometAPI のルートが期待するリクエストボディを保ったまま、このブリーフに request.json の prompt 値を置き換えてください。4:5 キャンバスは縦位置のプロダクトに適しています。ルートがネイティブの寸法制御を受け付ける場合、1024 × 1280 は正確な 4:5 です。両方の値を一緒に指定してください。
小さなドラフトから始め、ボトルのシルエット、ラベル、反射、不要物の有無を確認します。製品アイデンティティの正確さが重要であれば、テキストのみでの再現に頼らず、製品参照を使用してください。変更前にプロンプトと出力設定を記録します。
### Example: Typography and Poster Layout
明確に指定したタイトル文字列を使うポスタープロンプトです。
An editorial art poster on warm off-white paper.
このブリーフを CometAPI リクエストのプロンプトとして使用し、縦向きキャンバスを選びます。まずドラフトで見出し位置とキャラクター配置を確認し、その後に最終アートワークに向けて出力サイズを大きくしてください。
文字の正確さを受け入れ判断条件として扱います。最終解像度の出力で、すべての文字と句読点を確認します。印象的なギャラリー画像であっても、ブランド文字列の完全な正確性を保証するものではありません。
## How to Edit Images with References
編集では、求める変更と保持すべき詳細の両方を記述します。ネイティブの FLUX 3 Image API は images で参照を受け付けます。CometAPI の例で対応する入力フィールドにマッピングしてください。製品参照は最初に置き、その順序をプロンプト内でも一貫させます。
### Single-Image Editing: Change the Background, Preserve the Product
edit.py を submit.py、poll.py、download.py の隣に配置します。PRODUCT_IMAGE_URL に公開アクセス可能な HTTPS の製品写真を設定し、python edit.py を実行します。以下の例は、ネイティブの images 配列を受け付けるルートが必要です。競合するソース画像フィールドのない編集リクエストボディを使用し、CometAPI 例で異なる入力フィールドを使う場合はマッピングを変更してください。保存した編集タスクを再開するには、python poll_download.py editing-task.json を実行します。
import json
This request variant requires a route accepting the native images array. payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
ラベルが読み取れ、シルエットが明確な鮮明な製品写真を選びます。CometAPI ルートで受け付けられる画像入力形式で提出してください。ルートがネイティブの resolution 設定をサポートする場合は、match_input を使って参照のフレーミングとサイズを、モデルの編集上限の範囲で保持します。
[BFL gallery](https://bfl.ai/models/flux-3-image) には、ダイバーを 2 人追加するローカライズ編集のデモが掲載されています。これらの公式ビフォーアフターは検査ポイントの例示です。本記事の CometAPI 実行結果ではありません。
BFL 公式編集例（ビフォー）：元の水中シーンに 1 人のダイバーがいる。
BFL 公式編集例（アフター）：ダイバーが 2 人追加されている。新規被写体だけでなく、未変更の背景も検査する。
### Multi-Image Reference Editing: Combine Style and Product Identity
製品を先頭、ライティング／スタイル参照を 2 番目にします。PRODUCT_IMAGE_URL と STYLE_IMAGE_URL を設定し、以下を multi_edit.py として 3 つのクライアントファイルの横に保存して、python multi_edit.py を実行します。この例は、images に少なくとも 2 つの参照を受け付けるルートが必要です。競合するソース画像フィールドのない編集リクエストボディから始めます。保存済みジョブは python poll_download.py multi-edit-task.json で再開できます。
import json
Preserve this order: product first, lighting/style second. payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
モデル固有の CometAPI 形式で両方の参照を添付します。まず、製品アイデンティティが保持されているか確認し、その後に 2 番目の参照が意図した光と色を与えているか評価します。不要なオブジェクトや文字が混入する場合は、その参照を簡素化するか、プロンプトをより明確にしてください。
## How to Use Bounding Boxes for Layout Control
ボトルと見出しの領域を予測可能にしたい場合はボックスを使用します。各要素に ID を付与したシーンキャプションを書き、JSON 配列をプロンプトに追記します。BFL の形式は 0–1000 グリッド上で [top, left, bottom, right] の順に bbox を使用します。ボックスは別の API フィールドではなく、プロンプト内に含めます。
以下の例では、ボトル上部に見出しスペースを確保します。request.json で縦向きの出力設定を維持し、このファイルを layout.py として submit.py の横に保存します。python layout.py を実行し、次に python poll_download.py layout-task.json を実行します。このレイアウト構文をサポートするルートを使用してください。結果を検査し、ボトルと見出しが意図した領域を占めているか確認します。
import json
caption = (
アスペクト比をレイアウトと一致させてください。ボックスはクリッピングではなく配置のガイドです。保存した画像で見出しのスペルと字間を確認し、厳密なタイポグラフィが重要な場合は、最終的なブランド文字はデザインツールで追加してください。
## How Much Does FLUX 3 Image API Cost?
CometAPI は FLUX 3 Image をリクエストあたり [$0.0384 から](https://www.cometapi.com/models/flux/flux-3-image/)提供しています（2026 年 11 月 9 日）。初期予算の目安としてこの開始レートを使用し、その後は選択構成に表示されるレートを適用してください。以下の例では、課金対象の各リクエストが開始レートであると仮定しています。
| Billed requests | Assumed rate / request | Illustrative cost |
| --------------- | ---------------------- | ----------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
バッチを実行する前に、選択した構成とアカウントのレートを確認してください。公開された開始価格は、すべての解像度や編集オプションの価格を定めるものではありません。却下されたクリエイティブも記録し、承認出力数と合わせて追跡します。例えば 100 リクエストで $3.84 を支出し、80 点を承認した場合、承認成果物あたりの API コストは $0.048 です（人的レビューやストレージを含まない）。これは例示であり、実測の承認率ではありません。
### Resolution Choices by Workflow
| Workflow | First test | Approval check |
| ----------------------------- | ------------------------------------------------ | ------------------------------------------------- |
| Prompt exploration | 最小限で有用なサポート階層 | 構図と被写体配置 |
| E-commerce product images | 意図したトリミングでのドラフト | 製品の形状、ラベル、エッジディテール |
| Campaign or editorial artwork | レイアウト承認後に出力を拡大 | タイポグラフィと納品サイズでのディテール |
| Reference-based edits | 元画像に適したサポート設定 | 未変更領域、製品アイデンティティ、ライティング |
## When Should You Use FLUX 3 Video Instead?
FLUX 3 Image は、プロダクトのヒーロー画像、ポスター、キャンペーン用の静止フレームなど静止資産に使用します。成果物に動きが必要な場合は、別モデル ID flux-3 として掲載されている [CometAPI 上の FLUX 3 Video](https://www.cometapi.com/models/flux/flux-3/) を参照してください。その[ビデオワークフロー](https://apidoc.cometapi.com/api/video/flux-3/create)はビデオ固有の設定と課金を使用します。画像とビデオのリクエストは分け、静止画像には duration、音声、ビデオフレーム制御を含めないでください。
両形式が必要なキャンペーンでは、まず静止画像の構図を承認し、その後にモーションブリーフを別途準備します。承認済みの画像をソース素材として再利用する前に、ビデオモデルの参照入力要件を確認してください。
## Conclusion
1 つのプロダクトブリーフと小さな画像ジョブから始めます。CometAPI の FLUX 3 Image ルートで送信し、タスク ID を保存し、完了画像を取得・レビューしてからスケールします。正確なキャンバスが必要な場合は width と height を使用し、参照編集では対応があれば match_input を使用します。承認画像数に対する総支出を比較し、実用的な結果に即した予算にしてください。
## SEO Metadata
Meta title: FLUX 3 Image API ガイド: 生成、編集＆ CometAPI
Meta description: CometAPI 上で FLUX 3 Image を使った生成と編集。画像パラメータ、非同期ジョブの取り扱い、プロンプト例、$0.0384/リクエストからの価格を解説。
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, FLUX 3 イメージ編集, FLUX 3 価格, 参照画像生成, FLUX.2 移行
URL slug: flux-3-image-api-guide
CometAPI の価格はリクエストあたり $0.0384 から（2026 年 11 月 9 日）。
価格セクションを参考予算に使用し、選択した構成を確認します。
Extra fields ネイティブとゲートウェイスキーマはモデル世代間で異なります ネイティブ FLUX 3 Image は width と height を受け付けます。古いモデルの seed や input_image は再利用せず、参照は images を使用し、CometAPI のゲートウェイスキーマに従ってください。
