将 H3 Max Turbo 与 Comfy Router 搭配使用

from comfy_sdk import Comfy

# 从环境变量中读取 COMFY_API_KEY。
# 每次 submit() 调用都会生成自己的 Idempotency-Key，并在自动重试时复用它。
with Comfy() as client:
    handle = client.models.submit(
        "fal/h3-max-turbo",
        {
            "duration": 5,
            "prompt": "a red fox running through a snowy forest",
            "prompt_expansion_mode": "balanced",
            "resolution": "480P",
        },
    )
    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(result)

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

// 从环境变量中读取 COMFY_API_KEY。
// 每次 submit() 调用都会生成自己的 Idempotency-Key，并在自动重试时复用它。
const handle = await comfy.models.submit("fal/h3-max-turbo", {
  duration: 5,
  prompt: "a red fox running through a snowy forest",
  prompt_expansion_mode: "balanced",
  resolution: "480P",
});
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();

console.log(result.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(
    "fal/h3-max-turbo",
    input: [
        "duration": 5,
        "prompt": "a red fox running through a snowy forest",
        "prompt_expansion_mode": "balanced",
        "resolution": "480P",
    ]
)
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(result.output)

# 1. 提交。Router 返回 201，以及 request_id、status_url、response_url 和 cancel_url。
curl https://api.comfy.org/v2/models/fal/h3-max-turbo/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"duration\": 5, \"prompt\": \"a red fox running through a snowy forest\", \"prompt_expansion_mode\": \"balanced\", \"resolution\": \"480P\"}"

# 2. 轮询直到状态为 COMPLETED，每次等待响应中指定的 Retry-After 秒数。
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/fal/h3-max-turbo/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 收集。返回 200 和模型的原生输出；若仍在运行，则返回 202 和状态正文。
curl https://api.comfy.org/v2/models/fal/h3-max-turbo/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"