@byte_fluffy/nexra-sdk 0.1.0-alpha.41 → 0.1.0-alpha.43

package/README.md

@@ -29,7 +29,7 @@ const result = await nexra.run(spec!.id, input, { quoteToken: quote.quoteToken }
 
 Media apps send the versioned Nexra category contract: ordered `content` parts plus
 the common parameters for `image.generate`, `video.generate`, `audio.generate` or
-`image.upscale`. The server resolves the selected model component and explicitly
+`image.upscale` or `video.upscale`. The server resolves the selected model component and explicitly
 adapts that input to the channel Provider. The SDK does not expose or emulate
 Provider-native endpoints. Protocol constants, schemas and types are also
 available from `@byte_fluffy/nexra-sdk/media`.
@@ -37,6 +37,34 @@ available from `@byte_fluffy/nexra-sdk/media`.
 The default API base URL is `https://api.nexra-ai.com/v1`. When overriding
 `baseUrl`, include the `/v1` API prefix.
 
+## Image and video upscale
+
+`0.1.0-alpha.42` adds `bytedance/image-enhancement` and
+`bytedance/video-super-resolution`. Both use the Task API and the existing
+asset delivery lifecycle. Read the stored result from `result.assets`; wait for
+delivery to finish before treating an output URL as permanent.
+
+```ts
+const image = await nexra.run("bytedance/image-enhancement", {
+  content: [{ type: "image", role: "source", source: "https://example.com/input.png" }],
+  resolution: "2k",
+});
+const video = await nexra.run("bytedance/video-super-resolution", {
+  content: [{ type: "video", role: "source", source: "https://example.com/input.mp4" }],
+  source_duration: 5, // Upper bound in seconds; checked before enhancement.
+  resolution: "1080p",
+});
+```
+
+Image upscale supports `144p`, `240p`, `360p`, `480p`, `540p`, `720p`,
+`1080p`, and `2k` (default). Video upscale supports `720p`, `1080p` (default),
+`2k`, and `4k`.
+
+The migrated task input also accepts the existing image fields
+`image_url`, `resolution_boundary`, `enable_hdr`, and `enable_wb`, or the video
+fields `video_url`/`vid`, `config`, and `target.res`. Use one input contract per
+request. Credentials, VOD space, and playback signing belong to the server channel.
+
 ## Dolphin Seedance
 
 `0.1.0-alpha.41` adds the independently addressable models

package/dist/catalog.js

@@ -9,8 +9,8 @@ import {
   listModelSpecs,
   projectMediaGeometry,
   resolveNexraLanguageReasoning
-} from "./chunk-BIAPYH3J.js";
-import "./chunk-QHQJD3EN.js";
+} from "./chunk-TV6MEAZC.js";
+import "./chunk-ESPUF2D4.js";
 export {
   CatalogClient,
   applyMediaGeometry,

package/dist/{chunk-QHQJD3EN.js → chunk-ESPUF2D4.js}

@@ -417,7 +417,8 @@ var NEXRA_PUBLISHED_MEDIA_OPERATIONS = [
   "image.generate",
   "video.generate",
   "audio.generate",
-  "image.upscale"
+  "image.upscale",
+  "video.upscale"
 ];
 var NEXRA_MEDIA_FEATURES = [
   "text-to-image",
@@ -476,7 +477,7 @@ var NEXRA_MEDIA_OPERATION_DEFINITIONS = Object.freeze([
   },
   {
     operation: "video.upscale",
-    status: "hold",
+    status: "active",
     outputKind: "video",
     features: ["scale-factor", "target-resolution"],
     parameterKeys: ["scale", "resolution", "output_format", "preserve_details"]
@@ -606,6 +607,17 @@ var NEXRA_MEDIA_INPUT_SCHEMAS = Object.freeze({
       preserve_details: { type: "boolean", "x-ui": { order: 13, control: "switch" } }
     },
     { minItems: 1, maxItems: 1 }
+  ),
+  "video.upscale": inputSchema(
+    [mediaPartSchema("video", ["source"])],
+    {
+      source_duration: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 9, control: "number" } },
+      scale: { type: "number", exclusiveMinimum: 1, "x-ui": { order: 10, control: "number" } },
+      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 12 } },
+      preserve_details: { type: "boolean", "x-ui": { order: 13, control: "switch" } }
+    },
+    { minItems: 1, maxItems: 1 }
   )
 });
 function nexraMediaInputSchema(operation) {

package/dist/{chunk-BIAPYH3J.js → chunk-TV6MEAZC.js}

@@ -2,7 +2,7 @@ import {
   normalizePublicErrorInput,
   pickPublicErrorFields,
   sortRatioDisplayOrder
-} from "./chunk-QHQJD3EN.js";
+} from "./chunk-ESPUF2D4.js";
 
 // src/catalog/generated/audio.generated.json
 var audio_generated_default = [
@@ -2799,6 +2799,143 @@ var audio_generated_default = [
 
 // src/catalog/generated/image.generated.json
 var image_generated_default = [
+  {
+    id: "bytedance/image-enhancement",
+    contractVersion: 1,
+    developer: "bytedance",
+    displayName: "Volcengine Image Enhancement",
+    summary: "Upscale an image with Volcengine CVProcess and save the output.",
+    kind: "image",
+    family: "Volcengine Upscale",
+    aliases: [],
+    capabilities: {
+      inputModalities: [
+        "image"
+      ],
+      outputModalities: [
+        "image"
+      ],
+      inputModes: [],
+      features: []
+    },
+    operations: [
+      {
+        operation: "image.upscale",
+        inputModalities: [
+          "image"
+        ],
+        outputModalities: [
+          "image"
+        ],
+        inputSchema: {
+          $schema: "https://json-schema.org/draft/2020-12/schema",
+          type: "object",
+          properties: {
+            content: {
+              type: "array",
+              minItems: 1,
+              maxItems: 1,
+              items: {
+                oneOf: [
+                  {
+                    type: "object",
+                    properties: {
+                      type: {
+                        const: "image"
+                      },
+                      source: {
+                        oneOf: [
+                          {
+                            type: "string",
+                            minLength: 1
+                          },
+                          {
+                            type: "object",
+                            properties: {
+                              assetId: {
+                                type: "string",
+                                minLength: 1
+                              }
+                            },
+                            required: [
+                              "assetId"
+                            ],
+                            additionalProperties: false
+                          }
+                        ]
+                      },
+                      role: {
+                        type: "string",
+                        enum: [
+                          "source"
+                        ]
+                      }
+                    },
+                    required: [
+                      "type",
+                      "source"
+                    ],
+                    additionalProperties: false
+                  }
+                ]
+              },
+              "x-ui": {
+                control: "content-parts",
+                order: 0
+              }
+            },
+            resolution: {
+              type: "string",
+              enum: [
+                "144p",
+                "240p",
+                "360p",
+                "480p",
+                "540p",
+                "720p",
+                "1080p",
+                "2k"
+              ],
+              default: "2k",
+              "x-ui": {
+                order: 11
+              }
+            },
+            enable_hdr: {
+              type: "boolean"
+            },
+            enable_wb: {
+              type: "boolean"
+            }
+          },
+          required: [
+            "content"
+          ],
+          additionalProperties: false
+        },
+        outputSchema: {},
+        metering: {
+          schemaVersion: 1,
+          kind: "non_token",
+          metrics: [
+            {
+              metric: "requests",
+              requirement: "required"
+            },
+            {
+              metric: "input_images",
+              requirement: "required"
+            },
+            {
+              metric: "output_images",
+              requirement: "required"
+            }
+          ]
+        }
+      }
+    ],
+    endpoints: []
+  },
   {
     id: "google/gemini-nano-banana-2.1",
     contractVersion: 1,
@@ -32592,6 +32729,168 @@ var language_generated_default = [
 
 // src/catalog/generated/video.generated.json
 var video_generated_default = [
+  {
+    id: "bytedance/video-super-resolution",
+    contractVersion: 1,
+    developer: "bytedance",
+    displayName: "Volcengine Video Super Resolution",
+    summary: "Upscale a video through Volcengine VOD and save the output.",
+    kind: "video",
+    family: "Volcengine Upscale",
+    aliases: [],
+    capabilities: {
+      inputModalities: [
+        "video"
+      ],
+      outputModalities: [
+        "video"
+      ],
+      inputModes: [],
+      features: []
+    },
+    operations: [
+      {
+        operation: "video.upscale",
+        inputModalities: [
+          "video"
+        ],
+        outputModalities: [
+          "video"
+        ],
+        inputSchema: {
+          $schema: "https://json-schema.org/draft/2020-12/schema",
+          type: "object",
+          properties: {
+            content: {
+              type: "array",
+              minItems: 1,
+              maxItems: 1,
+              items: {
+                oneOf: [
+                  {
+                    type: "object",
+                    properties: {
+                      type: {
+                        const: "video"
+                      },
+                      source: {
+                        oneOf: [
+                          {
+                            type: "string",
+                            minLength: 1
+                          },
+                          {
+                            type: "object",
+                            properties: {
+                              assetId: {
+                                type: "string",
+                                minLength: 1
+                              }
+                            },
+                            required: [
+                              "assetId"
+                            ],
+                            additionalProperties: false
+                          }
+                        ]
+                      },
+                      role: {
+                        type: "string",
+                        enum: [
+                          "source"
+                        ]
+                      }
+                    },
+                    required: [
+                      "type",
+                      "source"
+                    ],
+                    additionalProperties: false
+                  }
+                ]
+              },
+              "x-ui": {
+                control: "content-parts",
+                order: 0
+              }
+            },
+            vid: {
+              type: "string",
+              minLength: 1
+            },
+            config: {
+              type: "string",
+              enum: [
+                "common",
+                "ugc",
+                "short_series",
+                "aigc",
+                "old_film"
+              ],
+              default: "common"
+            },
+            source_duration: {
+              type: "number",
+              exclusiveMinimum: 0,
+              description: "Upper bound on source duration in seconds, verified before enhancement."
+            },
+            resolution: {
+              type: "string",
+              enum: [
+                "720p",
+                "1080p",
+                "2k",
+                "4k"
+              ],
+              default: "1080p"
+            }
+          },
+          required: [
+            "source_duration"
+          ],
+          additionalProperties: false,
+          oneOf: [
+            {
+              properties: {
+                content: {}
+              },
+              required: [
+                "content"
+              ]
+            },
+            {
+              properties: {
+                vid: {}
+              },
+              required: [
+                "vid"
+              ]
+            }
+          ]
+        },
+        outputSchema: {},
+        metering: {
+          schemaVersion: 1,
+          kind: "non_token",
+          metrics: [
+            {
+              metric: "requests",
+              requirement: "required"
+            },
+            {
+              metric: "input_video_seconds",
+              requirement: "required"
+            },
+            {
+              metric: "output_video_seconds",
+              requirement: "required"
+            }
+          ]
+        }
+      }
+    ],
+    endpoints: []
+  },
   {
     id: "dolphin/seedance-2-0",
     contractVersion: 1,
@@ -54747,7 +55046,7 @@ var NexraWaitTimeoutError = class extends Error {
 };
 
 // src/generated/version.generated.ts
-var SDK_VERSION = "0.1.0-alpha.41";
+var SDK_VERSION = "0.1.0-alpha.43";
 
 // src/transport.ts
 var DEFAULT_BASE_URL = "https://api.nexra-ai.com/v1";

package/dist/index.js

@@ -20,14 +20,14 @@ import {
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-BIAPYH3J.js";
+} from "./chunk-TV6MEAZC.js";
 import {
   MEDIA_KINDS,
   TASK_STATUSES,
   createTaskRequest,
   extractUpstreamErrorMessage,
   isTerminalTaskStatus
-} from "./chunk-QHQJD3EN.js";
+} from "./chunk-ESPUF2D4.js";
 
 // src/assets.ts
 var AssetsClient = class {

package/dist/language.js

@@ -6,12 +6,12 @@ import {
   jsonBody,
   parseServerSentEvents,
   resolveNexraLanguageReasoning
-} from "./chunk-BIAPYH3J.js";
+} from "./chunk-TV6MEAZC.js";
 import {
   isPublicErrorCode,
   publicErrorMessage,
   resolvePublicErrorLocale
-} from "./chunk-QHQJD3EN.js";
+} from "./chunk-ESPUF2D4.js";
 
 // src/language/index.ts
 import { createAnthropic } from "@ai-sdk/anthropic";

package/dist/media.d.ts

@@ -7,7 +7,7 @@ declare const NEXRA_GENERATION_OPERATIONS: readonly ["text.generate", "image.gen
 type NexraGenerationOperation = (typeof NEXRA_GENERATION_OPERATIONS)[number];
 declare const NEXRA_MEDIA_OPERATIONS: readonly ["image.generate", "video.generate", "audio.generate", "image.upscale", "video.upscale"];
 type NexraMediaOperation = (typeof NEXRA_MEDIA_OPERATIONS)[number];
-declare const NEXRA_PUBLISHED_MEDIA_OPERATIONS: readonly ["image.generate", "video.generate", "audio.generate", "image.upscale"];
+declare const NEXRA_PUBLISHED_MEDIA_OPERATIONS: readonly ["image.generate", "video.generate", "audio.generate", "image.upscale", "video.upscale"];
 type NexraPublishedMediaOperation = (typeof NEXRA_PUBLISHED_MEDIA_OPERATIONS)[number];
 declare const NEXRA_MEDIA_FEATURES: readonly ["text-to-image", "image-to-image", "image-reference", "image-edit", "image-inpaint", "image-control", "text-to-video", "first-frame", "first-last-frame", "image-to-video", "video-to-video", "audio-to-video", "avatar-video", "reference-image", "reference-video", "reference-audio", "omni-reference", "tts", "music", "sfx", "voice-reference", "voice-design", "scale-factor", "target-resolution"];
 type NexraMediaFeature = (typeof NEXRA_MEDIA_FEATURES)[number];
@@ -99,18 +99,27 @@ type NexraAudioGenerateInput = Readonly<{
 }>;
 type NexraImageUpscaleInput = Readonly<{
     content: readonly [NexraImageContentPart];
+    enable_hdr?: boolean;
+    enable_wb?: boolean;
     scale?: number;
     resolution?: string;
     output_format?: string;
     preserve_details?: boolean;
 }>;
 type NexraVideoUpscaleInput = Readonly<{
-    content: readonly [NexraVideoContentPart];
+    source_duration: number;
+    config?: string;
     scale?: number;
     resolution?: string;
     output_format?: string;
     preserve_details?: boolean;
-}>;
+}> & (Readonly<{
+    content: readonly [NexraVideoContentPart];
+    vid?: never;
+}> | Readonly<{
+    vid: string;
+    content?: never;
+}>);
 type NexraMediaInputByOperation = Readonly<{
     "image.generate": NexraImageGenerateInput;
     "video.generate": NexraVideoGenerateInput;
@@ -198,7 +207,7 @@ declare const NEXRA_MEDIA_OPERATION_DEFINITIONS: readonly [{
     readonly parameterKeys: readonly ["scale", "resolution", "output_format", "preserve_details"];
 }, {
     readonly operation: "video.upscale";
-    readonly status: "hold";
+    readonly status: "active";
     readonly outputKind: "video";
     readonly features: readonly ["scale-factor", "target-resolution"];
     readonly parameterKeys: readonly ["scale", "resolution", "output_format", "preserve_details"];

package/dist/media.js

@@ -10,7 +10,7 @@ import {
   nexraMediaInputSchema,
   nexraMediaInputSchemaForMode,
   nexraMediaOperationForMode
-} from "./chunk-QHQJD3EN.js";
+} from "./chunk-ESPUF2D4.js";
 export {
   NEXRA_GENERATION_OPERATIONS,
   NEXRA_MEDIA_API_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byte_fluffy/nexra-sdk",
-  "version": "0.1.0-alpha.41",
+  "version": "0.1.0-alpha.43",
   "type": "module",
   "types": "./dist/index.d.ts",
   "sideEffects": false,