Comfy Router quickstart

curl --max-time 660 \
  https://api.comfy.org/v2/models/bfl/flux-2-pro \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $COMFY_REQUEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a red teapot on a windowsill, morning light"}'

# Python 3.10+
# Install: python -m pip install "comfy-sdk>=0.3.0"
# Save as quickstart.py, then run: python quickstart.py

import os

from comfy_sdk import Comfy

# Comfy reads COMFY_API_KEY from the environment.
with Comfy() as client:
    result = client.models.run(
        "bfl/flux-2-pro",
        {"prompt": "a red teapot on a windowsill, morning light"},
        idempotency_key=os.environ["COMFY_REQUEST_KEY"],
        timeout=660.0,
    )

print("image:", result["result"]["sample"])

// Node.js 22+
// Install: npm install @comfyorg/sdk@^0.3.0 --save-dev tsx
// Save as quickstart.mts, then run: npx tsx quickstart.mts

import { comfy } from "@comfyorg/sdk";

// Comfy reads COMFY_API_KEY from the environment.
type FluxResult = { result: { sample: string } };
const idempotencyKey = process.env.COMFY_REQUEST_KEY;
if (!idempotencyKey) throw new Error("Set COMFY_REQUEST_KEY first.");

const { data } = await comfy.models.run<FluxResult>(
  "bfl/flux-2-pro",
  { prompt: "a red teapot on a windowsill, morning light" },
  { idempotencyKey, timeoutMs: 660_000 },
);

console.log("image:", data.result.sample);