@fungi.computer/darkroom 0.0.0-stage → 0.1.0

package/docs/api/index.md

@@ -0,0 +1,1775 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/darkroom**](README.md)
+
+---
+
+[@fungi.computer/darkroom](modules.md) / index
+
+# index
+
+## Classes
+
+### MediaSettingsError
+
+Invalid generation settings or unsupported model parameters.
+
+#### Extends
+
+- `Error`
+
+#### Constructors
+
+##### Constructor
+
+```ts
+new MediaSettingsError(message): MediaSettingsError;
+```
+
+###### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `message` | `string` |
+
+###### Returns
+
+[`MediaSettingsError`](#mediasettingserror)
+
+###### Overrides
+
+```ts
+Error.constructor;
+```
+
+## Type Aliases
+
+### ImageParams
+
+```ts
+type ImageParams = object;
+```
+
+Dimensions and optional settings used by the deterministic image quote.
+
+#### Properties
+
+##### height
+
+```ts
+readonly height: number;
+```
+
+Output height in pixels.
+
+##### references?
+
+```ts
+readonly optional references?: readonly ImageReference[];
+```
+
+Reference dimensions counted in the quote.
+
+##### steps?
+
+```ts
+readonly optional steps?: number;
+```
+
+Inference steps, using catalog defaults when omitted.
+
+##### width
+
+```ts
+readonly width: number;
+```
+
+Output width in pixels.
+
+---
+
+### ImageReference
+
+```ts
+type ImageReference = object;
+```
+
+Reference-image dimensions used to estimate provider work.
+
+#### Properties
+
+##### height
+
+```ts
+readonly height: number;
+```
+
+Reference height in pixels.
+
+##### width
+
+```ts
+readonly width: number;
+```
+
+Reference width in pixels.
+
+---
+
+### MediaReference
+
+```ts
+type MediaReference = Readonly<{
+  computerId: string;
+  path: string;
+  role?: MediaVideoReferenceRole;
+}>;
+```
+
+A reference file selected by the host, with its destination identity and path.
+
+---
+
+### ImageFormat
+
+```ts
+type ImageFormat = "png" | "jpeg" | "gif" | "webp";
+```
+
+Supported still-image encodings.
+
+---
+
+### ImageMimeType
+
+```ts
+type ImageMimeType = `image/${ImageFormat}`;
+```
+
+MIME type corresponding to a supported image encoding.
+
+---
+
+### MediaOutputFormat
+
+```ts
+type MediaOutputFormat = ImageFormat | "mp4";
+```
+
+A saved generation: an image, or an MP4 from a video model.
+
+---
+
+### MediaReferenceBytes
+
+```ts
+type MediaReferenceBytes = Readonly<{
+  bytes: Uint8Array;
+  format: ImageFormat;
+  width: number;
+  height: number;
+  filename?: string;
+}>;
+```
+
+Decoded reference bytes and the dimensions sent to the provider.
+
+---
+
+### MediaGenerationSettings
+
+```ts
+type MediaGenerationSettings = Readonly<{
+  model: string;
+  prompt: string;
+  width: number;
+  height: number;
+  steps?: number;
+  durationSeconds?: number;
+  resolution?: MediaVideoResolution;
+  aspectRatio?: MediaVideoAspectRatio;
+  generateAudio?: boolean;
+  references?: readonly MediaReference[];
+}>;
+```
+
+Normalized model settings, including bounded host-selected references.
+
+---
+
+### MediaProvider
+
+```ts
+type MediaProvider = (
+  settings,
+  references,
+  signal?,
+  outputFormat?,
+) => Promise<
+  Readonly<{
+    bytes: Uint8Array;
+    format: string;
+  }>
+>;
+```
+
+One Media provider call: validated settings and reference bytes in, output bytes
+out. Hosts may bind it to Workers AI or their own transport.
+
+#### Parameters
+
+| Parameter       | Type                                                     |
+| --------------- | -------------------------------------------------------- |
+| `settings`      | [`MediaGenerationSettings`](#mediagenerationsettings)    |
+| `references`    | readonly [`MediaReferenceBytes`](#mediareferencebytes)[] |
+| `signal?`       | `AbortSignal`                                            |
+| `outputFormat?` | `"png"` \| `"jpeg"` \| `"webp"`                          |
+
+#### Returns
+
+`Promise`\<`Readonly`\<\{ `bytes`: `Uint8Array`; `format`: `string`; \}\>\>
+
+---
+
+### FittedReferenceImage
+
+```ts
+type FittedReferenceImage = Omit<MediaReferenceBytes, "filename">;
+```
+
+A decoded reference image, scaled within MAX_REFERENCE_DIMENSION.
+
+---
+
+### ReferenceImageFitter
+
+```ts
+type ReferenceImageFitter = (bytes) => Promise<FittedReferenceImage>;
+```
+
+Decode one reference image and scale it within Media's dimension bound.
+
+#### Parameters
+
+| Parameter | Type         |
+| --------- | ------------ |
+| `bytes`   | `Uint8Array` |
+
+#### Returns
+
+`Promise`\<[`FittedReferenceImage`](#fittedreferenceimage)\>
+
+---
+
+### ImageViewFitter
+
+```ts
+type ImageViewFitter = (bytes, maxDimension) => Promise<FittedReferenceImage>;
+```
+
+Decode one image and re-encode it for a model to look at: scaled within
+`maxDimension` on the long edge (bounded by
+[viewDimensionSchema](#viewdimensionschema)) as a lossy JPEG, so a viewer can
+step the dimension down to meet a byte budget.
+
+#### Parameters
+
+| Parameter      | Type         |
+| -------------- | ------------ |
+| `bytes`        | `Uint8Array` |
+| `maxDimension` | `number`     |
+
+#### Returns
+
+`Promise`\<[`FittedReferenceImage`](#fittedreferenceimage)\>
+
+---
+
+### MediaGenerationSettingsInput
+
+```ts
+type MediaGenerationSettingsInput = z.input<
+  typeof mediaGenerationSettingsSchema
+>;
+```
+
+Caller settings before model defaults and refinements are applied.
+
+---
+
+### MediaGenerationSelection
+
+```ts
+type MediaGenerationSelection = z.output<typeof mediaGenerationSelectionSchema>;
+```
+
+Generation settings with reference paths resolved by an admitting host.
+
+---
+
+### MediaVideoReference
+
+```ts
+type MediaVideoReference = z.output<typeof mediaVideoReferenceSchema>;
+```
+
+One path-only video reference.
+
+---
+
+### MediaVideoSelectionInput
+
+```ts
+type MediaVideoSelectionInput = z.input<typeof mediaVideoSelectionSchema>;
+```
+
+Caller video selection before defaults and model-specific refinements.
+
+---
+
+### MediaVideoSelection
+
+```ts
+type MediaVideoSelection = Readonly<{
+  model: MediaVideoModelId;
+  prompt: string;
+  width: number;
+  height: number;
+  resolution: MediaVideoResolution;
+  aspectRatio: MediaVideoAspectRatio;
+  durationSeconds: number;
+  generateAudio?: boolean;
+  references?: readonly Readonly<MediaVideoReference>[];
+}>;
+```
+
+Normalized path-only video settings, ready for host-authorized reference
+hydration.
+
+---
+
+### MediaReferenceReader
+
+```ts
+type MediaReferenceReader = Readonly<{
+  read: (reference) => Promise<MediaReferenceBytes>;
+}>;
+```
+
+Host-authorized reader for decoded reference images.
+
+---
+
+### MediaJsonBody
+
+```ts
+type MediaJsonBody = Readonly<{
+  prompt: string;
+  width?: number;
+  height?: number;
+  steps?: number;
+  num_steps?: number;
+}>;
+```
+
+Provider JSON image input for models without multipart references.
+
+---
+
+### MediaProviderPayload
+
+```ts
+type MediaProviderPayload =
+  | Readonly<{
+      transport: "json";
+      body: MediaJsonBody;
+    }>
+  | Readonly<{
+      transport: "multipart";
+      body: FormData;
+    }>;
+```
+
+A model-specific JSON body or multipart form ready for transport.
+
+---
+
+### MediaProviderImageEntry
+
+```ts
+type MediaProviderImageEntry = Readonly<{
+  base64?: string;
+  data?: string;
+  url?: string;
+}>;
+```
+
+One image in a provider envelope, encoded inline or available at a URL.
+
+---
+
+### MediaProviderOutput
+
+```ts
+type MediaProviderOutput =
+  | Readonly<{
+      kind: "bytes";
+      bytes: Uint8Array;
+    }>
+  | Readonly<{
+      kind: "response";
+      response: Response;
+    }>
+  | Readonly<{
+      kind: "encoded";
+      encoded: string;
+    }>
+  | Readonly<{
+      kind: "entries";
+      entries: readonly MediaProviderImageEntry[];
+    }>;
+```
+
+Parsed provider representation before conversion to bounded image bytes.
+
+---
+
+### MediaProviderWire
+
+```ts
+type MediaProviderWire = z.output<typeof mediaProviderWireSchema>;
+```
+
+Supported raw provider representations, decoded by mediaProviderWireSchema.
+
+---
+
+### MediaProviderOutputOptions
+
+```ts
+type MediaProviderOutputOptions = Readonly<{
+  fetchUrl?: (url) => Promise<Response>;
+  maxBytes?: number;
+}>;
+```
+
+Host-supplied URL fetching and maximum output bytes for normalization.
+
+---
+
+### MediaImageOutput
+
+```ts
+type MediaImageOutput = Readonly<{
+  bytes: Uint8Array;
+  format: ImageFormat;
+}>;
+```
+
+Normalized bytes and their supported still-image encoding.
+
+---
+
+### MediaVideoQuoteSettings
+
+```ts
+type MediaVideoQuoteSettings = ReturnType<
+  typeof validateMediaGenerationSelection
+>;
+```
+
+Authority-free video quote settings; hydrated host settings are structurally
+compatible.
+
+---
+
+### MediaModelTier
+
+```ts
+type MediaModelTier = z.output<typeof mediaModelTierSchema>;
+```
+
+A model selection tier, independent of billing price.
+
+---
+
+### MediaVideoModelId
+
+```ts
+type MediaVideoModelId = z.output<typeof mediaVideoModelIdSchema>;
+```
+
+Verified video model identifier.
+
+---
+
+### MediaVideoResolution
+
+```ts
+type MediaVideoResolution = z.output<typeof mediaVideoResolutionSchema>;
+```
+
+A video resolution selector.
+
+---
+
+### MediaVideoAspectRatio
+
+```ts
+type MediaVideoAspectRatio = z.output<typeof mediaVideoAspectRatioSchema>;
+```
+
+A video aspect selector.
+
+---
+
+### MediaVideoReferenceRole
+
+```ts
+type MediaVideoReferenceRole = z.output<typeof mediaVideoReferenceRoleSchema>;
+```
+
+The role of a selected reference image in a video request.
+
+---
+
+### MediaVideoFormat
+
+```ts
+type MediaVideoFormat = z.output<typeof mediaVideoFormatSchema>;
+```
+
+One immutable nominal video format.
+
+---
+
+### MediaVideoModel
+
+```ts
+type MediaVideoModel = z.output<typeof mediaVideoSchema>;
+```
+
+Immutable video capability and price metadata.
+
+---
+
+### MediaModelInput
+
+```ts
+type MediaModelInput = z.output<typeof mediaModelInputSchema>;
+```
+
+Model-specific dimensions, steps, transport and reference limits.
+
+---
+
+### MediaModel
+
+```ts
+type MediaModel = z.output<typeof mediaModelSchema>;
+```
+
+One immutable provider catalog entry.
+
+## Variables
+
+### mediaFailureStageSchema
+
+```ts
+const mediaFailureStageSchema: ZodEnum<{
+  admission: "admission";
+  generation-authorization: "generation-authorization";
+  settings: "settings";
+  estimate: "estimate";
+  billing: "billing";
+  operation: "operation";
+  provider: "provider";
+  normalization: "normalization";
+  artifact: "artifact";
+  destination-authorization: "destination-authorization";
+  destination-write: "destination-write";
+}>;
+```
+
+Public diagnostic labels only; never provider messages or request data.
+
+---
+
+### MIN\_VIEW\_DIMENSION
+
+```ts
+const MIN_VIEW_DIMENSION: 256 = 256;
+```
+
+The long-edge bounds a viewer may ask for when fitting an image to look at.
+
+---
+
+### MAX\_VIEW\_DIMENSION
+
+```ts
+const MAX_VIEW_DIMENSION: 512 = 512;
+```
+
+Maximum long-edge size accepted by an image viewer, in pixels.
+
+---
+
+### viewDimensionSchema
+
+```ts
+const viewDimensionSchema: ZodNumber;
+```
+
+Decode a viewer long-edge size within the supported pixel bounds.
+
+---
+
+### MAX\_REFERENCE\_COUNT
+
+```ts
+const MAX_REFERENCE_COUNT: 4 = 4;
+```
+
+Maximum reference files in one generation request.
+
+---
+
+### MAX\_REFERENCE\_DIMENSION
+
+```ts
+const MAX_REFERENCE_DIMENSION: 512 = 512;
+```
+
+Maximum reference width and height sent to inference, in pixels.
+
+---
+
+### MAX\_REFERENCE\_BYTES
+
+```ts
+const MAX_REFERENCE_BYTES: number;
+```
+
+Maximum decoded bytes per reference image.
+
+---
+
+### MAX\_OUTPUT\_BYTES
+
+```ts
+const MAX_OUTPUT_BYTES: number;
+```
+
+Maximum retained still-image output bytes.
+
+---
+
+### mediaGenerationSettingsSchema
+
+```ts
+const mediaGenerationSettingsSchema: ZodObject<
+  {
+    model: ZodString;
+    prompt: ZodString;
+    width: ZodNumber;
+    height: ZodNumber;
+    steps: ZodOptional<ZodNumber>;
+    durationSeconds: ZodOptional<ZodNumber>;
+    resolution: ZodOptional<
+      ZodEnum<{
+        p480: "480p";
+        p720: "720p";
+        p1080: "1080p";
+        p4k: "4k";
+      }>
+    >;
+    aspectRatio: ZodOptional<
+      ZodEnum<{
+        wide: "16:9";
+        landscape: "4:3";
+        square: "1:1";
+        portrait: "3:4";
+        tall: "9:16";
+        ultrawide: "21:9";
+        ultratall: "9:21";
+      }>
+    >;
+    generateAudio: ZodOptional<ZodBoolean>;
+    references: ZodOptional<
+      ZodArray<
+        ZodObject<
+          {
+            computerId: ZodString;
+            path: ZodString;
+            role: ZodOptional<
+              ZodEnum<{
+                first: "first-frame";
+                last: "last-frame";
+                reference: "reference";
+              }>
+            >;
+          },
+          $strict
+        >
+      >
+    >;
+  },
+  $strict
+>;
+```
+
+Structural wire grammar for one Media generation request.
+
+---
+
+### mediaGenerationSelectionSchema
+
+```ts
+const mediaGenerationSelectionSchema: ZodObject<
+  {
+    model: ZodString;
+    prompt: ZodString;
+    width: ZodNumber;
+    height: ZodNumber;
+    steps: ZodOptional<ZodNumber>;
+    durationSeconds: ZodOptional<ZodNumber>;
+    resolution: ZodOptional<
+      ZodEnum<{
+        p480: "480p";
+        p720: "720p";
+        p1080: "1080p";
+        p4k: "4k";
+      }>
+    >;
+    aspectRatio: ZodOptional<
+      ZodEnum<{
+        wide: "16:9";
+        landscape: "4:3";
+        square: "1:1";
+        portrait: "3:4";
+        tall: "9:16";
+        ultrawide: "21:9";
+        ultratall: "9:21";
+      }>
+    >;
+    generateAudio: ZodOptional<ZodBoolean>;
+    references: ZodOptional<
+      ZodArray<
+        ZodObject<
+          {
+            path: ZodString;
+            role: ZodOptional<
+              ZodEnum<{
+                first: "first-frame";
+                last: "last-frame";
+                reference: "reference";
+              }>
+            >;
+          },
+          $strict
+        >
+      >
+    >;
+  },
+  $strict
+>;
+```
+
+App selections contain paths; the host supplies the admitted Computer.
+
+---
+
+### mediaVideoReferenceSchema
+
+```ts
+const mediaVideoReferenceSchema: ZodObject<
+  {
+    path: ZodString;
+    role: ZodEnum<{
+      first: "first-frame";
+      last: "last-frame";
+      reference: "reference";
+    }>;
+  },
+  $strict
+>;
+```
+
+Path-only video reference; the host supplies authority and reads its bytes.
+
+---
+
+### mediaVideoSelectionSchema
+
+```ts
+const mediaVideoSelectionSchema: ZodObject<
+  {
+    model: ZodEnum<{
+      seedance: "bytedance/seedance-2.0";
+      seedanceFast: "bytedance/seedance-2.0-fast";
+      seedanceMini: "bytedance/seedance-2.0-mini";
+      veo: "google/veo-3.1";
+      veoFast: "google/veo-3.1-fast";
+    }>;
+    prompt: ZodString;
+    resolution: ZodOptional<
+      ZodEnum<{
+        p480: "480p";
+        p720: "720p";
+        p1080: "1080p";
+        p4k: "4k";
+      }>
+    >;
+    aspectRatio: ZodOptional<
+      ZodEnum<{
+        wide: "16:9";
+        landscape: "4:3";
+        square: "1:1";
+        portrait: "3:4";
+        tall: "9:16";
+        ultrawide: "21:9";
+        ultratall: "9:21";
+      }>
+    >;
+    durationSeconds: ZodOptional<ZodNumber>;
+    generateAudio: ZodOptional<ZodBoolean>;
+    references: ZodOptional<
+      ZodArray<
+        ZodObject<
+          {
+            path: ZodString;
+            role: ZodEnum<{
+              first: "first-frame";
+              last: "last-frame";
+              reference: "reference";
+            }>;
+          },
+          $strict
+        >
+      >
+    >;
+  },
+  $strict
+>;
+```
+
+Neutral video selection; model-specific combinations are checked by
+validateMediaVideoSelection.
+
+---
+
+### mediaProviderWireSchema
+
+```ts
+const mediaProviderWireSchema: ZodUnion<
+  readonly [
+    ZodUnion<
+      readonly [
+        ZodObject<
+          {
+            image: ZodString;
+          },
+          $strip
+        >,
+        ZodObject<
+          {
+            image: ZodArray<
+              ZodObject<
+                {
+                  base64: ZodOptional<ZodString>;
+                  data: ZodOptional<ZodString>;
+                  url: ZodOptional<ZodURL>;
+                },
+                $strict
+              >
+            >;
+          },
+          $strip
+        >,
+        ZodObject<
+          {
+            images: ZodArray<
+              ZodObject<
+                {
+                  base64: ZodOptional<ZodString>;
+                  data: ZodOptional<ZodString>;
+                  url: ZodOptional<ZodURL>;
+                },
+                $strict
+              >
+            >;
+          },
+          $strip
+        >,
+      ]
+    >,
+    ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>,
+    ZodCustom<Response, Response>,
+    ZodCustom<
+      ReadableStream<Uint8Array<ArrayBufferLike>>,
+      ReadableStream<Uint8Array<ArrayBufferLike>>
+    >,
+  ]
+>;
+```
+
+Decode the Workers AI binding's raw output at the provider boundary.
+
+---
+
+### mediaRequestedImageFormatSchema
+
+```ts
+const mediaRequestedImageFormatSchema: ZodEnum<{
+  png: "png";
+  jpeg: "jpeg";
+  webp: "webp";
+}>;
+```
+
+An explicitly requested image encoding; video is outside this contract.
+
+---
+
+### mediaModelTierSchema
+
+```ts
+const mediaModelTierSchema: ZodEnum<{
+  draft: "draft";
+  balanced: "balanced";
+  premium: "premium";
+  max: "max";
+}>;
+```
+
+Agent-facing selection tier: cheap/fast draft work, the balanced default,
+premium for art the user will see, and max for the most expensive models. One
+value per model; never a price.
+
+---
+
+### mediaModelInputSchema
+
+```ts
+const mediaModelInputSchema: ZodReadonly<
+  ZodObject<
+    {
+      transport: ZodEnum<{
+        json: "json";
+        multipart: "multipart";
+      }>;
+      dimensions: ZodEnum<{
+        none: "none";
+        own: "own";
+      }>;
+      maxDimension: ZodNullable<ZodNumber>;
+      defaultWidth: ZodNumber;
+      defaultHeight: ZodNumber;
+      steps: ZodEnum<{
+        steps: "steps";
+        num_steps: "num_steps";
+        fixed: "fixed";
+      }>;
+      maxSteps: ZodNullable<ZodNumber>;
+      defaultSteps: ZodNullable<ZodNumber>;
+      referenceField: ZodNullable<ZodString>;
+      maxReferences: ZodNumber;
+    },
+    $strict
+  >
+>;
+```
+
+Media's provider catalog: Workers AI images plus gateway image and video models.
+
+---
+
+### mediaVideoModelIdSchema
+
+```ts
+const mediaVideoModelIdSchema: ZodEnum<{
+  seedance: "bytedance/seedance-2.0";
+  seedanceFast: "bytedance/seedance-2.0-fast";
+  seedanceMini: "bytedance/seedance-2.0-mini";
+  veo: "google/veo-3.1";
+  veoFast: "google/veo-3.1-fast";
+}>;
+```
+
+Verified Unified AI video identifiers; no inferred family aliases.
+
+---
+
+### mediaVideoResolutionSchema
+
+```ts
+const mediaVideoResolutionSchema: ZodEnum<{
+  p480: "480p";
+  p720: "720p";
+  p1080: "1080p";
+  p4k: "4k";
+}>;
+```
+
+Provider resolution selectors, refined against the selected catalog entry.
+
+---
+
+### mediaVideoAspectRatioSchema
+
+```ts
+const mediaVideoAspectRatioSchema: ZodEnum<{
+  wide: "16:9";
+  landscape: "4:3";
+  square: "1:1";
+  portrait: "3:4";
+  tall: "9:16";
+  ultrawide: "21:9";
+  ultratall: "9:21";
+}>;
+```
+
+Documented video aspect selectors, refined per model.
+
+---
+
+### mediaVideoReferenceRoleSchema
+
+```ts
+const mediaVideoReferenceRoleSchema: ZodEnum<{
+  first: "first-frame";
+  last: "last-frame";
+  reference: "reference";
+}>;
+```
+
+Explicit reference meaning; frame mode and reference mode are exclusive.
+
+---
+
+### mediaVideoFormatSchema
+
+```ts
+const mediaVideoFormatSchema: ZodReadonly<
+  ZodObject<
+    {
+      resolution: ZodEnum<{
+        p480: "480p";
+        p720: "720p";
+        p1080: "1080p";
+        p4k: "4k";
+      }>;
+      aspectRatio: ZodEnum<{
+        wide: "16:9";
+        landscape: "4:3";
+        square: "1:1";
+        portrait: "3:4";
+        tall: "9:16";
+        ultrawide: "21:9";
+        ultratall: "9:21";
+      }>;
+      width: ZodNumber;
+      height: ZodNumber;
+    },
+    $strict
+  >
+>;
+```
+
+One nominal size used to select provider resolution and aspect.
+
+---
+
+### mediaVideoSchema
+
+```ts
+const mediaVideoSchema: ZodReadonly<
+  ZodObject<
+    {
+      minSeconds: ZodNumber;
+      maxSeconds: ZodNumber;
+      defaultSeconds: ZodNumber;
+      durations: ZodReadonly<ZodArray<ZodNumber>>;
+      provider: ZodEnum<{
+        seedance: "seedance";
+        veo: "veo";
+      }>;
+      formats: ZodReadonly<
+        ZodArray<
+          ZodReadonly<
+            ZodObject<
+              {
+                resolution: ZodEnum<{
+                  p480: "480p";
+                  p720: "720p";
+                  p1080: "1080p";
+                  p4k: "4k";
+                }>;
+                aspectRatio: ZodEnum<{
+                  wide: "16:9";
+                  landscape: "4:3";
+                  square: "1:1";
+                  portrait: "3:4";
+                  tall: "9:16";
+                  ultrawide: "21:9";
+                  ultratall: "9:21";
+                }>;
+                width: ZodNumber;
+                height: ZodNumber;
+              },
+              $strict
+            >
+          >
+        >
+      >;
+      defaultResolution: ZodEnum<{
+        p480: "480p";
+        p720: "720p";
+        p1080: "1080p";
+        p4k: "4k";
+      }>;
+      defaultAspectRatio: ZodEnum<{
+        wide: "16:9";
+        landscape: "4:3";
+        square: "1:1";
+        portrait: "3:4";
+        tall: "9:16";
+        ultrawide: "21:9";
+        ultratall: "9:21";
+      }>;
+      defaultGenerateAudio: ZodNullable<ZodBoolean>;
+      maxPromptLength: ZodNumber;
+      referenceRoles: ZodReadonly<
+        ZodArray<
+          ZodEnum<{
+            first: "first-frame";
+            last: "last-frame";
+            reference: "reference";
+          }>
+        >
+      >;
+      maxReferenceImages: ZodNumber;
+      referenceResolutions: ZodReadonly<
+        ZodArray<
+          ZodEnum<{
+            p480: "480p";
+            p720: "720p";
+            p1080: "1080p";
+            p4k: "4k";
+          }>
+        >
+      >;
+      prices: ZodReadonly<
+        ZodArray<
+          ZodReadonly<
+            ZodObject<
+              {
+                resolution: ZodEnum<{
+                  p480: "480p";
+                  p720: "720p";
+                  p1080: "1080p";
+                  p4k: "4k";
+                }>;
+                silentMilliunitsPerSecond: ZodNumber;
+                audioMilliunitsPerSecond: ZodNumber;
+              },
+              $strict
+            >
+          >
+        >
+      >;
+    },
+    $strict
+  >
+>;
+```
+
+Verified video parameters and provider costs, checked 2026-10-11.
+
+---
+
+### mediaModelSchema
+
+```ts
+const mediaModelSchema: ZodReadonly<ZodObject<{
+  id: ZodString;
+  label: ZodString;
+  kind: ZodEnum<{
+     image: "image";
+     video: "video";
+  }>;
+  tier: ZodEnum<{
+     draft: "draft";
+     balanced: "balanced";
+     premium: "premium";
+     max: "max";
+  }>;
+  outputFormats: ZodReadonly<ZodArray<ZodEnum<{
+     png: "png";
+     jpeg: "jpeg";
+     webp: "webp";
+  }>>>;
+  input: ZodReadonly<ZodObject<{
+     transport: ZodEnum<{
+        json: "json";
+        multipart: "multipart";
+     }>;
+     dimensions: ZodEnum<{
+        none: "none";
+        own: "own";
+     }>;
+     maxDimension: ZodNullable<ZodNumber>;
+     defaultWidth: ZodNumber;
+     defaultHeight: ZodNumber;
+     steps: ZodEnum<{
+        steps: "steps";
+        num_steps: "num_steps";
+        fixed: "fixed";
+     }>;
+     maxSteps: ZodNullable<ZodNumber>;
+     defaultSteps: ZodNullable<ZodNumber>;
+     referenceField: ZodNullable<ZodString>;
+     maxReferences: ZodNumber;
+  }, $strict>>;
+  sizes: ZodNullable<ZodReadonly<ZodArray<ZodString>>>;
+  video: ZodNullable<ZodReadonly<ZodObject<{
+     minSeconds: ZodNumber;
+     maxSeconds: ZodNumber;
+     defaultSeconds: ZodNumber;
+     durations: ZodReadonly<ZodArray<ZodNumber>>;
+     provider: ZodEnum<{
+        seedance: "seedance";
+        veo: "veo";
+     }>;
+     formats: ZodReadonly<ZodArray<ZodReadonly<ZodObject<..., ...>>>>;
+     defaultResolution: ZodEnum<{
+        p480: "480p";
+        p720: "720p";
+        p1080: "1080p";
+        p4k: "4k";
+     }>;
+     defaultAspectRatio: ZodEnum<{
+        wide: "16:9";
+        landscape: "4:3";
+        square: "1:1";
+        portrait: "3:4";
+        tall: "9:16";
+        ultrawide: "21:9";
+        ultratall: "9:21";
+     }>;
+     defaultGenerateAudio: ZodNullable<ZodBoolean>;
+     maxPromptLength: ZodNumber;
+     referenceRoles: ZodReadonly<ZodArray<ZodEnum<{
+        first: ...;
+        last: ...;
+        reference: ...;
+     }>>>;
+     maxReferenceImages: ZodNumber;
+     referenceResolutions: ZodReadonly<ZodArray<ZodEnum<{
+        p480: ...;
+        p720: ...;
+        p1080: ...;
+        p4k: ...;
+     }>>>;
+     prices: ZodReadonly<ZodArray<ZodReadonly<ZodObject<..., ...>>>>;
+  }, $strict>>>;
+}, $strict>>;
+```
+
+Public wire grammar for a catalog entry returned by the Media owner.
+
+---
+
+### mediaModels
+
+```ts
+const mediaModels: readonly MediaModel[] = models;
+```
+
+The immutable image and video model catalog.
+
+---
+
+### USD\_PER\_1K\_NEURONS
+
+```ts
+const USD_PER_1K_NEURONS: 0.011 = 0.011;
+```
+
+Published Workers AI image rate: $0.011 per 1,000 neurons.
+
+## Functions
+
+### estimateImageNeurons()
+
+```ts
+function estimateImageNeurons(modelId, params): number;
+```
+
+Estimate Workers AI neurons from a validated image request.
+
+#### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| `modelId` | `string`                      |
+| `params`  | [`ImageParams`](#imageparams) |
+
+#### Returns
+
+`number`
+
+---
+
+### estimateImageMilliunits()
+
+```ts
+function estimateImageMilliunits(modelId, params): number;
+```
+
+Quote the same estimate in milliunits (1 cent = 1,000 milliunits).
+
+#### Parameters
+
+| Parameter | Type                          |
+| --------- | ----------------------------- |
+| `modelId` | `string`                      |
+| `params`  | [`ImageParams`](#imageparams) |
+
+#### Returns
+
+`number`
+
+---
+
+### validateMediaGenerationSettings()
+
+```ts
+function validateMediaGenerationSettings(raw): MediaGenerationSettings;
+```
+
+Validate caller settings and apply retained model defaults.
+
+#### Parameters
+
+| Parameter              | Type                                                                                                                                                                                                                                                                                                                                                     | Description                                                                   |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `raw`                  | \{ `model`: `string`; `prompt`: `string`; `width`: `number`; `height`: `number`; `steps?`: `number`; `durationSeconds?`: `number`; `resolution?`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | -                                                                             |
+| `raw.model`            | `string`                                                                                                                                                                                                                                                                                                                                                 | Provider catalog model identifier.                                            |
+| `raw.prompt`           | `string`                                                                                                                                                                                                                                                                                                                                                 | Generation prompt.                                                            |
+| `raw.width`            | `number`                                                                                                                                                                                                                                                                                                                                                 | Requested image width or nominal video selector, not decoded MP4 dimensions.  |
+| `raw.height`           | `number`                                                                                                                                                                                                                                                                                                                                                 | Requested image height or nominal video selector, not decoded MP4 dimensions. |
+| `raw.steps?`           | `number`                                                                                                                                                                                                                                                                                                                                                 | Model-specific inference step count.                                          |
+| `raw.durationSeconds?` | `number`                                                                                                                                                                                                                                                                                                                                                 | Requested video length in whole seconds.                                      |
+| `raw.resolution?`      | `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`                                                                                                                                                                                                                                                                                                              | Video resolution; must match the nominal width/height selector.               |
+| `raw.aspectRatio?`     | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`                                                                                                                                                                                                                                                                            | Video aspect; must match the nominal width/height selector.                   |
+| `raw.generateAudio?`   | `boolean`                                                                                                                                                                                                                                                                                                                                                | Video audio selection.                                                        |
+| `raw.references?`      | `object`[]                                                                                                                                                                                                                                                                                                                                               | Host-authorized reference images.                                             |
+
+#### Returns
+
+[`MediaGenerationSettings`](#mediagenerationsettings)
+
+---
+
+### validateMediaGenerationSelection()
+
+```ts
+function validateMediaGenerationSelection(
+  raw,
+): Readonly<Omit<MediaGenerationSettings, "references"> & object>;
+```
+
+Validate path-only selections without inventing a Computer identity.
+
+#### Parameters
+
+| Parameter              | Type                                                                                                                                                                                                                                                                                                                                                     | Description                                                                   |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `raw`                  | \{ `model`: `string`; `prompt`: `string`; `width`: `number`; `height`: `number`; `steps?`: `number`; `durationSeconds?`: `number`; `resolution?`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | -                                                                             |
+| `raw.model`            | `string`                                                                                                                                                                                                                                                                                                                                                 | Provider catalog model identifier.                                            |
+| `raw.prompt`           | `string`                                                                                                                                                                                                                                                                                                                                                 | Generation prompt.                                                            |
+| `raw.width`            | `number`                                                                                                                                                                                                                                                                                                                                                 | Requested image width or nominal video selector, not decoded MP4 dimensions.  |
+| `raw.height`           | `number`                                                                                                                                                                                                                                                                                                                                                 | Requested image height or nominal video selector, not decoded MP4 dimensions. |
+| `raw.steps?`           | `number`                                                                                                                                                                                                                                                                                                                                                 | Model-specific inference step count.                                          |
+| `raw.durationSeconds?` | `number`                                                                                                                                                                                                                                                                                                                                                 | Requested video length in whole seconds.                                      |
+| `raw.resolution?`      | `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`                                                                                                                                                                                                                                                                                                              | Video resolution; must match the nominal width/height selector.               |
+| `raw.aspectRatio?`     | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`                                                                                                                                                                                                                                                                            | Video aspect; must match the nominal width/height selector.                   |
+| `raw.generateAudio?`   | `boolean`                                                                                                                                                                                                                                                                                                                                                | Video audio selection.                                                        |
+| `raw.references?`      | `object`[]                                                                                                                                                                                                                                                                                                                                               | Host-authorized reference images.                                             |
+
+#### Returns
+
+`Readonly`\<`Omit`\<[`MediaGenerationSettings`](#mediagenerationsettings),
+`"references"`\> & `object`\>
+
+---
+
+### validateMediaVideoSelection()
+
+```ts
+function validateMediaVideoSelection(raw): MediaVideoSelection;
+```
+
+Validate supported model/size/duration/reference combinations before authority
+or billing admission.
+
+#### Parameters
+
+| Parameter              | Type                                                                                                                                                                                                                                                                                                                                                                                                                                      | Description                                                                                |
+| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| `raw`                  | \{ `model`: \| `"bytedance/seedance-2.0"` \| `"bytedance/seedance-2.0-fast"` \| `"bytedance/seedance-2.0-mini"` \| `"google/veo-3.1"` \| `"google/veo-3.1-fast"`; `prompt`: `string`; `resolution?`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `aspectRatio?`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`; `durationSeconds?`: `number`; `generateAudio?`: `boolean`; `references?`: `object`[]; \} | -                                                                                          |
+| `raw.model`            | \| `"bytedance/seedance-2.0"` \| `"bytedance/seedance-2.0-fast"` \| `"bytedance/seedance-2.0-mini"` \| `"google/veo-3.1"` \| `"google/veo-3.1-fast"`                                                                                                                                                                                                                                                                                      | Verified catalog model identifier.                                                         |
+| `raw.prompt`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                  | Trimmed prompt; Seedance allows 2,000 characters, Veo uses the retained host cap of 2,048. |
+| `raw.resolution?`      | `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`                                                                                                                                                                                                                                                                                                                                                                                               | Model-specific resolution, default 720p.                                                   |
+| `raw.aspectRatio?`     | `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`                                                                                                                                                                                                                                                                                                                                                             | Model-specific aspect, default 16:9.                                                       |
+| `raw.durationSeconds?` | `number`                                                                                                                                                                                                                                                                                                                                                                                                                                  | Whole seconds; Seedance 4–12, Veo exactly 4/6/8.                                           |
+| `raw.generateAudio?`   | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                 | Veo defaults true; Seedance omits the provider option when unset.                          |
+| `raw.references?`      | `object`[]                                                                                                                                                                                                                                                                                                                                                                                                                                | Up to four references, with provider-specific roles and mode limits.                       |
+
+#### Returns
+
+[`MediaVideoSelection`](#mediavideoselection)
+
+---
+
+### resolveMediaReferences()
+
+```ts
+function resolveMediaReferences(
+  settings,
+  reader,
+): Promise<
+  readonly Readonly<{
+    bytes: Uint8Array;
+    format: ImageFormat;
+    width: number;
+    height: number;
+    filename?: string;
+  }>[]
+>;
+```
+
+Resolve only provider-accepted references through the caller's reader.
+
+#### Parameters
+
+| Parameter  | Type                                                  |
+| ---------- | ----------------------------------------------------- |
+| `settings` | [`MediaGenerationSettings`](#mediagenerationsettings) |
+| `reader`   | [`MediaReferenceReader`](#mediareferencereader)       |
+
+#### Returns
+
+`Promise`\<readonly `Readonly`\<\{ `bytes`: `Uint8Array`; `format`:
+[`ImageFormat`](#imageformat); `width`: `number`; `height`: `number`;
+`filename?`: `string`; \}\>[]\>
+
+---
+
+### buildProviderInput()
+
+```ts
+function buildProviderInput(settings, references?): MediaProviderPayload;
+```
+
+Build the exact JSON or multipart payload required by a retained model.
+
+#### Parameters
+
+| Parameter    | Type                                                                                                                                                         | Default value |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------- |
+| `settings`   | [`MediaGenerationSettings`](#mediagenerationsettings)                                                                                                        | `undefined`   |
+| `references` | readonly `Readonly`\<\{ `bytes`: `Uint8Array`; `format`: [`ImageFormat`](#imageformat); `width`: `number`; `height`: `number`; `filename?`: `string`; \}\>[] | `[]`          |
+
+#### Returns
+
+[`MediaProviderPayload`](#mediaproviderpayload)
+
+---
+
+### parseMediaProviderOutput()
+
+```ts
+function parseMediaProviderOutput(value): MediaProviderOutput;
+```
+
+Parse the provider wire envelope before normalization.
+
+#### Parameters
+
+| Parameter | Type                                                                                                                                                                                             |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `value`   | \| `Response` \| `Uint8Array`\<`ArrayBuffer`\> \| `ReadableStream`\<`Uint8Array`\<`ArrayBufferLike`\>\> \| \{ `image`: `string`; \} \| \{ `image`: `object`[]; \} \| \{ `images`: `object`[]; \} |
+
+#### Returns
+
+[`MediaProviderOutput`](#mediaprovideroutput)
+
+---
+
+### readResponseBytes()
+
+```ts
+function readResponseBytes(
+  response,
+  maximumBytes,
+): Promise<Uint8Array<ArrayBufferLike>>;
+```
+
+Read a successful provider response within an explicit byte bound, closing its
+reader.
+
+#### Parameters
+
+| Parameter      | Type       |
+| -------------- | ---------- |
+| `response`     | `Response` |
+| `maximumBytes` | `number`   |
+
+#### Returns
+
+`Promise`\<`Uint8Array`\<`ArrayBufferLike`\>\>
+
+---
+
+### normalizeMediaProviderOutput()
+
+```ts
+function normalizeMediaProviderOutput(
+  value,
+  options?,
+): Promise<
+  Readonly<{
+    bytes: Uint8Array;
+    format: ImageFormat;
+  }>
+>;
+```
+
+Normalize all retained provider envelopes into bounded image bytes.
+
+#### Parameters
+
+| Parameter | Type                                                                                                                                                                                             |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `value`   | \| `Response` \| `Uint8Array`\<`ArrayBuffer`\> \| `ReadableStream`\<`Uint8Array`\<`ArrayBufferLike`\>\> \| \{ `image`: `string`; \} \| \{ `image`: `object`[]; \} \| \{ `images`: `object`[]; \} |
+| `options` | [`MediaProviderOutputOptions`](#mediaprovideroutputoptions)                                                                                                                                      |
+
+#### Returns
+
+`Promise`\<`Readonly`\<\{ `bytes`: `Uint8Array`; `format`:
+[`ImageFormat`](#imageformat); \}\>\>
+
+---
+
+### estimateVideoMilliunits()
+
+```ts
+function estimateVideoMilliunits(settings): number;
+```
+
+Provider video cost from the sole catalog, in milliunits (1 cent = 1,000).
+Video-input references are unsupported.
+
+#### Parameters
+
+| Parameter  | Type                                                  |
+| ---------- | ----------------------------------------------------- |
+| `settings` | [`MediaVideoQuoteSettings`](#mediavideoquotesettings) |
+
+#### Returns
+
+`number`
+
+---
+
+### listMediaModels()
+
+```ts
+function listMediaModels(): readonly Readonly<{
+  id: string;
+  label: string;
+  kind: "image" | "video";
+  tier: "draft" | "balanced" | "premium" | "max";
+  outputFormats: readonly ("png" | "jpeg" | "webp")[];
+  input: Readonly<{
+    transport: "json" | "multipart";
+    dimensions: "none" | "own";
+    maxDimension: number | null;
+    defaultWidth: number;
+    defaultHeight: number;
+    steps: "steps" | "num_steps" | "fixed";
+    maxSteps: number | null;
+    defaultSteps: number | null;
+    referenceField: string | null;
+    maxReferences: number;
+  }>;
+  sizes: readonly string[] | null;
+  video: Readonly<{
+    minSeconds: number;
+    maxSeconds: number;
+    defaultSeconds: number;
+    durations: readonly number[];
+    provider: "seedance" | "veo";
+    formats: readonly Readonly<{
+      resolution: "480p" | "720p" | "1080p" | "4k";
+      aspectRatio: "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
+      width: number;
+      height: number;
+    }>[];
+    defaultResolution: "480p" | "720p" | "1080p" | "4k";
+    defaultAspectRatio:
+      "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
+    defaultGenerateAudio: boolean | null;
+    maxPromptLength: number;
+    referenceRoles: readonly ("first-frame" | "last-frame" | "reference")[];
+    maxReferenceImages: number;
+    referenceResolutions: readonly ("480p" | "720p" | "1080p" | "4k")[];
+    prices: readonly Readonly<{
+      resolution: "480p" | "720p" | "1080p" | "4k";
+      silentMilliunitsPerSecond: number;
+      audioMilliunitsPerSecond: number;
+    }>[];
+  }> | null;
+}>[];
+```
+
+List all image and video models in catalog order.
+
+#### Returns
+
+readonly `Readonly`\<\{ `id`: `string`; `label`: `string`; `kind`: `"image"` \|
+`"video"`; `tier`: `"draft"` \| `"balanced"` \| `"premium"` \| `"max"`;
+`outputFormats`: readonly (`"png"` \| `"jpeg"` \| `"webp"`)[]; `input`:
+`Readonly`\<\{ `transport`: `"json"` \| `"multipart"`; `dimensions`: `"none"` \|
+`"own"`; `maxDimension`: `number` \| `null`; `defaultWidth`: `number`;
+`defaultHeight`: `number`; `steps`: `"steps"` \| `"num_steps"` \| `"fixed"`;
+`maxSteps`: `number` \| `null`; `defaultSteps`: `number` \| `null`;
+`referenceField`: `string` \| `null`; `maxReferences`: `number`; \}\>; `sizes`:
+readonly `string`[] \| `null`; `video`: \| `Readonly`\<\{ `minSeconds`:
+`number`; `maxSeconds`: `number`; `defaultSeconds`: `number`; `durations`:
+readonly `number`[]; `provider`: `"seedance"` \| `"veo"`; `formats`: readonly
+`Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
+`aspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"`
+\| `"9:21"`; `width`: `number`; `height`: `number`; \}\>[]; `defaultResolution`:
+`"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `defaultAspectRatio`: `"16:9"` \|
+`"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`;
+`defaultGenerateAudio`: `boolean` \| `null`; `maxPromptLength`: `number`;
+`referenceRoles`: readonly (`"first-frame"` \| `"last-frame"` \|
+`"reference"`)[]; `maxReferenceImages`: `number`; `referenceResolutions`:
+readonly (`"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`)[]; `prices`: readonly
+`Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
+`silentMilliunitsPerSecond`: `number`; `audioMilliunitsPerSecond`: `number`;
+\}\>[]; \}\> \| `null`; \}\>[]
+
+---
+
+### getMediaModel()
+
+```ts
+function getMediaModel(id):
+  | Readonly<{
+      id: string;
+      label: string;
+      kind: "image" | "video";
+      tier: "draft" | "balanced" | "premium" | "max";
+      outputFormats: readonly ("png" | "jpeg" | "webp")[];
+      input: Readonly<{
+        transport: "json" | "multipart";
+        dimensions: "none" | "own";
+        maxDimension: number | null;
+        defaultWidth: number;
+        defaultHeight: number;
+        steps: "steps" | "num_steps" | "fixed";
+        maxSteps: number | null;
+        defaultSteps: number | null;
+        referenceField: string | null;
+        maxReferences: number;
+      }>;
+      sizes: readonly string[] | null;
+      video: Readonly<{
+        minSeconds: number;
+        maxSeconds: number;
+        defaultSeconds: number;
+        durations: readonly number[];
+        provider: "seedance" | "veo";
+        formats: readonly Readonly<{
+          resolution: "480p" | "720p" | "1080p" | "4k";
+          aspectRatio:
+            "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
+          width: number;
+          height: number;
+        }>[];
+        defaultResolution: "480p" | "720p" | "1080p" | "4k";
+        defaultAspectRatio:
+          "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "9:21";
+        defaultGenerateAudio: boolean | null;
+        maxPromptLength: number;
+        referenceRoles: readonly ("first-frame" | "last-frame" | "reference")[];
+        maxReferenceImages: number;
+        referenceResolutions: readonly ("480p" | "720p" | "1080p" | "4k")[];
+        prices: readonly Readonly<{
+          resolution: "480p" | "720p" | "1080p" | "4k";
+          silentMilliunitsPerSecond: number;
+          audioMilliunitsPerSecond: number;
+        }>[];
+      }> | null;
+    }>
+  | undefined;
+```
+
+Find a model by provider identifier, returning undefined when it is absent.
+
+#### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `id`      | `string` |
+
+#### Returns
+
+\| `Readonly`\<\{ `id`: `string`; `label`: `string`; `kind`: `"image"` \|
+`"video"`; `tier`: `"draft"` \| `"balanced"` \| `"premium"` \| `"max"`;
+`outputFormats`: readonly (`"png"` \| `"jpeg"` \| `"webp"`)[]; `input`:
+`Readonly`\<\{ `transport`: `"json"` \| `"multipart"`; `dimensions`: `"none"` \|
+`"own"`; `maxDimension`: `number` \| `null`; `defaultWidth`: `number`;
+`defaultHeight`: `number`; `steps`: `"steps"` \| `"num_steps"` \| `"fixed"`;
+`maxSteps`: `number` \| `null`; `defaultSteps`: `number` \| `null`;
+`referenceField`: `string` \| `null`; `maxReferences`: `number`; \}\>; `sizes`:
+readonly `string`[] \| `null`; `video`: \| `Readonly`\<\{ `minSeconds`:
+`number`; `maxSeconds`: `number`; `defaultSeconds`: `number`; `durations`:
+readonly `number`[]; `provider`: `"seedance"` \| `"veo"`; `formats`: readonly
+`Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
+`aspectRatio`: `"16:9"` \| `"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"`
+\| `"9:21"`; `width`: `number`; `height`: `number`; \}\>[]; `defaultResolution`:
+`"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`; `defaultAspectRatio`: `"16:9"` \|
+`"4:3"` \| `"1:1"` \| `"3:4"` \| `"9:16"` \| `"21:9"` \| `"9:21"`;
+`defaultGenerateAudio`: `boolean` \| `null`; `maxPromptLength`: `number`;
+`referenceRoles`: readonly (`"first-frame"` \| `"last-frame"` \|
+`"reference"`)[]; `maxReferenceImages`: `number`; `referenceResolutions`:
+readonly (`"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`)[]; `prices`: readonly
+`Readonly`\<\{ `resolution`: `"480p"` \| `"720p"` \| `"1080p"` \| `"4k"`;
+`silentMilliunitsPerSecond`: `number`; `audioMilliunitsPerSecond`: `number`;
+\}\>[]; \}\> \| `null`; \}\> \| `undefined`
+
+---
+
+### neuronsToMilliunits()
+
+```ts
+function neuronsToMilliunits(neurons): number;
+```
+
+Convert a neuron estimate to milliunits, rounding up to avoid underquoting.
+
+#### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `neurons` | `number` |
+
+#### Returns
+
+`number`