申請プロセス
Flux Images Generation APIを使用するには、まず Ace Data Cloud コンソール にアクセスして、APIトークンを取得し、保管してください。
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。
1つのAPIトークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソールで一般残高をチャージできます。
📘 完全なドキュメント：Flux Images Generation API →
基本的な使用法
まず、基本的な使用方法を理解します。これは、プロンプトprompt、生成アクション action、画像サイズ size を入力することで、処理された結果を得ることができます。まず、action フィールドを簡単に渡す必要があり、その値は generate です。その後、プロンプトを入力する必要があります。具体的な内容は以下の通りです：
accept：受け取りたいレスポンス結果の形式。ここではapplication/json、つまりJSON形式を記入します。authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
action：今回の画像生成タスクのアクション。size：画像生成結果のサイズ。flux-2-flex/flux-2-pro/flux-2-maxシリーズは、画像比率（例：1:1、16:9）を必ず渡す必要があり、1024x1024のようなピクセルサイズは受け付けません。デフォルトでは400が返されます。count：生成する画像の数。デフォルト値は1で、このパラメータは画像生成タスクが有効な場合のみ有効で、編集タスクには無効です。prompt：プロンプト。model：生成モデル。デフォルトはflux-dev；最新のフラッグシップはflux-2-pro、flux-2-max（画質が高く、画像比率sizeと組み合わせる必要があります）。callback_url：結果をコールバックする必要があるURL。async：オプション。trueに設定すると、インターフェースはすぐにtask_idを返し、callback_urlを提供する必要がなく、その後、対応するタスククエリインターフェースを通じて結果をポーリングして取得します。
size にはいくつかの特別な制限があり、主に width x height の幅高さ比と x:y の画像比率の2種類に分かれます。具体的には以下の通りです：
参考の画像比率：“21:9”, “16:9”, “4:3”, “3:2”, “1:1”, “2:3”, “3:4”, “9:16”, “9:21”。
パラメータを選択すると、右側に自動的に対応するコードが生成されます。コピーする前に、認証ヘッダーが自分のAPIキーを使用していることを確認してください。ドキュメントやスクリーンショットには実際の資格情報を表示しないでください。
「Try」ボタンをクリックするとテストが行え、以下の結果が得られました：
success：この時点での画像生成タスクの状態。task_id：この時点での画像生成タスクID。trace_id：この時点での画像生成トレースID。data：この時点での画像生成タスクの結果リスト。image_url：この時点での画像生成タスクのリンク。prompt：プロンプト。
data の画像リンクアドレスに基づいて生成されたFlux画像を取得するだけです。
また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです：
画像編集タスク
特定の画像を編集したい場合、まずimage_url パラメータには編集する画像のリンクを渡す必要があります。この時、action は edit のみをサポートし、以下の内容を指定できます：
- model：今回の画像編集タスクで使用するモデル。
flux-dev、flux-pro、flux-kontext-pro、flux-kontext-max、flux-2-flex、flux-2-pro、flux-2-maxをサポート。 - image_url：編集する必要がある画像をアップロード。
非同期コールバック
Flux Images Generation API の生成時間は比較的長く、約 1-2 分かかります。API が長時間応答しない場合、HTTP リクエストは接続を維持し続け、追加のシステムリソースを消費するため、本 API では非同期コールバックのサポートも提供しています。 全体の流れは、クライアントがリクエストを発行する際に、追加でcallback_url フィールドを指定し、クライアントが API リクエストを発行した後、API はすぐに結果を返し、現在のタスク ID を表す task_id フィールド情報を含みます。タスクが完了すると、生成された画像の結果が POST JSON 形式でクライアントが指定した callback_url に送信され、その中にも task_id フィールドが含まれているため、タスクの結果を ID で関連付けることができます。
以下の例を通じて、具体的にどのように操作するかを理解しましょう。
まず、Webhook コールバックは HTTP リクエストを受信できるサービスであり、開発者は自分で構築した HTTP サーバーの URL に置き換える必要があります。ここではデモのために、公開の Webhook サンプルサイト https://webhook.site/ を使用します。このサイトを開くと、Webhook URL を取得できます。以下の図のように表示されます：
この URL をコピーすれば、Webhook として使用できます。このサンプルは https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab です。
次に、フィールド callback_url を上記の Webhook URL に設定し、対応するパラメータを入力します。具体的な内容は以下の図のようになります：
https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab で生成された画像の結果を観察できます。以下の図のようになります：
内容は以下の通りです：
task_id フィールドが含まれており、他のフィールドは上記と類似しています。このフィールドを通じてタスクの関連付けが可能です。
エラーハンドリング
API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例えば：400 token_mismatched：不正なリクエスト、パラメータが欠落または無効な可能性があります。400 api_not_implemented：不正なリクエスト、パラメータが欠落または無効な可能性があります。401 invalid_token：未認証、無効または欠落した認証トークン。429 too_many_requests：リクエストが多すぎます、レート制限を超えました。500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。