flux-image

Flux 画像生成

AceDataCloud の Flux API を使用して、画像を生成・編集します。

初回セットアップ

1. clawhub install @acedatacloud/flux で公式 Skill をインストールします。ClawHub の発行元が @acedatacloud であることを確認してください。
2. AceDataCloud → Applications にサインインし、General application を開いて、Flux へのアクセス権、残高、現在の料金を確認します。API キーをコピーするか、Manage Keys → Create を選択して別のキーを作成します。Bearer を付けずにキーの値をコピーしてください。platform-... の管理トークンはサービス用 API キーではありません。
3. Allowed APIs の制限を有効にする場合は、/flux/images と /flux/tasks を含めてください。以下の高度なワークフローでは、追加のルートを呼び出す場合があります。
4. OpenClaw Gateway ホストで、~/.openclaw/.env に ACEDATACLOUD_API_TOKEN=your_api_key_here を設定してから、Gateway を再起動し、新しいセッションを開始します。ターミナルから直接テストする場合は、そのシェルで export ACEDATACLOUD_API_TOKEN="your_api_key_here" を実行します。キーをプロンプトに記載したり、.env ファイルをコミットしたりしないでください。
5. 以下の クイックスタート を実行します。タスク ID が返された場合は、完了するまで同じタスクを照会してください。進行状況を確認するだけのために、課金対象の生成を再度リクエストしないでください。

キーの設定、初回実行、トラブルシューティングの図解 · トークンの詳細

クイックスタート

curl -X POST https://api.acedata.cloud/flux/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "async": true}'

非同期： 非同期タスクのポーリングを参照してください。{"id": "..."} を指定して POST /flux/tasks でポーリングします。

モデル

モデル	品質	速度	サイズ	用途
flux-dev	良好	高速	256–1440px	素早い生成（デフォルト）
flux-pro	高	中速	256–1440px	本番用途
flux-2-klein	良好	最速	256–1440px	コンパクトな生成、または Flux 2 で最小のレイテンシが求められる生成
flux-2-flex	高	高速	256–1440px	高品質な画像をより速く生成
flux-2-pro	さらに高い	中速	256–1440px	プロンプトへの追従性を向上
flux-2-max	最高	低速	256–1440px	最高品質の生成
flux-kontext-pro	高	中速	アスペクト比	画像編集
flux-kontext-max	最高	低速	アスペクト比	複雑な編集

画像を生成する

POST /flux/images
{
  "prompt": "a minimalist logo of a mountain",
  "action": "generate",
  "model": "flux-2-pro",
  "size": "1024x1024",
  "count": 1
}

サイズのオプション

dev/pro/flux-2 の場合（ピクセル単位の寸法）：

• "1024x1024"、"1344x768"、"768x1344"、"1024x576"、"576x1024"

kontext の場合（アスペクト比）：

• "1:1"、"16:9"、"9:16"、"4:3"、"3:4"、"3:2"、"2:3"、"21:9"、"9:21"

画像を編集する

テキストの指示による画像編集には、kontext モデルを使用します。

POST /flux/images
{
  "prompt": "change the background to a beach sunset",
  "action": "edit",
  "image_url": "https://example.com/photo.jpg",
  "model": "flux-kontext-pro"
}

注意点

• dev/pro/flux-2 モデルではピクセル単位の寸法（例："1024x1024"）を、kontext モデルではアスペクト比（例："16:9"）を使用します
• 編集には kontext モデル（flux-kontext-pro または flux-kontext-max）が必要です。他のモデルは生成のみをサポートします
• count パラメーターを指定すると、1 回のリクエストで複数の画像を生成します（枚数に比例して費用が増加します）
• flux-2-klein は Flux 2 の中で最も軽量なモデルです。最高品質よりもレイテンシを重視する場合に便利です
• flux-2-max は最高品質ですが、最も低速です。試行錯誤には dev/klein/flex を、最終出力には max を使用してください
• すべての生成は非同期です。タスク ID をすぐに取得するため、必ず "callback_url" を設定し、その後 {"id":"<task_id>"} または {"ids":[...],"action":"retrieve_batch"} を使用して /flux/tasks をポーリングしてください

MCP： pip install mcp-flux-pro | ホスト版：https://flux.mcp.acedata.cloud/mcp | すべての MCP サーバーを参照

FLUX 3 動画ツール

POST /flux/videos は action=generate（デフォルト）で動画を生成します。mode=t2v/i2v/v2v/draft_enhance を使用します。T2V では prompt が必要です。I2V では keyframes も必要です。V2V では start_video も必要です。通常の動画リクエストでは、hd/fhd/qhd/uhd、5～20 秒（V2V は最大 15 秒）の整数値または auto、draft フラグと generate_audio フラグを指定できます。明示的な false はそのまま保持してください。

ドラフトの高画質化では、自身が所有するプラットフォームの draft_task_id を使用し、一時キャッシュが利用可能な状態である必要があります。無期限に保持されることを保証するものではありません。

関連する MCP ツール：flux_generate_video。CLI コマンド：flux video --request-file。MCP／CLI のリクエストはデフォルトで非同期に送信され、既存の /flux/tasks エンドポイントを通じてポーリングされます。HTTP を直接リクエストする場合は、async=true を設定すると、タスク ID をすぐに受け取れます。生成料金は実際の出力秒数に基づきます。計測された最終的な使用量の代わりに、リクエストした長さを使用しないでください。