docs(comfy-router): narrow RunResult in the TypeScript snippets for SDK 0.3.0

.github/scripts/snippets/gen-code-pages.ts

@@ -336,11 +336,12 @@ function typescriptSnippet(model: string, example: Record<string, unknown>, file
 ${reads ? `${reads}\n\n` : ""}// Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = ${tsResultType(resultPath)};
-const { data } = await comfy.models.run<Result>("${model}", {
+const result = await comfy.models.run<Result>("${model}", {
 ${body}
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("${label}:", data${tsPath(resultPath)});`;
+console.log("${label}:", result.data${tsPath(resultPath)});`;
 }
 
 function curlSnippet(model: string, example: Record<string, unknown>, files: FileInput[]): string {

development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code.mdx

@@ -50,13 +50,14 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { result: { sample: string } };
-const { data } = await comfy.models.run<Result>("bfl/flux-pro-1.1-ultra", {
+const result = await comfy.models.run<Result>("bfl/flux-pro-1.1-ultra", {
   prompt: "a single red maple leaf on a plain white background, studio lighting",
   aspect_ratio: "16:9",
   raw: false,
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image:", data.result.sample);
+console.log("image:", result.data.result.sample);
 ```
 
 ```bash cURL
@@ -75,7 +76,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -176,7 +177,7 @@
 </ParamField>
 
 <ParamField body="prompt_upsampling" type="boolean" default="false">
   Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.
 </ParamField>
 
 <ParamField body="raw" type="boolean" default="false">
@@ -226,11 +227,11 @@
 </ResponseField>
 
 <ResponseField name="result" type="object" required>
   The finished generation. Not nullable here: this component's `required` entry is a promise that a `200` carries the result, and a nullable `result` would reduce it to a key-presence check.
 </ResponseField>
 
 <ResponseField name="result.cost" type="number">
   Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.
 
   Format: `double`
 </ResponseField>
@@ -248,17 +249,17 @@
 </ResponseField>
 
 <ResponseField name="result.prompt" type="string">
   The prompt the generation actually ran, after any prompt upsampling.
 </ResponseField>
 
 <ResponseField name="result.sample" type="string (uri)">
   Signed URL for the generated asset. Router re-hosts the asset onto Comfy storage and rewrites this field, so it is normally a Comfy-hosted URL valid for up to 24 hours - signed for 24 hours when minted, and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left; a leaf whose re-host could not be performed keeps BFL's own short-lived delivery URL instead - roughly two hours for video, roughly ten minutes for images. Either way the link expires, so download the asset rather than storing the URL.
 
   Format: `uri`
 </ResponseField>
 
 <ResponseField name="result.seed" type="integer">
   The seed the generation used, whether supplied or chosen by the provider. Declared `int64` because BFL returns seeds above 2^31 (e.g. 2784347701), which an unformatted `integer` generates as a 32-bit field in many SDK generators.
 
   Format: `int64`
 </ResponseField>
@@ -310,10 +311,10 @@
   <Tab title="Wait for the result">
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # The SDK automatically creates an idempotency key and reuses it for automatic retries.
 with Comfy() as client:
     result = client.models.run(
         "bfl/flux-pro-1.1",
@@ -333,13 +334,14 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { result: { sample: string } };
-const { data } = await comfy.models.run<Result>("bfl/flux-pro-1.1", {
+const result = await comfy.models.run<Result>("bfl/flux-pro-1.1", {
   prompt: "a single red maple leaf on a plain white background, studio lighting",
   width: 1024,
   height: 768,
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image:", data.result.sample);
+console.log("image:", result.data.result.sample);
 ```
 
 ```bash cURL
@@ -358,7 +360,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -455,7 +457,7 @@
 </ParamField>
 
 <ParamField body="prompt_upsampling" type="boolean" default="false">
   Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.
 </ParamField>
 
 <ParamField body="safety_tolerance" type="integer" default="2">
@@ -507,11 +509,11 @@
 </ResponseField>
 
 <ResponseField name="result" type="object" required>
   The finished generation. Not nullable here: this component's `required` entry is a promise that a `200` carries the result, and a nullable `result` would reduce it to a key-presence check.
 </ResponseField>
 
 <ResponseField name="result.cost" type="number">
   Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.
 
   Format: `double`
 </ResponseField>
@@ -529,17 +531,17 @@
 </ResponseField>
 
 <ResponseField name="result.prompt" type="string">
   The prompt the generation actually ran, after any prompt upsampling.
 </ResponseField>
 
 <ResponseField name="result.sample" type="string (uri)">
   Signed URL for the generated asset. Router re-hosts the asset onto Comfy storage and rewrites this field, so it is normally a Comfy-hosted URL valid for up to 24 hours - signed for 24 hours when minted, and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left; a leaf whose re-host could not be performed keeps BFL's own short-lived delivery URL instead - roughly two hours for video, roughly ten minutes for images. Either way the link expires, so download the asset rather than storing the URL.
 
   Format: `uri`
 </ResponseField>
 
 <ResponseField name="result.seed" type="integer">
   The seed the generation used, whether supplied or chosen by the provider. Declared `int64` because BFL returns seeds above 2^31 (e.g. 2784347701), which an unformatted `integer` generates as a 32-bit field in many SDK generators.
 
   Format: `int64`
 </ResponseField>

development/comfy-router/models/black-forest-labs/flux-1-kontext/code.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Use FLUX.1 Kontext with Comfy Router"
 description: "Python, TypeScript and cURL snippets for calling FLUX.1 Kontext Pro and Kontext Max over HTTP through Comfy Router, plus the request fields and the result shape"
 sidebarTitle: "FLUX.1 Kontext"
 ---
 
@@ -41,7 +41,7 @@
         "bfl/flux-kontext-pro",
         {
             "prompt": "replace the background with a sunlit beach, keep the subject unchanged",
             "input_image": input_image,
             "aspect_ratio": "1:1",
         },
     )
@@ -58,13 +58,14 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { result: { sample: string } };
-const { data } = await comfy.models.run<Result>("bfl/flux-kontext-pro", {
+const result = await comfy.models.run<Result>("bfl/flux-kontext-pro", {
   prompt: "replace the background with a sunlit beach, keep the subject unchanged",
   input_image: inputImage,
   aspect_ratio: "1:1",
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image:", data.result.sample);
+console.log("image:", result.data.result.sample);
 ```
 
 ```bash cURL
@@ -87,9 +88,9 @@
 ```python Python
 import base64
 
 from comfy_sdk import Comfy
 
 with open("input.jpg", "rb") as f:
     input_image = base64.b64encode(f.read()).decode()
 
 # Reads COMFY_API_KEY from the environment.
@@ -198,11 +199,11 @@
 </ParamField>
 
 <ParamField body="prompt" type="string" required>
   Text prompt describing the edit to apply to input_image, or the image to generate when no input_image is given.
 </ParamField>
 
 <ParamField body="prompt_upsampling" type="boolean" default="false">
   Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.
 </ParamField>
 
 <ParamField body="safety_tolerance" type="integer" default="2">
@@ -248,11 +249,11 @@
 </ResponseField>
 
 <ResponseField name="result" type="object" required>
   The finished generation. Not nullable here: this component's `required` entry is a promise that a `200` carries the result, and a nullable `result` would reduce it to a key-presence check.
 </ResponseField>
 
 <ResponseField name="result.cost" type="number">
   Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.
 
   Format: `double`
 </ResponseField>
@@ -270,17 +271,17 @@
 </ResponseField>
 
 <ResponseField name="result.prompt" type="string">
   The prompt the generation actually ran, after any prompt upsampling.
 </ResponseField>
 
 <ResponseField name="result.sample" type="string (uri)">
   Signed URL for the generated asset. Router re-hosts the asset onto Comfy storage and rewrites this field, so it is normally a Comfy-hosted URL valid for up to 24 hours - signed for 24 hours when minted, and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left; a leaf whose re-host could not be performed keeps BFL's own short-lived delivery URL instead - roughly two hours for video, roughly ten minutes for images. Either way the link expires, so download the asset rather than storing the URL.
 
   Format: `uri`
 </ResponseField>
 
 <ResponseField name="result.seed" type="integer">
   The seed the generation used, whether supplied or chosen by the provider. Declared `int64` because BFL returns seeds above 2^31 (e.g. 2784347701), which an unformatted `integer` generates as a 32-bit field in many SDK generators.
 
   Format: `int64`
 </ResponseField>
@@ -334,13 +335,13 @@
 ```python Python
 import base64
 
 from comfy_sdk import Comfy
 
 with open("input.jpg", "rb") as f:
     input_image = base64.b64encode(f.read()).decode()
 
 # Reads COMFY_API_KEY from the environment.
 # The SDK automatically creates an idempotency key and reuses it for automatic retries.
 with Comfy() as client:
     result = client.models.run(
         "bfl/flux-kontext-max",
@@ -363,13 +364,14 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { result: { sample: string } };
-const { data } = await comfy.models.run<Result>("bfl/flux-kontext-max", {
+const result = await comfy.models.run<Result>("bfl/flux-kontext-max", {
   prompt: "replace the background with a sunlit beach, keep the subject unchanged",
   input_image: inputImage,
   aspect_ratio: "1:1",
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image:", data.result.sample);
+console.log("image:", result.data.result.sample);
 ```
 
 ```bash cURL
@@ -392,9 +394,9 @@
 ```python Python
 import base64
 
 from comfy_sdk import Comfy
 
 with open("input.jpg", "rb") as f:
     input_image = base64.b64encode(f.read()).decode()
 
 # Reads COMFY_API_KEY from the environment.
@@ -503,11 +505,11 @@
 </ParamField>
 
 <ParamField body="prompt" type="string" required>
   Text prompt describing the edit to apply to input_image, or the image to generate when no input_image is given.
 </ParamField>
 
 <ParamField body="prompt_upsampling" type="boolean" default="false">
   Whether to upsample the prompt. If active, the prompt is automatically modified for more creative generation.
 </ParamField>
 
 <ParamField body="safety_tolerance" type="integer" default="2">
@@ -553,11 +555,11 @@
 </ResponseField>
 
 <ResponseField name="result" type="object" required>
   The finished generation. Not nullable here: this component's `required` entry is a promise that a `200` carries the result, and a nullable `result` would reduce it to a key-presence check.
 </ResponseField>
 
 <ResponseField name="result.cost" type="number">
   Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.
 
   Format: `double`
 </ResponseField>
@@ -575,17 +577,17 @@
 </ResponseField>
 
 <ResponseField name="result.prompt" type="string">
   The prompt the generation actually ran, after any prompt upsampling.
 </ResponseField>
 
 <ResponseField name="result.sample" type="string (uri)">
   Signed URL for the generated asset. Router re-hosts the asset onto Comfy storage and rewrites this field, so it is normally a Comfy-hosted URL valid for up to 24 hours - signed for 24 hours when minted, and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left; a leaf whose re-host could not be performed keeps BFL's own short-lived delivery URL instead - roughly two hours for video, roughly ten minutes for images. Either way the link expires, so download the asset rather than storing the URL.
 
   Format: `uri`
 </ResponseField>
 
 <ResponseField name="result.seed" type="integer">
   The seed the generation used, whether supplied or chosen by the provider. Declared `int64` because BFL returns seeds above 2^31 (e.g. 2784347701), which an unformatted `integer` generates as a 32-bit field in many SDK generators.
 
   Format: `int64`
 </ResponseField>

development/comfy-router/models/black-forest-labs/flux-3-video/code.mdx

@@ -48,15 +48,16 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { result: { sample: string } };
-const { data } = await comfy.models.run<Result>("bfl/flux-3-video", {
+const result = await comfy.models.run<Result>("bfl/flux-3-video", {
   mode: "t2v",
   prompt: "a single red maple leaf falling onto still water, slow motion",
   duration: 5,
   aspect_ratio: "16:9",
   generate_audio: true,
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.result.sample);
+console.log("video:", result.data.result.sample);
 ```
 
 ```bash cURL
@@ -75,7 +76,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -160,11 +161,11 @@
 </ParamField>
 
 <ParamField body="draft" type="boolean" default="false">
   Draft mode: generate a fast preview whose result includes a draft_cache download URL. Send that bundle back with mode draft_enhance to render the full-quality version of the same generation.
 </ParamField>
 
 <ParamField body="draft_cache" type="string">
   draft_enhance only. Encrypted draft-cache bundle from a prior draft generation, as the base64-encoded downloaded bundle or its still-valid http(s) URL. The original inputs are embedded in the bundle.
 </ParamField>
 
 <ParamField body="duration" type="integer | string" default="&quot;auto&quot;">
@@ -182,17 +183,17 @@
 </ParamField>
 
 <ParamField body="mode" type="string" required>
   Generation mode: t2v (text-to-video), i2v (image-continuation), v2v (video-continuation), or draft_enhance (full-quality render of a prior draft). Spelled-out aliases such as text-to-video are accepted.
 </ParamField>
 
 <ParamField body="prompt" type="string">
   Free-form prompt describing the video. Required for every mode except draft_enhance.
 </ParamField>
 
 <ParamField body="resolution" type="string">
   Video resolution class: hd, or fhd for a higher-resolution result finished by the video upsampler. Defaults to hd for t2v, i2v and v2v, and to fhd for draft_enhance. Exact dimensions vary with the aspect ratio.
 
   Possible values: `hd`, `fhd`
 </ParamField>
 
 <ParamField body="safety_tolerance" type="integer" default="2">
@@ -206,7 +207,7 @@
 </ParamField>
 
 <ParamField body="version" type="string" default="&quot;latest&quot;">
   Endpoint version. latest serves the current release; dated pinnable release tags are added as they are published.
 </ParamField>
 
 Generated from the schema Router serves at `GET /v2/models/bfl/flux-3-video/openapi.json`, the same document it validates a call against before the request reaches the provider.
@@ -236,25 +237,25 @@
 </ResponseField>
 
 <ResponseField name="result.cost" type="number">
   Provider-reported task cost. This is BFL's number, not the Comfy charge.
 
   Format: `double`
 </ResponseField>
 
 <ResponseField name="result.draft_cache" type="string (uri)">
   Signed URL returned INSTEAD of `sample` by the `draft: true` mode, re-hosted onto Comfy storage the same way `sample` is: normally a Comfy-hosted URL valid for up to 24 hours, and BFL's own roughly two-hour delivery URL when the re-host could not be performed.
 
   Format: `uri`
 </ResponseField>
 
 <ResponseField name="result.sample" type="string (uri)">
   Signed URL for the generated MP4. Router re-hosts the asset onto Comfy storage and rewrites this field, so it is normally a Comfy-hosted URL valid for up to 24 hours - signed for 24 hours when minted and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left; a leaf whose re-host could not be performed keeps BFL's own roughly two-hour delivery URL instead. Absent in `draft: true` mode.
 
   Format: `uri`
 </ResponseField>
 
 <ResponseField name="status" type="string" required>
   Task status: Pending, Reasoning, Generating, Ready, Request Moderated, Content Moderated, Error, or Task not found. Compare case-insensitively; Router forwards BFL's spelling unchanged.
 </ResponseField>
 
 ## Examples

development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Use FLUX Video Upscale with Comfy Router"
 description: "Python, TypeScript and cURL snippets for upscaling a video with FLUX Video Upscale over HTTP through Comfy Router, plus the request fields and the result shape"
 sidebarTitle: "FLUX Video Upscale"
 ---
 
@@ -46,13 +46,14 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { result: { sample: string } };
-const { data } = await comfy.models.run<Result>("bfl/video-upscale-v1", {
+const result = await comfy.models.run<Result>("bfl/video-upscale-v1", {
   input_video: "https://your-host.example/clip.mp4",
   upscale_factor: 2,
   creativity: 1,
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.result.sample);
+console.log("video:", result.data.result.sample);
 ```
 
 ```bash cURL
@@ -71,7 +72,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -208,11 +209,11 @@
 </ResponseField>
 
 <ResponseField name="result" type="object" required>
   The finished generation. Not nullable here: this component's `required` entry is a promise that a `200` carries the result, and a nullable `result` would reduce it to a key-presence check.
 </ResponseField>
 
 <ResponseField name="result.cost" type="number">
   Provider-reported cost of the generation. This is BFL's number, not the Comfy charge.
 
   Format: `double`
 </ResponseField>
@@ -230,17 +231,17 @@
 </ResponseField>
 
 <ResponseField name="result.prompt" type="string">
   The prompt the generation actually ran, after any prompt upsampling.
 </ResponseField>
 
 <ResponseField name="result.sample" type="string (uri)">
   Signed URL for the generated asset. Router re-hosts the asset onto Comfy storage and rewrites this field, so it is normally a Comfy-hosted URL valid for up to 24 hours - signed for 24 hours when minted, and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left; a leaf whose re-host could not be performed keeps BFL's own short-lived delivery URL instead - roughly two hours for video, roughly ten minutes for images. Either way the link expires, so download the asset rather than storing the URL.
 
   Format: `uri`
 </ResponseField>
 
 <ResponseField name="result.seed" type="integer">
   The seed the generation used, whether supplied or chosen by the provider. Declared `int64` because BFL returns seeds above 2^31 (e.g. 2784347701), which an unformatted `integer` generates as a 32-bit field in many SDK generators.
 
   Format: `int64`
 </ResponseField>

development/comfy-router/models/google/gemini/code.mdx

@@ -61,7 +61,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { candidates: { content: { parts: { text: string }[] } }[] };
-const { data } = await comfy.models.run<Result>("vertexai/gemini-3.1-pro-preview", {
+const result = await comfy.models.run<Result>("vertexai/gemini-3.1-pro-preview", {
   contents: [
     {
       role: "user",
@@ -77,8 +77,9 @@
     maxOutputTokens: 256,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("text:", data.candidates[0].content.parts[0].text);
+console.log("text:", result.data.candidates[0].content.parts[0].text);
 ```
 
 ```bash cURL
@@ -97,7 +98,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -115,7 +116,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "temperature": 0.7,
                 "maxOutputTokens": 256,
             },
@@ -200,10 +201,10 @@
   <Tab title="Wait for the result">
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # The SDK automatically creates an idempotency key and reuses it for automatic retries.
 with Comfy() as client:
     result = client.models.run(
         "vertexai/gemini-3.5-flash",
@@ -218,7 +219,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "temperature": 0.7,
                 "maxOutputTokens": 256,
             },
@@ -234,7 +235,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { candidates: { content: { parts: { text: string }[] } }[] };
-const { data } = await comfy.models.run<Result>("vertexai/gemini-3.5-flash", {
+const result = await comfy.models.run<Result>("vertexai/gemini-3.5-flash", {
   contents: [
     {
       role: "user",
@@ -250,8 +251,9 @@
     maxOutputTokens: 256,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("text:", data.candidates[0].content.parts[0].text);
+console.log("text:", result.data.candidates[0].content.parts[0].text);
 ```
 
 ```bash cURL
@@ -270,7 +272,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -288,7 +290,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "temperature": 0.7,
                 "maxOutputTokens": 256,
             },
@@ -373,10 +375,10 @@
   <Tab title="Wait for the result">
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # The SDK automatically creates an idempotency key and reuses it for automatic retries.
 with Comfy() as client:
     result = client.models.run(
         "vertexai/gemini-2.5-pro",
@@ -391,7 +393,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "temperature": 0.7,
                 "maxOutputTokens": 256,
             },
@@ -407,7 +409,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { candidates: { content: { parts: { text: string }[] } }[] };
-const { data } = await comfy.models.run<Result>("vertexai/gemini-2.5-pro", {
+const result = await comfy.models.run<Result>("vertexai/gemini-2.5-pro", {
   contents: [
     {
       role: "user",
@@ -423,8 +425,9 @@
     maxOutputTokens: 256,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("text:", data.candidates[0].content.parts[0].text);
+console.log("text:", result.data.candidates[0].content.parts[0].text);
 ```
 
 ```bash cURL
@@ -443,7 +446,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -461,7 +464,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "temperature": 0.7,
                 "maxOutputTokens": 256,
             },
@@ -546,10 +549,10 @@
   <Tab title="Wait for the result">
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # The SDK automatically creates an idempotency key and reuses it for automatic retries.
 with Comfy() as client:
     result = client.models.run(
         "vertexai/gemini-2.5-flash",
@@ -564,7 +567,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "temperature": 0.7,
                 "maxOutputTokens": 256,
             },
@@ -580,7 +583,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { candidates: { content: { parts: { text: string }[] } }[] };
-const { data } = await comfy.models.run<Result>("vertexai/gemini-2.5-flash", {
+const result = await comfy.models.run<Result>("vertexai/gemini-2.5-flash", {
   contents: [
     {
       role: "user",
@@ -596,8 +599,9 @@
     maxOutputTokens: 256,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("text:", data.candidates[0].content.parts[0].text);
+console.log("text:", result.data.candidates[0].content.parts[0].text);
 ```
 
 ```bash cURL
@@ -616,7 +620,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -634,7 +638,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "temperature": 0.7,
                 "maxOutputTokens": 256,
             },
@@ -724,22 +728,22 @@
 
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData" type="object">
   URI based data.
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.fileUri" type="string">
   URI
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.mimeType" type="string">
   The media type of the file specified in the data or fileUri fields. Acceptable values include the following. For gemini-2.0-flash-lite and gemini-2.0-flash, the maximum length of an audio file is 8.4 hours and the maximum length of a video file (without audio) is one hour. For more information, see Gemini audio and video requirements. Text files must be UTF-8 encoded. The contents of the text file count toward the token limit. There is no limit on image resolution.
 
   Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData.data" type="string (byte)">
@@ -871,7 +875,7 @@
 </ParamField>
 
 <ParamField body="systemInstruction" type="object">
   Instructions for the model to steer it toward better performance. For example, "Answer as concisely as possible" or "Don't use technical terms in your response". The text strings count toward the token limit. The role field of systemInstruction is ignored and doesn't affect the performance of the model. Note: Only text should be used in parts and content in each part should be in a separate paragraph.
 </ParamField>
 
 <ParamField body="systemInstruction.parts" type="object[]" required>
@@ -913,14 +917,14 @@
 </ParamField>
 
 <ParamField body="videoMetadata" type="object">
   For video input, the start and end offset of the video in Duration format. For example, to specify a 10 second clip starting at 1:00, set "startOffset": \{ "seconds": 60 } and "endOffset": \{ "seconds": 70 }. The metadata should only be specified while the video data is presented in inlineData or fileData.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset" type="object">
   Represents a duration offset for video timeline positions.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset.nanos" type="integer">
   Signed fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanos values.
 
   Range: `0` to `999999999`
@@ -1015,7 +1019,7 @@
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData.data" type="string (byte)">
@@ -1129,7 +1133,7 @@
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokenCount" type="integer">
   Number of tokens in the request. When cachedContent is set, this is still the total effective prompt size meaning this includes the number of tokens in the cached content.
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokensDetails" type="object[]">

development/comfy-router/models/google/nano-banana-2-lite/code.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Use Nano Banana 2 Lite with Comfy Router"
 description: "Python, TypeScript and cURL snippets for generating images with Nano Banana 2 Lite (Gemini 3.1 Flash-Lite Image) over HTTP through Comfy Router, plus the request fields and the result shape"
 sidebarTitle: "Nano Banana 2 Lite"
 ---
 
@@ -58,8 +58,8 @@
 
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { candidates: { content: { parts: { inlineData: { data: string } }[] } }[] };
-const { data } = await comfy.models.run<Result>("vertexai/gemini-3.1-flash-lite-image", {
+const result = await comfy.models.run<Result>("vertexai/gemini-3.1-flash-lite-image", {
   contents: [
     {
       role: "user",
@@ -77,8 +77,9 @@
     },
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image (base64):", data.candidates[0].content.parts[0].inlineData.data);
+console.log("image (base64):", result.data.candidates[0].content.parts[0].inlineData.data);
 ```
 
 ```bash cURL
@@ -97,7 +98,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -115,7 +116,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "responseModalities": ["IMAGE"],
                 "imageConfig": {
                     "aspectRatio": "1:1",
@@ -207,22 +208,22 @@
 
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData" type="object">
   URI based data.
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.fileUri" type="string">
   URI
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.mimeType" type="string">
   The media type of the file specified in the data or fileUri fields. Acceptable values include the following. For gemini-2.0-flash-lite and gemini-2.0-flash, the maximum length of an audio file is 8.4 hours and the maximum length of a video file (without audio) is one hour. For more information, see Gemini audio and video requirements. Text files must be UTF-8 encoded. The contents of the text file count toward the token limit. There is no limit on image resolution.
 
   Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData.data" type="string (byte)">
@@ -354,7 +355,7 @@
 </ParamField>
 
 <ParamField body="systemInstruction" type="object">
   Instructions for the model to steer it toward better performance. For example, "Answer as concisely as possible" or "Don't use technical terms in your response". The text strings count toward the token limit. The role field of systemInstruction is ignored and doesn't affect the performance of the model. Note: Only text should be used in parts and content in each part should be in a separate paragraph.
 </ParamField>
 
 <ParamField body="systemInstruction.parts" type="object[]" required>
@@ -396,14 +397,14 @@
 </ParamField>
 
 <ParamField body="videoMetadata" type="object">
   For video input, the start and end offset of the video in Duration format. For example, to specify a 10 second clip starting at 1:00, set "startOffset": \{ "seconds": 60 } and "endOffset": \{ "seconds": 70 }. The metadata should only be specified while the video data is presented in inlineData or fileData.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset" type="object">
   Represents a duration offset for video timeline positions.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset.nanos" type="integer">
   Signed fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanos values.
 
   Range: `0` to `999999999`
@@ -498,7 +499,7 @@
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData.data" type="string (byte)">
@@ -612,7 +613,7 @@
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokenCount" type="integer">
   Number of tokens in the request. When cachedContent is set, this is still the total effective prompt size meaning this includes the number of tokens in the cached content.
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokensDetails" type="object[]">

development/comfy-router/models/google/nano-banana-2/code.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Use Nano Banana 2 with Comfy Router"
 description: "Python, TypeScript and cURL snippets for generating images with Nano Banana 2 (Gemini 3.1 Flash Image) over HTTP through Comfy Router, plus the request fields and the result shape"
 sidebarTitle: "Nano Banana 2"
 ---
 
@@ -58,8 +58,8 @@
 
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { candidates: { content: { parts: { inlineData: { data: string } }[] } }[] };
-const { data } = await comfy.models.run<Result>("vertexai/gemini-3.1-flash-image", {
+const result = await comfy.models.run<Result>("vertexai/gemini-3.1-flash-image", {
   contents: [
     {
       role: "user",
@@ -77,8 +77,9 @@
     },
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image (base64):", data.candidates[0].content.parts[0].inlineData.data);
+console.log("image (base64):", result.data.candidates[0].content.parts[0].inlineData.data);
 ```
 
 ```bash cURL
@@ -97,7 +98,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -115,7 +116,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "responseModalities": ["IMAGE"],
                 "imageConfig": {
                     "aspectRatio": "1:1",
@@ -207,22 +208,22 @@
 
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData" type="object">
   URI based data.
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.fileUri" type="string">
   URI
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.mimeType" type="string">
   The media type of the file specified in the data or fileUri fields. Acceptable values include the following. For gemini-2.0-flash-lite and gemini-2.0-flash, the maximum length of an audio file is 8.4 hours and the maximum length of a video file (without audio) is one hour. For more information, see Gemini audio and video requirements. Text files must be UTF-8 encoded. The contents of the text file count toward the token limit. There is no limit on image resolution.
 
   Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData.data" type="string (byte)">
@@ -354,7 +355,7 @@
 </ParamField>
 
 <ParamField body="systemInstruction" type="object">
   Instructions for the model to steer it toward better performance. For example, "Answer as concisely as possible" or "Don't use technical terms in your response". The text strings count toward the token limit. The role field of systemInstruction is ignored and doesn't affect the performance of the model. Note: Only text should be used in parts and content in each part should be in a separate paragraph.
 </ParamField>
 
 <ParamField body="systemInstruction.parts" type="object[]" required>
@@ -396,14 +397,14 @@
 </ParamField>
 
 <ParamField body="videoMetadata" type="object">
   For video input, the start and end offset of the video in Duration format. For example, to specify a 10 second clip starting at 1:00, set "startOffset": \{ "seconds": 60 } and "endOffset": \{ "seconds": 70 }. The metadata should only be specified while the video data is presented in inlineData or fileData.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset" type="object">
   Represents a duration offset for video timeline positions.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset.nanos" type="integer">
   Signed fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanos values.
 
   Range: `0` to `999999999`
@@ -498,7 +499,7 @@
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData.data" type="string (byte)">
@@ -612,7 +613,7 @@
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokenCount" type="integer">
   Number of tokens in the request. When cachedContent is set, this is still the total effective prompt size meaning this includes the number of tokens in the cached content.
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokensDetails" type="object[]">

development/comfy-router/models/google/nano-banana-pro/code.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Use Nano Banana Pro with Comfy Router"
 description: "Python, TypeScript and cURL snippets for generating images with Nano Banana Pro (Gemini 3 Pro Image) over HTTP through Comfy Router, plus the request fields and the result shape"
 sidebarTitle: "Nano Banana Pro"
 ---
 
@@ -58,8 +58,8 @@
 
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { candidates: { content: { parts: { inlineData: { data: string } }[] } }[] };
-const { data } = await comfy.models.run<Result>("vertexai/gemini-3-pro-image", {
+const result = await comfy.models.run<Result>("vertexai/gemini-3-pro-image", {
   contents: [
     {
       role: "user",
@@ -77,8 +77,9 @@
     },
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image (base64):", data.candidates[0].content.parts[0].inlineData.data);
+console.log("image (base64):", result.data.candidates[0].content.parts[0].inlineData.data);
 ```
 
 ```bash cURL
@@ -97,7 +98,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -115,7 +116,7 @@
                     ],
                 },
             ],
             "generationConfig": {
                 "responseModalities": ["IMAGE"],
                 "imageConfig": {
                     "aspectRatio": "1:1",
@@ -207,22 +208,22 @@
 
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData" type="object">
   URI based data.
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.fileUri" type="string">
   URI
 </ParamField>
 
 <ParamField body="contents[].parts[].fileData.mimeType" type="string">
   The media type of the file specified in the data or fileUri fields. Acceptable values include the following. For gemini-2.0-flash-lite and gemini-2.0-flash, the maximum length of an audio file is 8.4 hours and the maximum length of a video file (without audio) is one hour. For more information, see Gemini audio and video requirements. Text files must be UTF-8 encoded. The contents of the text file count toward the token limit. There is no limit on image resolution.
 
   Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ParamField>
 
 <ParamField body="contents[].parts[].inlineData.data" type="string (byte)">
@@ -354,7 +355,7 @@
 </ParamField>
 
 <ParamField body="systemInstruction" type="object">
   Instructions for the model to steer it toward better performance. For example, "Answer as concisely as possible" or "Don't use technical terms in your response". The text strings count toward the token limit. The role field of systemInstruction is ignored and doesn't affect the performance of the model. Note: Only text should be used in parts and content in each part should be in a separate paragraph.
 </ParamField>
 
 <ParamField body="systemInstruction.parts" type="object[]" required>
@@ -396,14 +397,14 @@
 </ParamField>
 
 <ParamField body="videoMetadata" type="object">
   For video input, the start and end offset of the video in Duration format. For example, to specify a 10 second clip starting at 1:00, set "startOffset": \{ "seconds": 60 } and "endOffset": \{ "seconds": 70 }. The metadata should only be specified while the video data is presented in inlineData or fileData.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset" type="object">
   Represents a duration offset for video timeline positions.
 </ParamField>
 
 <ParamField body="videoMetadata.endOffset.nanos" type="integer">
   Signed fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanos values.
 
   Range: `0` to `999999999`
@@ -498,7 +499,7 @@
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData" type="object">
   Inline data in raw bytes. For gemini-2.0-flash-lite and gemini-2.0-flash, you can specify up to 3000 images by using inlineData.
 </ResponseField>
 
 <ResponseField name="candidates[].content.parts[].inlineData.data" type="string (byte)">
@@ -612,7 +613,7 @@
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokenCount" type="integer">
   Number of tokens in the request. When cachedContent is set, this is still the total effective prompt size meaning this includes the number of tokens in the cached content.
 </ResponseField>
 
 <ResponseField name="usageMetadata.promptTokensDetails" type="object[]">

development/comfy-router/models/ideogram/ideogram-v4/code.mdx

@@ -46,13 +46,14 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { data: { url: string }[] };
-const { data } = await comfy.models.run<Result>("ideogram/ideogram-v4", {
+const result = await comfy.models.run<Result>("ideogram/ideogram-v4", {
   text_prompt: "a single red maple leaf on a plain white background, studio lighting",
   resolution: "1024x1024",
   rendering_speed: "DEFAULT",
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("image:", data.data[0].url);
+console.log("image:", result.data.data[0].url);
 ```
 
 ```bash cURL
@@ -71,7 +72,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -152,7 +153,7 @@
 </ParamField>
 
 <ParamField body="json_prompt" type="object">
   Structured V4 prompt. Disables Magic Prompt; consumed directly. Supply exactly one of text_prompt or json_prompt.
 </ParamField>
 
 <ParamField body="rendering_speed" type="string" default="&quot;DEFAULT&quot;">
@@ -166,7 +167,7 @@
 </ParamField>
 
 <ParamField body="text_prompt" type="string">
   Natural-language prompt. Enables Magic Prompt automatically. Supply exactly one of text_prompt or json_prompt.
 </ParamField>
 
 Generated from the schema Router serves at `GET /v2/models/ideogram/ideogram-v4/openapi.json`, the same document it validates a call against before the request reaches the provider.

development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx

@@ -33,7 +33,7 @@
         {
             "input": {
                 "prompt": "the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady",
                 "img_url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
             },
             "parameters": {
                 "resolution": "720P",
@@ -51,7 +51,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { output: { video_url: string } };
-const { data } = await comfy.models.run<Result>("wan/happyhorse-1.0-i2v", {
+const result = await comfy.models.run<Result>("wan/happyhorse-1.0-i2v", {
   input: {
     prompt: "the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady",
     img_url: "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
@@ -61,8 +61,9 @@
     duration: 5,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.output.video_url);
+console.log("video:", result.data.output.video_url);
 ```
 
 ```bash cURL
@@ -81,7 +82,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -171,8 +172,8 @@
   Enter basic information, such as prompt words, etc.
 </ParamField>
 
 <ParamField body="input.audio_url" type="string">
   Audio file download URL. Supported formats: mp3 and wav. Cannot be used with reference_video_urls.
 </ParamField>
 
 <ParamField body="input.img_url" type="string">
@@ -191,20 +192,20 @@
 materials (image, audio, video) for video generation. Each element contains a type and
 url field.
 Supported type values vary by model:
 - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip
 - wan2.7-r2v: reference_image, reference_video
 - wan2.7-videoedit: video, reference_image
 - wan3.0-video: first_frame (max 1), last_frame (max 1), reference_image (max 10),
   reference_video (max 5 clips, total duration \<= 15s), reference_audio (max 5 clips,
   total duration \<= 15s), file (max 1, cannot be used with link), link (max 1, cannot
   be used with file). The reference_*/file/link types and first_frame/last_frame types
   are mutually exclusive within the same request. The array order defines the reference
   order of assets in the prompt (Image 1, Video 1, Audio 1, ...).
 - happyhorse-1.x-i2v: first_frame only, exactly 1. At least 300x300 pixels,
   JPEG/JPG/PNG/WEBP, max 20MB, a public URL or a data:\{MIME_type};base64,... URL.
   These spellings take NO img_url; the first frame goes here.
 - happyhorse-1.x-r2v: reference_image only, 1 to 9 of them. Shortest side at least
   400 pixels, max 20MB, a public URL or a data: URL. reference_video is NOT an input
   type for this operation.
 - happyhorse-1.x-video-edit: video
 The per-asset "max 20MB" figures above are the PARTNER's ceiling on the image it
@@ -244,7 +245,7 @@
 <ParamField body="input.reference_video_urls" type="string[]">
   Reference video URLs for wan2.6-r2v model only. Array of 1-3 video URLs.
 Input restrictions:
 - Format: mp4, mov
 - Quantity: 1-3 videos
 - Single video length: 2-30 seconds
 - Single file size: max 30MB
@@ -291,7 +292,7 @@
   Range: `-1` to `30`
 </ParamField>
 
 <ParamField body="parameters.prompt_extend" type="boolean" default="true">
   Is it enabled prompt intelligent rewriting. Default is true
 </ParamField>
 
@@ -308,7 +309,7 @@
   Resolution level. Supported values vary by model:
 - wan2.5-i2v-preview: 480P, 720P, 1080P
 - wan2.6-i2v: 720P, 1080P only (no 480P support)
 - wan2.7 models (i2v, t2v, r2v, videoedit): 720P, 1080P (default 1080P)
 - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (upstream default 1080P)
 This proxy rejects video generation requests that provide neither resolution
 nor size, because the resolution tier selects the billing rate.

development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx

@@ -35,7 +35,7 @@
                 "prompt": "character1 walks in from the left, turns to the camera and waves, plain orange backdrop",
                 "media": [
                     {
                         "type": "reference_image",
                         "url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
                     },
                 ],
@@ -56,12 +56,12 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { output: { video_url: string } };
-const { data } = await comfy.models.run<Result>("wan/happyhorse-1.0-r2v", {
+const result = await comfy.models.run<Result>("wan/happyhorse-1.0-r2v", {
   input: {
     prompt: "character1 walks in from the left, turns to the camera and waves, plain orange backdrop",
     media: [
       {
         type: "reference_image",
         url: "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
       },
     ],
@@ -71,8 +71,9 @@
     duration: 5,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.output.video_url);
+console.log("video:", result.data.output.video_url);
 ```
 
 ```bash cURL
@@ -80,7 +81,7 @@
   -H "X-API-Key: $COMFY_API_KEY" \
   -H "Idempotency-Key: $(uuidgen)" \
   -H "Content-Type: application/json" \
   -d "{\"input\": {\"prompt\":\"character1 walks in from the left, turns to the camera and waves, plain orange backdrop\",\"media\":[{\"type\":\"reference_image\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}"
 ```
 </CodeGroup>
   </Tab>
@@ -91,7 +92,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -103,7 +104,7 @@
                 "prompt": "character1 walks in from the left, turns to the camera and waves, plain orange backdrop",
                 "media": [
                     {
                         "type": "reference_image",
                         "url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
                     },
                 ],
@@ -191,11 +192,11 @@
   Enter basic information, such as prompt words, etc.
 </ParamField>
 
 <ParamField body="input.audio_url" type="string">
   Audio file download URL. Supported formats: mp3 and wav. Cannot be used with reference_video_urls.
 </ParamField>
 
 <ParamField body="input.img_url" type="string">
   First frame image URL or Base64 encoded data.
 Required for the wan2.5-i2v-preview and wan2.6-i2v models only. The
 happyhorse-1.x i2v spellings do NOT take their first frame here: they
@@ -211,20 +212,20 @@
 materials (image, audio, video) for video generation. Each element contains a type and
 url field.
 Supported type values vary by model:
 - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip
 - wan2.7-r2v: reference_image, reference_video
 - wan2.7-videoedit: video, reference_image
 - wan3.0-video: first_frame (max 1), last_frame (max 1), reference_image (max 10),
   reference_video (max 5 clips, total duration \<= 15s), reference_audio (max 5 clips,
   total duration \<= 15s), file (max 1, cannot be used with link), link (max 1, cannot
   be used with file). The reference_*/file/link types and first_frame/last_frame types
   are mutually exclusive within the same request. The array order defines the reference
   order of assets in the prompt (Image 1, Video 1, Audio 1, ...).
 - happyhorse-1.x-i2v: first_frame only, exactly 1. At least 300x300 pixels,
   JPEG/JPG/PNG/WEBP, max 20MB, a public URL or a data:\{MIME_type};base64,... URL.
   These spellings take NO img_url; the first frame goes here.
 - happyhorse-1.x-r2v: reference_image only, 1 to 9 of them. Shortest side at least
   400 pixels, max 20MB, a public URL or a data: URL. reference_video is NOT an input
   type for this operation.
 - happyhorse-1.x-video-edit: video
 The per-asset "max 20MB" figures above are the PARTNER's ceiling on the image it
@@ -264,7 +265,7 @@
 <ParamField body="input.reference_video_urls" type="string[]">
   Reference video URLs for wan2.6-r2v model only. Array of 1-3 video URLs.
 Input restrictions:
 - Format: mp4, mov
 - Quantity: 1-3 videos
 - Single video length: 2-30 seconds
 - Single file size: max 30MB
@@ -311,7 +312,7 @@
   Range: `-1` to `30`
 </ParamField>
 
 <ParamField body="parameters.prompt_extend" type="boolean" default="true">
   Is it enabled prompt intelligent rewriting. Default is true
 </ParamField>
 
@@ -328,7 +329,7 @@
   Resolution level. Supported values vary by model:
 - wan2.5-i2v-preview: 480P, 720P, 1080P
 - wan2.6-i2v: 720P, 1080P only (no 480P support)
 - wan2.7 models (i2v, t2v, r2v, videoedit): 720P, 1080P (default 1080P)
 - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (upstream default 1080P)
 This proxy rejects video generation requests that provide neither resolution
 nor size, because the resolution tier selects the billing rate.

development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx

@@ -50,7 +50,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { output: { video_url: string } };
-const { data } = await comfy.models.run<Result>("wan/happyhorse-1.0-t2v", {
+const result = await comfy.models.run<Result>("wan/happyhorse-1.0-t2v", {
   input: {
     prompt: "a single red maple leaf falling onto still water, slow motion, shallow depth of field",
   },
@@ -59,8 +59,9 @@
     duration: 5,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.output.video_url);
+console.log("video:", result.data.output.video_url);
 ```
 
 ```bash cURL
@@ -79,7 +80,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -167,11 +168,11 @@
   Enter basic information, such as prompt words, etc.
 </ParamField>
 
 <ParamField body="input.audio_url" type="string">
   Audio file download URL. Supported formats: mp3 and wav. Cannot be used with reference_video_urls.
 </ParamField>
 
 <ParamField body="input.img_url" type="string">
   First frame image URL or Base64 encoded data.
 Required for the wan2.5-i2v-preview and wan2.6-i2v models only. The
 happyhorse-1.x i2v spellings do NOT take their first frame here: they
@@ -187,20 +188,20 @@
 materials (image, audio, video) for video generation. Each element contains a type and
 url field.
 Supported type values vary by model:
 - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip
 - wan2.7-r2v: reference_image, reference_video
 - wan2.7-videoedit: video, reference_image
 - wan3.0-video: first_frame (max 1), last_frame (max 1), reference_image (max 10),
   reference_video (max 5 clips, total duration \<= 15s), reference_audio (max 5 clips,
   total duration \<= 15s), file (max 1, cannot be used with link), link (max 1, cannot
   be used with file). The reference_*/file/link types and first_frame/last_frame types
   are mutually exclusive within the same request. The array order defines the reference
   order of assets in the prompt (Image 1, Video 1, Audio 1, ...).
 - happyhorse-1.x-i2v: first_frame only, exactly 1. At least 300x300 pixels,
   JPEG/JPG/PNG/WEBP, max 20MB, a public URL or a data:\{MIME_type};base64,... URL.
   These spellings take NO img_url; the first frame goes here.
 - happyhorse-1.x-r2v: reference_image only, 1 to 9 of them. Shortest side at least
   400 pixels, max 20MB, a public URL or a data: URL. reference_video is NOT an input
   type for this operation.
 - happyhorse-1.x-video-edit: video
 The per-asset "max 20MB" figures above are the PARTNER's ceiling on the image it
@@ -240,7 +241,7 @@
 <ParamField body="input.reference_video_urls" type="string[]">
   Reference video URLs for wan2.6-r2v model only. Array of 1-3 video URLs.
 Input restrictions:
 - Format: mp4, mov
 - Quantity: 1-3 videos
 - Single video length: 2-30 seconds
 - Single file size: max 30MB
@@ -287,7 +288,7 @@
   Range: `-1` to `30`
 </ParamField>
 
 <ParamField body="parameters.prompt_extend" type="boolean" default="true">
   Is it enabled prompt intelligent rewriting. Default is true
 </ParamField>
 
@@ -304,7 +305,7 @@
   Resolution level. Supported values vary by model:
 - wan2.5-i2v-preview: 480P, 720P, 1080P
 - wan2.6-i2v: 720P, 1080P only (no 480P support)
 - wan2.7 models (i2v, t2v, r2v, videoedit): 720P, 1080P (default 1080P)
 - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (upstream default 1080P)
 This proxy rejects video generation requests that provide neither resolution
 nor size, because the resolution tier selects the billing rate.

development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx

@@ -55,7 +55,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { output: { video_url: string } };
-const { data } = await comfy.models.run<Result>("wan/happyhorse-1.0-video-edit", {
+const result = await comfy.models.run<Result>("wan/happyhorse-1.0-video-edit", {
   input: {
     prompt: "restyle the clip as a hand-drawn ink sketch, keep the dancer's movement unchanged",
     media: [
@@ -69,8 +69,9 @@
     resolution: "720P",
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.output.video_url);
+console.log("video:", result.data.output.video_url);
 ```
 
 ```bash cURL
@@ -89,7 +90,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -188,10 +189,10 @@
 </ParamField>
 
 <ParamField body="input.audio_url" type="string">
   Audio file download URL. Supported formats: mp3 and wav. Cannot be used with reference_video_urls.
 </ParamField>
 
 <ParamField body="input.img_url" type="string">
   First frame image URL or Base64 encoded data.
 Required for the wan2.5-i2v-preview and wan2.6-i2v models only. The
 happyhorse-1.x i2v spellings do NOT take their first frame here: they
@@ -207,20 +208,20 @@
 materials (image, audio, video) for video generation. Each element contains a type and
 url field.
 Supported type values vary by model:
 - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip
 - wan2.7-r2v: reference_image, reference_video
 - wan2.7-videoedit: video, reference_image
 - wan3.0-video: first_frame (max 1), last_frame (max 1), reference_image (max 10),
   reference_video (max 5 clips, total duration \<= 15s), reference_audio (max 5 clips,
   total duration \<= 15s), file (max 1, cannot be used with link), link (max 1, cannot
   be used with file). The reference_*/file/link types and first_frame/last_frame types
   are mutually exclusive within the same request. The array order defines the reference
   order of assets in the prompt (Image 1, Video 1, Audio 1, ...).
 - happyhorse-1.x-i2v: first_frame only, exactly 1. At least 300x300 pixels,
   JPEG/JPG/PNG/WEBP, max 20MB, a public URL or a data:\{MIME_type};base64,... URL.
   These spellings take NO img_url; the first frame goes here.
 - happyhorse-1.x-r2v: reference_image only, 1 to 9 of them. Shortest side at least
   400 pixels, max 20MB, a public URL or a data: URL. reference_video is NOT an input
   type for this operation.
 - happyhorse-1.x-video-edit: video
 The per-asset "max 20MB" figures above are the PARTNER's ceiling on the image it
@@ -260,11 +261,11 @@
 <ParamField body="input.reference_video_urls" type="string[]">
   Reference video URLs for wan2.6-r2v model only. Array of 1-3 video URLs.
 Input restrictions:
 - Format: mp4, mov
 - Quantity: 1-3 videos
 - Single video length: 2-30 seconds
 - Single file size: max 30MB
 - Cannot be used with audio_url
 Reference duration: Single video max 5s, two videos max 2.5s each, three videos proportionally less.
 Billing: Based on actual reference duration used.
 </ParamField>
@@ -307,7 +308,7 @@
   Range: `-1` to `30`
 </ParamField>
 
 <ParamField body="parameters.prompt_extend" type="boolean" default="true">
   Is it enabled prompt intelligent rewriting. Default is true
 </ParamField>
 
@@ -324,7 +325,7 @@
   Resolution level. Supported values vary by model:
 - wan2.5-i2v-preview: 480P, 720P, 1080P
 - wan2.6-i2v: 720P, 1080P only (no 480P support)
 - wan2.7 models (i2v, t2v, r2v, videoedit): 720P, 1080P (default 1080P)
 - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (upstream default 1080P)
 This proxy rejects video generation requests that provide neither resolution
 nor size, because the resolution tier selects the billing rate.

development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx

@@ -33,7 +33,7 @@
         {
             "input": {
                 "prompt": "the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady",
                 "img_url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
             },
             "parameters": {
                 "resolution": "720P",
@@ -51,7 +51,7 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { output: { video_url: string } };
-const { data } = await comfy.models.run<Result>("wan/happyhorse-1.1-i2v", {
+const result = await comfy.models.run<Result>("wan/happyhorse-1.1-i2v", {
   input: {
     prompt: "the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady",
     img_url: "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
@@ -61,8 +61,9 @@
     duration: 5,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.output.video_url);
+console.log("video:", result.data.output.video_url);
 ```
 
 ```bash cURL
@@ -81,7 +82,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -171,8 +172,8 @@
   Enter basic information, such as prompt words, etc.
 </ParamField>
 
 <ParamField body="input.audio_url" type="string">
   Audio file download URL. Supported formats: mp3 and wav. Cannot be used with reference_video_urls.
 </ParamField>
 
 <ParamField body="input.img_url" type="string">
@@ -191,20 +192,20 @@
 materials (image, audio, video) for video generation. Each element contains a type and
 url field.
 Supported type values vary by model:
 - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip
 - wan2.7-r2v: reference_image, reference_video
 - wan2.7-videoedit: video, reference_image
 - wan3.0-video: first_frame (max 1), last_frame (max 1), reference_image (max 10),
   reference_video (max 5 clips, total duration \<= 15s), reference_audio (max 5 clips,
   total duration \<= 15s), file (max 1, cannot be used with link), link (max 1, cannot
   be used with file). The reference_*/file/link types and first_frame/last_frame types
   are mutually exclusive within the same request. The array order defines the reference
   order of assets in the prompt (Image 1, Video 1, Audio 1, ...).
 - happyhorse-1.x-i2v: first_frame only, exactly 1. At least 300x300 pixels,
   JPEG/JPG/PNG/WEBP, max 20MB, a public URL or a data:\{MIME_type};base64,... URL.
   These spellings take NO img_url; the first frame goes here.
 - happyhorse-1.x-r2v: reference_image only, 1 to 9 of them. Shortest side at least
   400 pixels, max 20MB, a public URL or a data: URL. reference_video is NOT an input
   type for this operation.
 - happyhorse-1.x-video-edit: video
 The per-asset "max 20MB" figures above are the PARTNER's ceiling on the image it
@@ -244,7 +245,7 @@
 <ParamField body="input.reference_video_urls" type="string[]">
   Reference video URLs for wan2.6-r2v model only. Array of 1-3 video URLs.
 Input restrictions:
 - Format: mp4, mov
 - Quantity: 1-3 videos
 - Single video length: 2-30 seconds
 - Single file size: max 30MB
@@ -291,7 +292,7 @@
   Range: `-1` to `30`
 </ParamField>
 
 <ParamField body="parameters.prompt_extend" type="boolean" default="true">
   Is it enabled prompt intelligent rewriting. Default is true
 </ParamField>
 
@@ -308,7 +309,7 @@
   Resolution level. Supported values vary by model:
 - wan2.5-i2v-preview: 480P, 720P, 1080P
 - wan2.6-i2v: 720P, 1080P only (no 480P support)
 - wan2.7 models (i2v, t2v, r2v, videoedit): 720P, 1080P (default 1080P)
 - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (upstream default 1080P)
 This proxy rejects video generation requests that provide neither resolution
 nor size, because the resolution tier selects the billing rate.

development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx

@@ -35,7 +35,7 @@
                 "prompt": "character1 walks in from the left, turns to the camera and waves, plain orange backdrop",
                 "media": [
                     {
                         "type": "reference_image",
                         "url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
                     },
                 ],
@@ -56,12 +56,12 @@
 // Reads COMFY_API_KEY from the environment.
 // The SDK automatically creates an idempotency key and reuses it for automatic retries.
 type Result = { output: { video_url: string } };
-const { data } = await comfy.models.run<Result>("wan/happyhorse-1.1-r2v", {
+const result = await comfy.models.run<Result>("wan/happyhorse-1.1-r2v", {
   input: {
     prompt: "character1 walks in from the left, turns to the camera and waves, plain orange backdrop",
     media: [
       {
         type: "reference_image",
         url: "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
       },
     ],
@@ -71,8 +71,9 @@
     duration: 5,
   },
 });
+if (result.kind !== "json") throw new Error("expected a JSON result");
 
-console.log("video:", data.output.video_url);
+console.log("video:", result.data.output.video_url);
 ```
 
 ```bash cURL
@@ -80,7 +81,7 @@
   -H "X-API-Key: $COMFY_API_KEY" \
   -H "Idempotency-Key: $(uuidgen)" \
   -H "Content-Type: application/json" \
   -d "{\"input\": {\"prompt\":\"character1 walks in from the left, turns to the camera and waves, plain orange backdrop\",\"media\":[{\"type\":\"reference_image\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}"
 ```
 </CodeGroup>
   </Tab>
@@ -91,7 +92,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -103,7 +104,7 @@
                 "prompt": "character1 walks in from the left, turns to the camera and waves, plain orange backdrop",
                 "media": [
                     {
                         "type": "reference_image",
                         "url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png",
                     },
                 ],
@@ -191,11 +192,11 @@
   Enter basic information, such as prompt words, etc.
 </ParamField>
 
 <ParamField body="input.audio_url" type="string">
   Audio file download URL. Supported formats: mp3 and wav. Cannot be used with reference_video_urls.
 </ParamField>
 
 <ParamField body="input.img_url" type="string">
   First frame image URL or Base64 encoded data.
 Required for the wan2.5-i2v-preview and wan2.6-i2v models only. The
 happyhorse-1.x i2v spellings do NOT take their first frame here: they
@@ -211,20 +212,20 @@
 materials (image, audio, video) for video generation. Each element contains a type and
 url field.
 Supported type values vary by model:
 - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip
 - wan2.7-r2v: reference_image, reference_video
 - wan2.7-videoedit: video, reference_image
 - wan3.0-video: first_frame (max 1), last_frame (max 1), reference_image (max 10),
   reference_video (max 5 clips, total duration \<= 15s), reference_audio (max 5 clips,
   total duration \<= 15s), file (max 1, cannot be used with link), link (max 1, cannot
   be used with file). The reference_*/file/link types and first_frame/last_frame types
   are mutually exclusive within the same request. The array order defines the reference
   order of assets in the prompt (Image 1, Video 1, Audio 1, ...).
 - happyhorse-1.x-i2v: first_frame only, exactly 1. At least 300x300 pixels,
   JPEG/JPG/PNG/WEBP, max 20MB, a public URL or a data:\{MIME_type};base64,... URL.
   These spellings take NO img_url; the first frame goes here.
 - happyhorse-1.x-r2v: reference_image only, 1 to 9 of them. Shortest side at least
   400 pixels, max 20MB, a public URL or a data: URL. reference_video is NOT an input
   type for this operation.
 - happyhorse-1.x-video-edit: video
 The per-asset "max 20MB" figures above are the PARTNER's ceiling on the image it
@@ -264,7 +265,7 @@
 <ParamField body="input.reference_video_urls" type="string[]">
   Reference video URLs for wan2.6-r2v model only. Array of 1-3 video URLs.
 Input restrictions:
 - Format: mp4, mov
 - Quantity: 1-3 videos
 - Single video length: 2-30 seconds
 - Single file size: max 30MB
@@ -311,7 +312,7 @@
   Range: `-1` to `30`
 </ParamField>
 
 <ParamField body="parameters.prompt_extend" type="boolean" default="true">
   Is it enabled prompt intelligent rewriting. Default is true
 </ParamField>
 
@@ -328,7 +329,7 @@
   Resolution level. Supported values vary by model:
 - wan2.5-i2v-preview: 480P, 720P, 1080P
 - wan2.6-i2v: 720P, 1080P only (no 480P support)
 - wan2.7 models (i2v, t2v, r2v, videoedit): 720P, 1080P (default 1080P)
 - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (upstream default 1080P)
 This proxy rejects video generation requests that provide neither resolution
 nor size, because the resolution tier selects the billing rate.