将 Higgsfield Kling 3.4k 与 Comfy Router 搭配使用

from comfy_sdk import Comfy

# 从环境变量中读取 COMFY_API_KEY。
# 每次 submit() 调用都会生成自己的 Idempotency-Key，并在自动重试时复用它。
with Comfy() as client:
    handle = client.models.submit(
        "higgsfield/higgsfield-kling-3-4k",
        {
            "aspect_ratio": "16:9",
            "cfg_scale": 0.5,
            "duration": 5,
            "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
            "sound": "on",
        },
    )
    print("request_id:", handle.request_id)  # 加上模型 ID，就是另一个进程所需的全部信息

    # 持续轮询直到请求完成，按服务器给出的 Retry-After 等待。
    for update in handle.iter_events():
        print(update.status, update.queue_position)

    # 提供商自身的 payload，与 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("higgsfield/higgsfield-kling-3-4k", {
  aspect_ratio: "16:9",
  cfg_scale: 0.5,
  duration: 5,
  prompt: "A cinematic glass pavilion in a misty pine forest at sunrise",
  sound: "on",
});
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(
    "higgsfield/higgsfield-kling-3-4k",
    input: [
        "aspect_ratio": "16:9",
        "cfg_scale": 0.5,
        "duration": 5,
        "prompt": "A cinematic glass pavilion in a misty pine forest at sunrise",
        "sound": "on",
    ]
)
print("requestId:", handle.requestId)  // 加上模型 ID，就是另一个进程所需的全部信息

// 持续轮询直到请求完成，按服务器给出的 Retry-After 等待。
for try await update in handle.events() {
    print(update.state.rawValue, update.queuePosition.map(String.init) ?? "unknown")
}

// 提供商自身的 payload，与 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/higgsfield/higgsfield-kling-3-4k/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"aspect_ratio\": \"16:9\", \"cfg_scale\": 0.5, \"duration\": 5, \"prompt\": \"A cinematic glass pavilion in a misty pine forest at sunrise\", \"sound\": \"on\"}"

# 2. 持续轮询直到状态为 COMPLETED，按每个响应中给出的 Retry-After 秒数等待。
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-4k/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 收集。200 返回模型的原生输出，仍在运行时 202 返回状态响应体。
curl https://api.comfy.org/v2/models/higgsfield/higgsfield-kling-3-4k/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"