Comfy Router で Stable Point Aware 3D を使用する

import asyncio
from comfy_sdk import AsyncComfy

# 環境変数から COMFY_API_KEY を読み取ります。
# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライ時に再利用します。
async def main():
    async with AsyncComfy() as client:
        handle = await client.models.submit(
            "stability/stable-point-aware-3d",
            {
                "foreground_ratio": 1.3,
                "image": "https://storage.googleapis.com/example-bucket/source.png",
                "seed": 12345,
                "texture_resolution": 1024,
            },
        )
        print("request_id:", handle.request_id)  # モデル ID と合わせて、別のプロセスに必要な情報はこれだけです

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

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

    print(result)

asyncio.run(main())

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

// 環境変数から COMFY_API_KEY を読み取ります。
// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライ時に再利用します。
const handle = await comfy.models.submit("stability/stable-point-aware-3d", {
  foreground_ratio: 1.3,
  image: "https://storage.googleapis.com/example-bucket/source.png",
  seed: 12345,
  texture_resolution: 1024,
});
console.log("requestId:", handle.requestId); // モデル ID と合わせて、別のプロセスに必要な情報はこれだけです

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

// models.run() が返すのと同じ結果です。失敗またはキャンセルされたリクエストはここで reject されます。
const result = await handle.get();

console.log(result.data);

# 1. 送信します。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。
curl https://api.comfy.org/v2/models/stability/stable-point-aware-3d/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"foreground_ratio\": 1.3, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"seed\": 12345, \"texture_resolution\": 1024}"

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

# 3. 収集します。200 はモデルのネイティブ出力、実行中は 202 でステータスボディを返します。
curl https://api.comfy.org/v2/models/stability/stable-point-aware-3d/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"