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);