FLUX API クイックスタート：CometAPI で画像を生成

作成するもの

FLUX.2 Pro に 1280x768 PNG タスクを送信し、返されたタスク id を保存して、GET /flux/v1/get_result をポーリングし、タスクが result.sample になったら Ready をダウンロードします。同期リクエストの場合は、"async": false を送信し、作成レスポンスから result.sample を読み取ります。完全な例については、同期的に生成するを参照してください。

前提条件

COMETAPI_KEY に保存された CometAPI API キー
curl および jq、requests を備えた Python 3.10+、または Node.js 18+
CometAPI アカウントでの flux-2-pro へのアクセス

エンドポイントと認証

タスクを送信します：

POST https://api.cometapi.com/flux/v1/flux-2-pro

作成レスポンスから返される最上位の id を使用してポーリングします：

GET https://api.cometapi.com/flux/v1/get_result?id=<task_id>

両方の CometAPI リクエストを次のように認証します：

Authorization: Bearer $COMETAPI_KEY

コード例

set -e

CREATE_RESPONSE=$(curl --max-time 60 -fSs https://api.cometapi.com/flux/v1/flux-2-pro \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
    "width": 1280,
    "height": 768,
    "output_format": "png",
    "seed": 424242
  }')

TASK_ID=$(printf "%s" "$CREATE_RESPONSE" | jq -r '.id')

for ATTEMPT in $(seq 1 60); do
  RESULT=$(curl --max-time 30 -fSs "https://api.cometapi.com/flux/v1/get_result?id=$TASK_ID" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  STATUS=$(printf "%s" "$RESULT" | jq -r '.status')
  echo "status: $STATUS"

  case "$STATUS" in
    Ready)
      IMAGE_URL=$(printf "%s" "$RESULT" | jq -r '.result.sample')
      curl --max-time 60 -fL "$IMAGE_URL" -o flux-result.png
      exit 0
      ;;
    Error|Failed|Failure|"Task not found"|"Request Moderated"|"Content Moderated"|failed|failure)
      echo "FLUX task failed: $STATUS" >&2
      exit 1
      ;;
  esac

  sleep 5
done

echo "FLUX task did not finish in time" >&2
exit 1

import os
import time
from pathlib import Path

import requests

headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
payload = {
    "prompt": (
        "A clean editorial photograph of a red ceramic teapot on a pale blue "
        "table, a small yellow lemon on the right, soft window light, no text."
    ),
    "width": 1280,
    "height": 768,
    "output_format": "png",
    "seed": 424242,
}

create_response = requests.post(
    "https://api.cometapi.com/flux/v1/flux-2-pro",
    headers={**headers, "Content-Type": "application/json"},
    json=payload,
    timeout=60,
)
create_response.raise_for_status()
task_id = create_response.json()["id"]

failure_statuses = {
    "Error",
    "Failed",
    "Failure",
    "Task not found",
    "Request Moderated",
    "Content Moderated",
    "failed",
    "failure",
}

for _ in range(60):
    result_response = requests.get(
        "https://api.cometapi.com/flux/v1/get_result",
        headers=headers,
        params={"id": task_id},
        timeout=30,
    )
    result_response.raise_for_status()
    result = result_response.json()
    status = result.get("status")
    print(status)

    if status == "Ready":
        image_response = requests.get(result["result"]["sample"], timeout=60)
        image_response.raise_for_status()
        Path("flux-result.png").write_bytes(image_response.content)
        break
    if status in failure_statuses:
        raise RuntimeError(f"FLUX task failed: {status}")

    time.sleep(5)
else:
    raise TimeoutError("FLUX task did not finish in time")

import fs from "node:fs/promises";

const authHeaders = {
  Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
};

const createResponse = await fetch(
  "https://api.cometapi.com/flux/v1/flux-2-pro",
  {
    method: "POST",
    headers: { ...authHeaders, "Content-Type": "application/json" },
    signal: AbortSignal.timeout(60_000),
    body: JSON.stringify({
      prompt:
        "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
      width: 1280,
      height: 768,
      output_format: "png",
      seed: 424242,
    }),
  },
);

if (!createResponse.ok) throw new Error(await createResponse.text());
const { id } = await createResponse.json();

const failureStatuses = new Set([
  "Error",
  "Failed",
  "Failure",
  "Task not found",
  "Request Moderated",
  "Content Moderated",
  "failed",
  "failure",
]);
let completed = false;

for (let attempt = 0; attempt < 60; attempt += 1) {
  const resultResponse = await fetch(
    `https://api.cometapi.com/flux/v1/get_result?id=${encodeURIComponent(id)}`,
    { headers: authHeaders, signal: AbortSignal.timeout(30_000) },
  );
  if (!resultResponse.ok) throw new Error(await resultResponse.text());

  const result = await resultResponse.json();
  console.log(result.status);

  if (result.status === "Ready") {
    const imageResponse = await fetch(result.result.sample, {
      signal: AbortSignal.timeout(60_000),
    });
    if (!imageResponse.ok) throw new Error(await imageResponse.text());
    await fs.writeFile(
      "flux-result.png",
      Buffer.from(await imageResponse.arrayBuffer()),
    );
    completed = true;
    break;
  }
  if (failureStatuses.has(result.status)) {
    throw new Error(`FLUX task failed: ${result.status}`);
  }

  await new Promise((resolve) => setTimeout(resolve, 5000));
}

if (!completed) throw new Error("FLUX task did not finish in time");

同期的に生成する

作成レスポンスで完成した画像を受け取るには、JSON ブール値を false async に指定して送信します。成功したレスポンスには status: "Ready" と画像 URL が含まれます result.sample に含まれます。非同期ワークフローを使用するには、true を使用するか、async を省略します上記のとおりです。"false" を文字列として送信したり、async: false を webhook_url または webhook_secret と組み合わせたりしないでください。これらの例では、作成レスポンスを最大 300 秒待機してから、画像をダウンロードします。タイムアウトはクライアント設定であり、完了期限ではありません。

set -e

RESULT=$(curl \
  https://api.cometapi.com/flux/v1/flux-2-pro \
  --max-time 300 \
  --fail-with-body \
  --silent \
  --show-error \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red ceramic teapot on a pale blue table, soft window light.",
    "width": 1280,
    "height": 768,
    "output_format": "png",
    "seed": 424242,
    "async": false
  }')

if [ "$(printf '%s' "$RESULT" | jq -r '.status')" != "Ready" ]; then
  echo "FLUX generation did not return a Ready result" >&2
  exit 1
fi

IMAGE_URL=$(printf '%s' "$RESULT" | jq -er '.result.sample')
curl \
  "$IMAGE_URL" \
  --max-time 60 \
  --fail \
  --location \
  --output flux-result.png

import os
from pathlib import Path

import requests

response = requests.post(
    "https://api.cometapi.com/flux/v1/flux-2-pro",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "prompt": "A red ceramic teapot on a pale blue table, soft window light.",
        "width": 1280,
        "height": 768,
        "output_format": "png",
        "seed": 424242,
        "async": False,
    },
    timeout=300,
)
response.raise_for_status()
task = response.json()
if task.get("status") != "Ready":
    raise RuntimeError("FLUX generation did not return a Ready result")

image_response = requests.get(task["result"]["sample"], timeout=60)
image_response.raise_for_status()
Path("flux-result.png").write_bytes(image_response.content)

import fs from "node:fs/promises";

const response = await fetch(
  "https://api.cometapi.com/flux/v1/flux-2-pro",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    signal: AbortSignal.timeout(300_000),
    body: JSON.stringify({
      prompt: "A red ceramic teapot on a pale blue table, soft window light.",
      width: 1280,
      height: 768,
      output_format: "png",
      seed: 424242,
      async: false,
    }),
  },
);

if (!response.ok) throw new Error(await response.text());
const task = await response.json();
if (task.status !== "Ready") {
  throw new Error("FLUX generation did not return a Ready result");
}

const imageResponse = await fetch(task.result.sample, {
  signal: AbortSignal.timeout(60_000),
});
if (!imageResponse.ok) throw new Error(await imageResponse.text());
await fs.writeFile(
  "flux-result.png",
  Buffer.from(await imageResponse.arrayBuffer()),
);

フローの仕組み

async: true を指定した場合、または async フィールドがない場合、生成の継続中に作成エンドポイントはトップレベルのタスク id を返します。その id を使用して CometAPI の結果エンドポイントをポーリングします。Ready は成功時の終了状態です。既知のエラー状態およびモデレーション状態は失敗として扱い、その他の状態はクライアントのタイムアウトまでのみポーリングを続けてください。 async: false を指定した場合、成功した作成レスポンスには status: "Ready" と result.sample が含まれます。ポーリングせずに画像 URL を直接読み取ります。 result.sample は、完成した画像のダウンロードにのみ使用してください。これは一時 URL であり、永続的なアプリケーションストレージとして使用しないでください。

共通パラメータ

パラメータ	用途
`model` パスセグメント	URL パス内の FLUX.2 モデル ID。このクイックスタートでは `flux-2-pro` を使用します。アカウントで利用可能かどうかは、モデルを確認してください。
`prompt`	必須の画像説明または編集指示。
`async`	任意の JSON ブール値。`false` を指定すると、作成レスポンスで画像が返されるまで待機します。`true` を指定するか省略すると、非同期タスクが送信されます。`false` を `webhook_url` または `webhook_secret`.
`width` / `height`	要求する出力サイズ（ピクセル単位）。
`output_format`	選択したモデルでサポートされる形式。このクイックスタートでは `png`.
`seed`	任意のシード値。結果には使用されたシードが報告される場合がありますが、このフィールドだけでは再現可能な出力は保証されません。
`input_image`	編集用の公開 HTTPS 参照画像 URL。
`input_image_2`	FLUX.2 Pro 用の 2 つ目の公開 HTTPS 参照画像 URL。あわせて送信してください。 `input_image`.

トラブルシューティング

タスクが処理中の状態のままになる

上限を設けた再試行ループ内でポーリングを続けてください。クライアントのタイムアウトに達した場合は、後で調査できるようにタスク ID を保持し、成功ではなくタイムアウトとしてリクエストを報告してください。

画像 URL が機能しなくなった

result.sample は、タスクが Ready になった後すぐにダウンロードし、アプリケーションで管理するストレージに画像を保存してください。

リクエストフィールドが効果を持たない

以下を使用して FLUX 画像生成 API リファレンスモデルに適したリクエストフィールドを選択してください。フィールド名と JSON 型をリクエスト例と照合してください。

次のステップ

以下をお読みください： FLUX 画像生成 API リファレンス.
以下を使用して結果をポーリングします： FLUX 画像結果を取得.
利用可能な FLUX モデルは、以下で確認できます：モデル.

ここから始める

モデルAPIクイックスタート

Core API ガイド

ライブラリ

エラー

料金と請求

サポート

FLUX API クイックスタート：CometAPI で画像を生成

作成するもの

前提条件

エンドポイントと認証

コード例

同期的に生成する

フローの仕組み

共通パラメータ

トラブルシューティング

次のステップ

​作成するもの

​前提条件

​エンドポイントと認証

​コード例

​同期的に生成する

​フローの仕組み

​共通パラメータ

​トラブルシューティング

​次のステップ

作成するもの

前提条件

エンドポイントと認証

コード例

同期的に生成する

フローの仕組み

共通パラメータ

トラブルシューティング

次のステップ