Comfy Router 빠른 시작

# Python 3.10+
# 설치: python -m pip install "comfy-sdk>=0.3.0"
# quickstart.py로 저장한 다음 실행: python quickstart.py

import asyncio

from comfy_sdk import AsyncComfy

# AsyncComfy는 환경 변수에서 COMFY_API_KEY를 읽습니다.
async def main():
    async with AsyncComfy() as client:
        handle = await client.models.submit(
            "byteplus/dreamina-seedance-2-5-260628",
            {
                "content": [
                    {
                        "text": "A red fox trotting through a snowy pine forest",
                        "type": "text",
                    },
                ],
                "duration": 5,
                "ratio": "16:9",
                "resolution": "720p",
            },
        )
        print("request_id:", handle.request_id)

        # 서버가 알려주는 Retry-After를 기다리며 요청이 완료될 때까지 폴링합니다.
        async for update in handle.iter_events():
            print(update.status, update.queue_position)

        result = await handle.get()

    print("result:", result)

asyncio.run(main())

# 1. 요청을 제출합니다. 201 응답에서 request_id를 저장하세요.
curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"content": [{"text": "A red fox trotting through a snowy pine forest", "type": "text"}], "duration": 5, "ratio": "16:9", "resolution": "720p"}'

# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 매번 Retry-After 값을 기다립니다.
REQUEST_ID="paste-request-id-from-201-response"
curl -i "https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests/$REQUEST_ID/status" \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 모델 결과를 가져옵니다.
curl "https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests/$REQUEST_ID" \
  -H "X-API-Key: $COMFY_API_KEY"

// Node.js 22+
// 설치: npm install "@comfyorg/sdk@>=0.4.0" --save-dev tsx
// quickstart.mts로 저장한 다음 실행: npx tsx quickstart.mts

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

// Comfy는 환경 변수에서 COMFY_API_KEY를 읽습니다.
const handle = await comfy.models.submit(
  "byteplus/dreamina-seedance-2-5-260628",
  {
    content: [
      {
        text: "A red fox trotting through a snowy pine forest",
        type: "text",
      },
    ],
    duration: 5,
    ratio: "16:9",
    resolution: "720p",
  },
);
console.log("requestId:", handle.requestId);

// 서버가 알려주는 Retry-After를 기다리며 요청이 완료될 때까지 폴링합니다.
for await (const update of handle.events()) {
  console.log(update.status, update.queuePosition);
}

const result = await handle.get();

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