Comfy Router で Nano Banana Pro を使う

from comfy_sdk import Comfy

# 環境から COMFY_API_KEY を読み取ります。
# 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライのために再利用します。
with Comfy() as client:
    handle = client.models.submit(
        "vertexai/gemini-3-pro-image",
        {
            "contents": [
                {
                    "role": "user",
                    "parts": [
                        {
                            "text": "a single red maple leaf on a plain white background, studio lighting",
                        },
                    ],
                },
            ],
            "generationConfig": {
                "responseModalities": ["IMAGE"],
                "imageConfig": {
                    "aspectRatio": "1:1",
                },
            },
        },
    )
    print("request_id:", handle.request_id)  # モデル ID とともに、別のプロセスが必要とするものすべて

    # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の分だけ待機します。
    for update in handle.iter_events():
        print(update.status, update.queue_position)

    # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。
    # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。
    result = handle.get()

print("image (base64):", result["candidates"][0]["content"]["parts"][0]["inlineData"]["data"])

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

// 環境から COMFY_API_KEY を読み取ります。
// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライのために再利用します。
type Result = { candidates: { content: { parts: { inlineData: { data: string } }[] } }[] };
const handle = await comfy.models.submit<Result>("vertexai/gemini-3-pro-image", {
  contents: [
    {
      role: "user",
      parts: [
        {
          text: "a single red maple leaf on a plain white background, studio lighting",
        },
      ],
    },
  ],
  generationConfig: {
    responseModalities: ["IMAGE"],
    imageConfig: {
      aspectRatio: "1:1",
    },
  },
});
console.log("requestId:", handle.requestId); // モデル ID とともに、別のプロセスが必要とするものすべて

// リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の分だけ待機します。
for await (const update of handle.events()) {
  console.log(update.status, update.queuePosition);
}

// models.run() が返すのと同じ結果です。失敗またはキャンセルされたリクエストはここで拒否されます。
const result = await handle.get();
if (result.kind !== "json") throw new Error("expected a JSON result");

console.log("image (base64):", result.data.candidates[0].content.parts[0].inlineData.data);

import Foundation
import ComfySwiftSDK

// 環境から COMFY_API_KEY を読み取ります。
// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライのために再利用します。
let client = ComfyCloudClient(apiKey: ProcessInfo.processInfo.environment["COMFY_API_KEY"]!)
let handle = try await client.models.submit(
    "vertexai/gemini-3-pro-image",
    input: [
        "contents": [
            [
                "role": "user",
                "parts": [
                    [
                        "text": "a single red maple leaf on a plain white background, studio lighting",
                    ],
                ],
            ],
        ],
        "generationConfig": [
            "responseModalities": ["IMAGE"],
            "imageConfig": [
                "aspectRatio": "1:1",
            ],
        ],
    ]
)
print("requestId:", handle.requestId)  // モデル ID とともに、別のプロセスが必要とするものすべて

// リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の分だけ待機します。
for try await update in handle.events() {
    print(update.state.rawValue, update.queuePosition.map(String.init) ?? "unknown")
}

// プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。
// 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーをスローします。
let result = try await handle.result()

print("image (base64):", result.output["candidates"][0]["content"]["parts"][0]["inlineData"]["data"].stringValue ?? "")

# 1. 送信。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。
curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"a single red maple leaf on a plain white background, studio lighting\"}]}], \"generationConfig\": {\"responseModalities\":[\"IMAGE\"],\"imageConfig\":{\"aspectRatio\":\"1:1\"}}}"

# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 収集。モデルのネイティブ出力とともに 200、まだ実行中はステータスボディとともに 202。
curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"