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용 두 번째 공개 HTTPS 참조 이미지 URL입니다. 또한 `input_image`.

문제 해결

작업이 processing 상태에서 벗어나지 않음

제한된 재시도 루프 내에서 계속 폴링하세요. 클라이언트 시간 제한에 도달하면 나중에 검사할 수 있도록 작업 ID를 보관하고, 성공으로 처리하지 말고 시간 초과로 보고하세요.

이미지 URL이 더 이상 작동하지 않음

작업이 result.sample이 된 직후 Ready을 즉시 다운로드한 다음, 애플리케이션이 제어하는 스토리지에 이미지를 저장하세요.

요청 필드가 적용되지 않음

모델의 요청 필드를 선택하려면 FLUX 이미지 API 참조 생성 을 참조하세요. 요청 예시와 비교하여 필드 이름과 JSON 유형을 확인하세요.

다음 단계

다음 문서를 읽어보세요: FLUX 이미지 API 참조 생성.
다음을 사용하여 결과를 폴링하세요: FLUX 이미지 결과 가져오기.
다음에서 사용 가능한 FLUX 모델을 확인하세요: 모델.

여기서 시작하기

모델 API 빠른 시작

핵심 API 가이드

라이브러리

오류

요금 및 청구

지원

FLUX API 빠른 시작: CometAPI로 이미지 생성

만들게 될 항목

사전 요구 사항

엔드포인트 및 인증

코드 예제

동기식으로 생성

흐름 작동 방식

공통 파라미터

문제 해결

다음 단계

​만들게 될 항목

​사전 요구 사항

​엔드포인트 및 인증

​코드 예제

​동기식으로 생성

​흐름 작동 방식

​공통 파라미터

​문제 해결

​다음 단계

만들게 될 항목

사전 요구 사항

엔드포인트 및 인증

코드 예제

동기식으로 생성

흐름 작동 방식

공통 파라미터

문제 해결

다음 단계