配合 Comfy Router 使用 MiniMax H3

from comfy_sdk import Comfy

# 从环境变量中读取 COMFY_API_KEY。
# 每次 submit() 调用都会生成自己的 Idempotency-Key，并在自动重试时复用它。
with Comfy() as client:
    handle = client.models.submit(
        "minimax/minimax-h3",
        {
            "content": [
                {
                    "text": "A single red maple leaf resting on a plain white background.",
                    "type": "text",
                },
            ],
            "duration": 5,
            "ratio": "16:9",
            "resolution": "768P",
        },
    )
    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("video:", result["task"]["content"]["url"])

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

// 从环境变量中读取 COMFY_API_KEY。
// 每次 submit() 调用都会生成自己的 Idempotency-Key，并在自动重试时复用它。
type Result = { task: { content: { url: string } } };
const handle = await comfy.models.submit<Result>("minimax/minimax-h3", {
  content: [
    {
      text: "A single red maple leaf resting on a plain white background.",
      type: "text",
    },
  ],
  duration: 5,
  ratio: "16:9",
  resolution: "768P",
});
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();
if (result.kind !== "json") throw new Error("expected a JSON result");

console.log("video:", result.data.task.content.url);

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(
    "minimax/minimax-h3",
    input: [
        "content": [
            [
                "text": "A single red maple leaf resting on a plain white background.",
                "type": "text",
            ],
        ],
        "duration": 5,
        "ratio": "16:9",
        "resolution": "768P",
    ]
)
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("video:", result.output["task"]["content"]["url"].stringValue ?? "")

# 1. 提交。Router 返回 201，并附带 request_id、status_url、response_url 和 cancel_url。
curl https://api.comfy.org/v2/models/minimax/minimax-h3/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"content\": [{\"text\":\"A single red maple leaf resting on a plain white background.\",\"type\":\"text\"}], \"duration\": 5, \"ratio\": \"16:9\", \"resolution\": \"768P\"}"

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

# 3. 收集。返回 200 时携带模型的原生输出；仍在运行时会以 202 返回状态正文。
curl https://api.comfy.org/v2/models/minimax/minimax-h3/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"