@ai-sdk/luma 3.0.0-beta.3 → 3.0.0-beta.31

package/src/luma-image-model.ts

@@ -1,11 +1,10 @@
 import {
-  ImageModelV3,
-  ImageModelV3File,
-  SharedV3Warning,
   InvalidResponseDataError,
+  type ImageModelV4,
+  type ImageModelV4File,
+  type SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
-  FetchFunction,
   combineHeaders,
   createBinaryResponseHandler,
   createJsonResponseHandler,
@@ -14,12 +13,16 @@ import {
   delay,
   getFromApi,
   postJsonToApi,
-  InferSchema,
   lazySchema,
   parseProviderOptions,
   zodSchema,
+  serializeModelOptions,
+  WORKFLOW_SERIALIZE,
+  WORKFLOW_DESERIALIZE,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
-import { LumaImageSettings, LumaReferenceType } from './luma-image-settings';
+import { lumaImageModelOptionsSchema } from './luma-image-model-options';
+import type { LumaReferenceType } from './luma-image-settings';
 import { z } from 'zod/v4';
 
 const DEFAULT_POLL_INTERVAL_MILLIS = 500;
@@ -28,15 +31,15 @@ const DEFAULT_MAX_POLL_ATTEMPTS = 60000 / DEFAULT_POLL_INTERVAL_MILLIS;
 interface LumaImageModelConfig {
   provider: string;
   baseURL: string;
-  headers: () => Record<string, string>;
+  headers?: () => Record<string, string>;
   fetch?: FetchFunction;
   _internal?: {
     currentDate?: () => Date;
   };
 }
 
-export class LumaImageModel implements ImageModelV3 {
-  readonly specificationVersion = 'v3';
+export class LumaImageModel implements ImageModelV4 {
+  readonly specificationVersion = 'v4';
   readonly maxImagesPerCall = 1;
   readonly pollIntervalMillis = DEFAULT_POLL_INTERVAL_MILLIS;
   readonly maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS;
@@ -45,6 +48,20 @@ export class LumaImageModel implements ImageModelV3 {
     return this.config.provider;
   }
 
+  static [WORKFLOW_SERIALIZE](model: LumaImageModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: string;
+    config: LumaImageModelConfig;
+  }) {
+    return new LumaImageModel(options.modelId, options.config);
+  }
+
   constructor(
     readonly modelId: string,
     private readonly config: LumaImageModelConfig,
@@ -52,7 +69,6 @@ export class LumaImageModel implements ImageModelV3 {
 
   async doGenerate({
     prompt,
-    n,
     size,
     aspectRatio,
     seed,
@@ -61,10 +77,10 @@ export class LumaImageModel implements ImageModelV3 {
     abortSignal,
     files,
     mask,
-  }: Parameters<ImageModelV3['doGenerate']>[0]): Promise<
-    Awaited<ReturnType<ImageModelV3['doGenerate']>>
+  }: Parameters<ImageModelV4['doGenerate']>[0]): Promise<
+    Awaited<ReturnType<ImageModelV4['doGenerate']>>
   > {
-    const warnings: Array<SharedV3Warning> = [];
+    const warnings: Array<SharedV4Warning> = [];
 
     if (seed != null) {
       warnings.push({
@@ -108,7 +124,7 @@ export class LumaImageModel implements ImageModelV3 {
     );
 
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
-    const fullHeaders = combineHeaders(this.config.headers(), headers);
+    const fullHeaders = combineHeaders(this.config.headers?.(), headers);
     const { value: generationResponse, responseHeaders } = await postJsonToApi({
       url: this.getLumaGenerationsUrl(),
       headers: fullHeaders,
@@ -206,8 +222,8 @@ export class LumaImageModel implements ImageModelV3 {
   }
 
   private getEditingOptions(
-    files: ImageModelV3File[] | undefined,
-    mask: ImageModelV3File | undefined,
+    files: ImageModelV4File[] | undefined,
+    mask: ImageModelV4File | undefined,
     referenceType: LumaReferenceType = 'image',
     imageConfigs: Array<{ weight?: number | null; id?: string | null }> = [],
   ): Record<string, unknown> {
@@ -380,62 +396,3 @@ export type LumaErrorData = z.infer<typeof lumaErrorSchema>;
  *
  * @see https://docs.lumalabs.ai/docs/image-generation
  */
-export const lumaImageModelOptionsSchema = lazySchema(() =>
-  zodSchema(
-    z
-      .object({
-        /**
-         * The type of image reference to use when providing input images.
-         * - `image`: Guide generation using reference images (up to 4). Default.
-         * - `style`: Apply a specific style from reference image(s).
-         * - `character`: Create consistent characters from reference images (up to 4).
-         * - `modify_image`: Transform a single input image with prompt guidance.
-         */
-        referenceType: z
-          .enum(['image', 'style', 'character', 'modify_image'])
-          .nullish(),
-
-        /**
-         * Per-image configuration array. Each entry corresponds to an image in `prompt.images`.
-         * Allows setting individual weights for each reference image.
-         */
-        images: z
-          .array(
-            z.object({
-              /**
-               * The weight of this image's influence on the generation.
-               * - For `image`: Higher weight = closer to reference (default: 0.85)
-               * - For `style`: Higher weight = stronger style influence (default: 0.8)
-               * - For `modify_image`: Higher weight = closer to input, lower = more creative (default: 1.0)
-               */
-              weight: z.number().min(0).max(1).nullish(),
-
-              /**
-               * The identity name for character references.
-               * Used with `character` to specify which identity group the image belongs to.
-               * Luma supports multiple identities (e.g., 'identity0', 'identity1') for generating
-               * images with multiple consistent characters.
-               * Default: 'identity0'
-               */
-              id: z.string().nullish(),
-            }),
-          )
-          .nullish(),
-
-        /**
-         * Override the polling interval in milliseconds (default 500).
-         */
-        pollIntervalMillis: z.number().nullish(),
-
-        /**
-         * Override the maximum number of polling attempts (default 120).
-         */
-        maxPollAttempts: z.number().nullish(),
-      })
-      .passthrough(),
-  ),
-);
-
-export type LumaImageModelOptions = InferSchema<
-  typeof lumaImageModelOptionsSchema
->;

package/src/luma-provider.ts

@@ -1,12 +1,16 @@
-import { ImageModelV3, NoSuchModelError, ProviderV3 } from '@ai-sdk/provider';
 import {
-  FetchFunction,
+  NoSuchModelError,
+  type ImageModelV4,
+  type ProviderV4,
+} from '@ai-sdk/provider';
+import {
   loadApiKey,
   withoutTrailingSlash,
   withUserAgentSuffix,
+  type FetchFunction,
 } from '@ai-sdk/provider-utils';
 import { LumaImageModel } from './luma-image-model';
-import { LumaImageModelId } from './luma-image-settings';
+import type { LumaImageModelId } from './luma-image-settings';
 import { VERSION } from './version';
 
 export interface LumaProviderSettings {
@@ -30,16 +34,16 @@ export interface LumaProviderSettings {
   fetch?: FetchFunction;
 }
 
-export interface LumaProvider extends ProviderV3 {
+export interface LumaProvider extends ProviderV4 {
   /**
    * Creates a model for image generation.
    */
-  image(modelId: LumaImageModelId): ImageModelV3;
+  image(modelId: LumaImageModelId): ImageModelV4;
 
   /**
    * Creates a model for image generation.
    */
-  imageModel(modelId: LumaImageModelId): ImageModelV3;
+  imageModel(modelId: LumaImageModelId): ImageModelV4;
 
   /**
    * @deprecated Use `embeddingModel` instead.
@@ -80,7 +84,7 @@ export function createLuma(options: LumaProviderSettings = {}): LumaProvider {
   };
 
   return {
-    specificationVersion: 'v3' as const,
+    specificationVersion: 'v4' as const,
     image: createImageModel,
     imageModel: createImageModel,
     languageModel: (modelId: string) => {

package/dist/index.d.mts

@@ -1,76 +0,0 @@
-import { ProviderV3, ImageModelV3 } from '@ai-sdk/provider';
-import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
-import { FetchFunction, InferSchema } from '@ai-sdk/provider-utils';
-import { z } from 'zod/v4';
-
-type LumaImageModelId = 'photon-1' | 'photon-flash-1' | (string & {});
-
-interface LumaProviderSettings {
-    /**
-     * Luma API key. Default value is taken from the `LUMA_API_KEY` environment
-     * variable.
-     */
-    apiKey?: string;
-    /**
-     * Base URL for the API calls.
-     */
-    baseURL?: string;
-    /**
-     * Custom headers to include in the requests.
-     */
-    headers?: Record<string, string>;
-    /**
-     * Custom fetch implementation. You can use it as a middleware to intercept requests,
-     * or to provide a custom fetch implementation for e.g. testing.
-     */
-    fetch?: FetchFunction;
-}
-interface LumaProvider extends ProviderV3 {
-    /**
-     * Creates a model for image generation.
-     */
-    image(modelId: LumaImageModelId): ImageModelV3;
-    /**
-     * Creates a model for image generation.
-     */
-    imageModel(modelId: LumaImageModelId): ImageModelV3;
-    /**
-     * @deprecated Use `embeddingModel` instead.
-     */
-    textEmbeddingModel(modelId: string): never;
-}
-declare function createLuma(options?: LumaProviderSettings): LumaProvider;
-declare const luma: LumaProvider;
-
-declare const lumaErrorSchema: z.ZodObject<{
-    detail: z.ZodArray<z.ZodObject<{
-        type: z.ZodString;
-        loc: z.ZodArray<z.ZodString>;
-        msg: z.ZodString;
-        input: z.ZodString;
-        ctx: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            expected: z.ZodString;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-type LumaErrorData = z.infer<typeof lumaErrorSchema>;
-/**
- * Provider options schema for Luma image generation.
- *
- * @see https://docs.lumalabs.ai/docs/image-generation
- */
-declare const lumaImageModelOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
-    [x: string]: unknown;
-    referenceType?: "image" | "style" | "character" | "modify_image" | null | undefined;
-    images?: {
-        weight?: number | null | undefined;
-        id?: string | null | undefined;
-    }[] | null | undefined;
-    pollIntervalMillis?: number | null | undefined;
-    maxPollAttempts?: number | null | undefined;
-}>;
-type LumaImageModelOptions = InferSchema<typeof lumaImageModelOptionsSchema>;
-
-declare const VERSION: string;
-
-export { type LumaErrorData, type LumaImageModelOptions, type LumaImageModelOptions as LumaImageProviderOptions, type LumaProvider, type LumaProviderSettings, VERSION, createLuma, luma };

package/dist/index.mjs

@@ -1,399 +0,0 @@
-// src/luma-provider.ts
-import { NoSuchModelError } from "@ai-sdk/provider";
-import {
-  loadApiKey,
-  withoutTrailingSlash,
-  withUserAgentSuffix
-} from "@ai-sdk/provider-utils";
-
-// src/luma-image-model.ts
-import {
-  InvalidResponseDataError
-} from "@ai-sdk/provider";
-import {
-  combineHeaders,
-  createBinaryResponseHandler,
-  createJsonResponseHandler,
-  createJsonErrorResponseHandler,
-  createStatusCodeErrorResponseHandler,
-  delay,
-  getFromApi,
-  postJsonToApi,
-  lazySchema,
-  parseProviderOptions,
-  zodSchema
-} from "@ai-sdk/provider-utils";
-import { z } from "zod/v4";
-var DEFAULT_POLL_INTERVAL_MILLIS = 500;
-var DEFAULT_MAX_POLL_ATTEMPTS = 6e4 / DEFAULT_POLL_INTERVAL_MILLIS;
-var LumaImageModel = class {
-  constructor(modelId, config) {
-    this.modelId = modelId;
-    this.config = config;
-    this.specificationVersion = "v3";
-    this.maxImagesPerCall = 1;
-    this.pollIntervalMillis = DEFAULT_POLL_INTERVAL_MILLIS;
-    this.maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS;
-  }
-  get provider() {
-    return this.config.provider;
-  }
-  async doGenerate({
-    prompt,
-    n,
-    size,
-    aspectRatio,
-    seed,
-    providerOptions,
-    headers,
-    abortSignal,
-    files,
-    mask
-  }) {
-    var _a, _b, _c;
-    const warnings = [];
-    if (seed != null) {
-      warnings.push({
-        type: "unsupported",
-        feature: "seed",
-        details: "This model does not support the `seed` option."
-      });
-    }
-    if (size != null) {
-      warnings.push({
-        type: "unsupported",
-        feature: "size",
-        details: "This model does not support the `size` option. Use `aspectRatio` instead."
-      });
-    }
-    const lumaOptions = await parseProviderOptions({
-      provider: "luma",
-      providerOptions,
-      schema: lumaImageModelOptionsSchema
-    });
-    const {
-      pollIntervalMillis,
-      maxPollAttempts,
-      referenceType,
-      images: imageConfigs,
-      ...providerRequestOptions
-    } = lumaOptions != null ? lumaOptions : {};
-    const editingOptions = this.getEditingOptions(
-      files,
-      mask,
-      referenceType != null ? referenceType : void 0,
-      imageConfigs != null ? imageConfigs : []
-    );
-    const currentDate = (_c = (_b = (_a = this.config._internal) == null ? void 0 : _a.currentDate) == null ? void 0 : _b.call(_a)) != null ? _c : /* @__PURE__ */ new Date();
-    const fullHeaders = combineHeaders(this.config.headers(), headers);
-    const { value: generationResponse, responseHeaders } = await postJsonToApi({
-      url: this.getLumaGenerationsUrl(),
-      headers: fullHeaders,
-      body: {
-        prompt,
-        ...aspectRatio ? { aspect_ratio: aspectRatio } : {},
-        model: this.modelId,
-        ...editingOptions,
-        ...providerRequestOptions
-      },
-      abortSignal,
-      fetch: this.config.fetch,
-      failedResponseHandler: this.createLumaErrorHandler(),
-      successfulResponseHandler: createJsonResponseHandler(
-        lumaGenerationResponseSchema
-      )
-    });
-    const imageUrl = await this.pollForImageUrl(
-      generationResponse.id,
-      fullHeaders,
-      abortSignal,
-      {
-        pollIntervalMillis: pollIntervalMillis != null ? pollIntervalMillis : void 0,
-        maxPollAttempts: maxPollAttempts != null ? maxPollAttempts : void 0
-      }
-    );
-    const downloadedImage = await this.downloadImage(imageUrl, abortSignal);
-    return {
-      images: [downloadedImage],
-      warnings,
-      response: {
-        modelId: this.modelId,
-        timestamp: currentDate,
-        headers: responseHeaders
-      }
-    };
-  }
-  async pollForImageUrl(generationId, headers, abortSignal, pollSettings) {
-    var _a, _b, _c;
-    const url = this.getLumaGenerationsUrl(generationId);
-    const maxPollAttempts = (_a = pollSettings == null ? void 0 : pollSettings.maxPollAttempts) != null ? _a : this.maxPollAttempts;
-    const pollIntervalMillis = (_b = pollSettings == null ? void 0 : pollSettings.pollIntervalMillis) != null ? _b : this.pollIntervalMillis;
-    for (let i = 0; i < maxPollAttempts; i++) {
-      const { value: statusResponse } = await getFromApi({
-        url,
-        headers,
-        abortSignal,
-        fetch: this.config.fetch,
-        failedResponseHandler: this.createLumaErrorHandler(),
-        successfulResponseHandler: createJsonResponseHandler(
-          lumaGenerationResponseSchema
-        )
-      });
-      switch (statusResponse.state) {
-        case "completed":
-          if (!((_c = statusResponse.assets) == null ? void 0 : _c.image)) {
-            throw new InvalidResponseDataError({
-              data: statusResponse,
-              message: `Image generation completed but no image was found.`
-            });
-          }
-          return statusResponse.assets.image;
-        case "failed":
-          throw new InvalidResponseDataError({
-            data: statusResponse,
-            message: `Image generation failed.`
-          });
-      }
-      await delay(pollIntervalMillis);
-    }
-    throw new Error(
-      `Image generation timed out after ${this.maxPollAttempts} attempts.`
-    );
-  }
-  createLumaErrorHandler() {
-    return createJsonErrorResponseHandler({
-      errorSchema: lumaErrorSchema,
-      errorToMessage: (error) => {
-        var _a;
-        return (_a = error.detail[0].msg) != null ? _a : "Unknown error";
-      }
-    });
-  }
-  getEditingOptions(files, mask, referenceType = "image", imageConfigs = []) {
-    var _a, _b, _c, _d;
-    const options = {};
-    if (mask != null) {
-      throw new Error(
-        "Luma AI does not support mask-based image editing. Use the prompt to describe the changes you want to make, along with `prompt.images` containing the source image URL."
-      );
-    }
-    if (files == null || files.length === 0) {
-      return options;
-    }
-    for (const file of files) {
-      if (file.type !== "url") {
-        throw new Error(
-          "Luma AI only supports URL-based images. Please provide image URLs using `prompt.images` with publicly accessible URLs. Base64 and Uint8Array data are not supported."
-        );
-      }
-    }
-    const defaultWeights = {
-      image: 0.85,
-      style: 0.8,
-      character: 1,
-      // Not used, but defined for completeness
-      modify_image: 1
-    };
-    switch (referenceType) {
-      case "image": {
-        if (files.length > 4) {
-          throw new Error(
-            `Luma AI image supports up to 4 reference images. You provided ${files.length} images.`
-          );
-        }
-        options.image = files.map((file, index) => {
-          var _a2, _b2;
-          return {
-            url: file.url,
-            weight: (_b2 = (_a2 = imageConfigs[index]) == null ? void 0 : _a2.weight) != null ? _b2 : defaultWeights.image
-          };
-        });
-        break;
-      }
-      case "style": {
-        options.style = files.map((file, index) => {
-          var _a2, _b2;
-          return {
-            url: file.url,
-            weight: (_b2 = (_a2 = imageConfigs[index]) == null ? void 0 : _a2.weight) != null ? _b2 : defaultWeights.style
-          };
-        });
-        break;
-      }
-      case "character": {
-        const identities = {};
-        for (let i = 0; i < files.length; i++) {
-          const file = files[i];
-          const identityId = (_b = (_a = imageConfigs[i]) == null ? void 0 : _a.id) != null ? _b : "identity0";
-          if (!identities[identityId]) {
-            identities[identityId] = [];
-          }
-          identities[identityId].push(file.url);
-        }
-        for (const [identityId, images] of Object.entries(identities)) {
-          if (images.length > 4) {
-            throw new Error(
-              `Luma AI character supports up to 4 images per identity. Identity '${identityId}' has ${images.length} images.`
-            );
-          }
-        }
-        options.character = Object.fromEntries(
-          Object.entries(identities).map(([id, images]) => [id, { images }])
-        );
-        break;
-      }
-      case "modify_image": {
-        if (files.length > 1) {
-          throw new Error(
-            `Luma AI modify_image only supports a single input image. You provided ${files.length} images.`
-          );
-        }
-        options.modify_image = {
-          url: files[0].url,
-          weight: (_d = (_c = imageConfigs[0]) == null ? void 0 : _c.weight) != null ? _d : defaultWeights.modify_image
-        };
-        break;
-      }
-    }
-    return options;
-  }
-  getLumaGenerationsUrl(generationId) {
-    return `${this.config.baseURL}/dream-machine/v1/generations/${generationId != null ? generationId : "image"}`;
-  }
-  async downloadImage(url, abortSignal) {
-    const { value: response } = await getFromApi({
-      url,
-      // No specific headers should be needed for this request as it's a
-      // generated image provided by Luma.
-      abortSignal,
-      failedResponseHandler: createStatusCodeErrorResponseHandler(),
-      successfulResponseHandler: createBinaryResponseHandler(),
-      fetch: this.config.fetch
-    });
-    return response;
-  }
-};
-var lumaGenerationResponseSchema = lazySchema(
-  () => zodSchema(
-    z.object({
-      id: z.string(),
-      state: z.enum(["queued", "dreaming", "completed", "failed"]),
-      failure_reason: z.string().nullish(),
-      assets: z.object({
-        image: z.string()
-        // URL of the generated image
-      }).nullish()
-    })
-  )
-);
-var lumaErrorSchema = z.object({
-  detail: z.array(
-    z.object({
-      type: z.string(),
-      loc: z.array(z.string()),
-      msg: z.string(),
-      input: z.string(),
-      ctx: z.object({
-        expected: z.string()
-      }).nullish()
-    })
-  )
-});
-var lumaImageModelOptionsSchema = lazySchema(
-  () => zodSchema(
-    z.object({
-      /**
-       * The type of image reference to use when providing input images.
-       * - `image`: Guide generation using reference images (up to 4). Default.
-       * - `style`: Apply a specific style from reference image(s).
-       * - `character`: Create consistent characters from reference images (up to 4).
-       * - `modify_image`: Transform a single input image with prompt guidance.
-       */
-      referenceType: z.enum(["image", "style", "character", "modify_image"]).nullish(),
-      /**
-       * Per-image configuration array. Each entry corresponds to an image in `prompt.images`.
-       * Allows setting individual weights for each reference image.
-       */
-      images: z.array(
-        z.object({
-          /**
-           * The weight of this image's influence on the generation.
-           * - For `image`: Higher weight = closer to reference (default: 0.85)
-           * - For `style`: Higher weight = stronger style influence (default: 0.8)
-           * - For `modify_image`: Higher weight = closer to input, lower = more creative (default: 1.0)
-           */
-          weight: z.number().min(0).max(1).nullish(),
-          /**
-           * The identity name for character references.
-           * Used with `character` to specify which identity group the image belongs to.
-           * Luma supports multiple identities (e.g., 'identity0', 'identity1') for generating
-           * images with multiple consistent characters.
-           * Default: 'identity0'
-           */
-          id: z.string().nullish()
-        })
-      ).nullish(),
-      /**
-       * Override the polling interval in milliseconds (default 500).
-       */
-      pollIntervalMillis: z.number().nullish(),
-      /**
-       * Override the maximum number of polling attempts (default 120).
-       */
-      maxPollAttempts: z.number().nullish()
-    }).passthrough()
-  )
-);
-
-// src/version.ts
-var VERSION = true ? "3.0.0-beta.3" : "0.0.0-test";
-
-// src/luma-provider.ts
-var defaultBaseURL = "https://api.lumalabs.ai";
-function createLuma(options = {}) {
-  var _a;
-  const baseURL = withoutTrailingSlash((_a = options.baseURL) != null ? _a : defaultBaseURL);
-  const getHeaders = () => withUserAgentSuffix(
-    {
-      Authorization: `Bearer ${loadApiKey({
-        apiKey: options.apiKey,
-        environmentVariableName: "LUMA_API_KEY",
-        description: "Luma"
-      })}`,
-      ...options.headers
-    },
-    `ai-sdk/luma/${VERSION}`
-  );
-  const createImageModel = (modelId) => new LumaImageModel(modelId, {
-    provider: "luma.image",
-    baseURL: baseURL != null ? baseURL : defaultBaseURL,
-    headers: getHeaders,
-    fetch: options.fetch
-  });
-  const embeddingModel = (modelId) => {
-    throw new NoSuchModelError({
-      modelId,
-      modelType: "embeddingModel"
-    });
-  };
-  return {
-    specificationVersion: "v3",
-    image: createImageModel,
-    imageModel: createImageModel,
-    languageModel: (modelId) => {
-      throw new NoSuchModelError({
-        modelId,
-        modelType: "languageModel"
-      });
-    },
-    embeddingModel,
-    textEmbeddingModel: embeddingModel
-  };
-}
-var luma = createLuma();
-export {
-  VERSION,
-  createLuma,
-  luma
-};
-//# sourceMappingURL=index.mjs.map