@decartai/sdk 0.0.33 → 0.0.35

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ImageModelDefinition, ImageModels, Model, ModelDefinition, RealTimeModels, VideoModelDefinition, VideoModels, isImageModel, isRealtimeModel, isVideoModel, models } from "./shared/model.js";
-import { FileInput, ProcessOptions } from "./process/types.js";
+import { FileInput, ProcessOptions, ReactNativeFile } from "./process/types.js";
 import { ProcessClient } from "./process/client.js";
 import { JobStatus, JobStatusResponse, JobSubmitResponse, QueueJobResult, QueueSubmitAndPollOptions, QueueSubmitOptions } from "./queue/types.js";
 import { QueueClient } from "./queue/client.js";
@@ -7,30 +7,38 @@ import { DecartSDKError, ERROR_CODES } from "./utils/errors.js";
 import { AvatarOptions, RealTimeClient, RealTimeClientConnectOptions, RealTimeClientInitialState } from "./realtime/client.js";
 import { ModelState } from "./shared/types.js";
 import { CreateTokenResponse, TokensClient } from "./tokens/client.js";
-import { z } from "zod";
 
 //#region src/index.d.ts
-declare const decartClientOptionsSchema: z.ZodObject<{
-  apiKey: z.ZodOptional<z.ZodString>;
-  baseUrl: z.ZodOptional<z.ZodURL>;
-  integration: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-type DecartClientOptions = z.infer<typeof decartClientOptionsSchema>;
+type DecartClientOptions = {
+  proxy: string;
+  apiKey?: never;
+  baseUrl?: string;
+  integration?: string;
+} | {
+  proxy?: never;
+  apiKey?: string;
+  baseUrl?: string;
+  integration?: string;
+};
 /**
  * Create a Decart API client.
  *
  * @param options - Configuration options
- * @param options.apiKey - API key for authentication. Defaults to the DECART_API_KEY environment variable.
+ * @param options.proxy - URL of the proxy server. When set, the client will use the proxy instead of direct API access and apiKey is not required.
+ * @param options.apiKey - API key for authentication.
  * @param options.baseUrl - Override the default API base URL.
  * @param options.integration - Optional integration identifier.
  *
  * @example
  * ```ts
- * // Option 1: Explicit API key
+ * //  (direct API access)Option 1: Explicit API key
  * const client = createDecartClient({ apiKey: "your-api-key" });
  *
  * // Option 2: Using DECART_API_KEY environment variable
  * const client = createDecartClient();
+ *
+ * // Option 3: Using proxy (client-side, no API key needed)
+ * const client = createDecartClient({ proxy: "https://your-server.com/api/decart" });
  * ```
  */
 declare const createDecartClient: (options?: DecartClientOptions) => {
@@ -109,4 +117,4 @@ declare const createDecartClient: (options?: DecartClientOptions) => {
   tokens: TokensClient;
 };
 //#endregion
-export { type AvatarOptions, type CreateTokenResponse, DecartClientOptions, type DecartSDKError, ERROR_CODES, type FileInput, type ImageModelDefinition, type ImageModels, type JobStatus, type JobStatusResponse, type JobSubmitResponse, type Model, type ModelDefinition, type ModelState, type ProcessClient, type ProcessOptions, type QueueClient, type QueueJobResult, type QueueSubmitAndPollOptions, type QueueSubmitOptions, type RealTimeClient, type RealTimeClientConnectOptions, type RealTimeClientInitialState, type RealTimeModels, type TokensClient, type VideoModelDefinition, type VideoModels, createDecartClient, isImageModel, isRealtimeModel, isVideoModel, models };
+export { type AvatarOptions, type CreateTokenResponse, DecartClientOptions, type DecartSDKError, ERROR_CODES, type FileInput, type ImageModelDefinition, type ImageModels, type JobStatus, type JobStatusResponse, type JobSubmitResponse, type Model, type ModelDefinition, type ModelState, type ProcessClient, type ProcessOptions, type QueueClient, type QueueJobResult, type QueueSubmitAndPollOptions, type QueueSubmitOptions, type ReactNativeFile, type RealTimeClient, type RealTimeClientConnectOptions, type RealTimeClientInitialState, type RealTimeModels, type TokensClient, type VideoModelDefinition, type VideoModels, createDecartClient, isImageModel, isRealtimeModel, isVideoModel, models };

package/dist/index.js

@@ -8,59 +8,73 @@ import { readEnv } from "./utils/env.js";
 import { z } from "zod";
 
 //#region src/index.ts
+const proxySchema = z.union([z.string().url(), z.string().startsWith("/")]);
 const decartClientOptionsSchema = z.object({
 	apiKey: z.string().min(1).optional(),
 	baseUrl: z.url().optional(),
+	proxy: proxySchema.optional(),
 	integration: z.string().optional()
-});
+}).refine((data) => {
+	const hasProxy = !!data.proxy;
+	const hasApiKey = !!data.apiKey;
+	return !(hasProxy && hasApiKey);
+}, { message: "Cannot provide both 'proxy' and 'apiKey'. Use 'proxy' for proxy mode or 'apiKey' for direct API access." });
 /**
 * Create a Decart API client.
 *
 * @param options - Configuration options
-* @param options.apiKey - API key for authentication. Defaults to the DECART_API_KEY environment variable.
+* @param options.proxy - URL of the proxy server. When set, the client will use the proxy instead of direct API access and apiKey is not required.
+* @param options.apiKey - API key for authentication.
 * @param options.baseUrl - Override the default API base URL.
 * @param options.integration - Optional integration identifier.
 *
 * @example
 * ```ts
-* // Option 1: Explicit API key
+* //  (direct API access)Option 1: Explicit API key
 * const client = createDecartClient({ apiKey: "your-api-key" });
 *
 * // Option 2: Using DECART_API_KEY environment variable
 * const client = createDecartClient();
+*
+* // Option 3: Using proxy (client-side, no API key needed)
+* const client = createDecartClient({ proxy: "https://your-server.com/api/decart" });
 * ```
 */
 const createDecartClient = (options = {}) => {
-	const apiKey = options.apiKey ?? readEnv("DECART_API_KEY");
-	if (!apiKey) throw createInvalidApiKeyError();
-	const parsedOptions = decartClientOptionsSchema.safeParse({
-		...options,
-		apiKey
-	});
+	const parsedOptions = decartClientOptionsSchema.safeParse(options);
 	if (!parsedOptions.success) {
-		if (parsedOptions.error.issues[0].path.includes("baseUrl")) throw createInvalidBaseUrlError(options.baseUrl);
+		const issue = parsedOptions.error.issues[0];
+		if (issue.path.includes("apiKey")) throw createInvalidApiKeyError();
+		if (issue.path.includes("baseUrl")) throw createInvalidBaseUrlError(issue.path.includes("baseUrl") ? options.baseUrl : void 0);
+		if (issue.path.includes("proxy")) throw createInvalidBaseUrlError(issue.path.includes("proxy") ? options.proxy : void 0);
 		throw parsedOptions.error;
 	}
-	const { baseUrl = "https://api.decart.ai", integration } = parsedOptions.data;
+	const isProxyMode = "proxy" in parsedOptions.data && !!parsedOptions.data.proxy;
+	const apiKey = isProxyMode ? void 0 : ("apiKey" in parsedOptions.data ? parsedOptions.data.apiKey : void 0) ?? readEnv("DECART_API_KEY");
+	if (!isProxyMode && !apiKey) throw createInvalidApiKeyError();
+	let baseUrl;
+	if (isProxyMode && "proxy" in parsedOptions.data && parsedOptions.data.proxy) baseUrl = parsedOptions.data.proxy;
+	else baseUrl = parsedOptions.data.baseUrl || "https://api.decart.ai";
+	const { integration } = parsedOptions.data;
 	return {
 		realtime: createRealTimeClient({
 			baseUrl: "wss://api3.decart.ai",
-			apiKey,
+			apiKey: apiKey || "",
 			integration
 		}),
 		process: createProcessClient({
 			baseUrl,
-			apiKey,
+			apiKey: apiKey || "",
 			integration
 		}),
 		queue: createQueueClient({
 			baseUrl,
-			apiKey,
+			apiKey: apiKey || "",
 			integration
 		}),
 		tokens: createTokensClient({
 			baseUrl,
-			apiKey,
+			apiKey: apiKey || "",
 			integration
 		})
 	};

package/dist/process/request.js

@@ -5,9 +5,13 @@ import { buildAuthHeaders, buildFormData } from "../shared/request.js";
 async function sendRequest({ baseUrl, apiKey, model, inputs, signal, integration }) {
 	const formData = buildFormData(inputs);
 	const endpoint = `${baseUrl}${model.urlPath}`;
+	const headers = buildAuthHeaders({
+		apiKey,
+		integration
+	});
 	const response = await fetch(endpoint, {
 		method: "POST",
-		headers: buildAuthHeaders(apiKey, integration),
+		headers,
 		body: formData,
 		signal
 	});

package/dist/process/types.d.ts

@@ -2,7 +2,17 @@ import { ImageModelDefinition, ImageModels, ModelDefinition, ModelInputSchemas,
 import { z } from "zod";
 
 //#region src/process/types.d.ts
-type FileInput = File | Blob | ReadableStream | URL | string;
+
+/**
+ * React Native file object format for file uploads.
+ * This format is used by React Native's FormData to properly handle file uploads with MIME types.
+ */
+interface ReactNativeFile {
+  uri: string;
+  type: string;
+  name: string;
+}
+type FileInput = File | Blob | ReadableStream | URL | string | ReactNativeFile;
 type InferModelInputs<T extends ModelDefinition> = T["name"] extends keyof ModelInputSchemas ? z.input<ModelInputSchemas[T["name"]]> : Record<string, never>;
 /**
  * Model-specific input documentation for image generation models.
@@ -49,6 +59,27 @@ interface VideoModelInputs {
    */
   data?: FileInput;
 }
+/**
+ * Model-specific input documentation for lucy-pro-v2v.
+ */
+interface VideoEditInputs {
+  /**
+   * Text description to use for the video editing.
+   *
+   * See our [Prompt Engineering](https://docs.platform.decart.ai/models/video/video-generation#prompt-engineering) guide for how to write prompt for Decart video models effectively.
+   */
+  prompt: string;
+  /**
+   * Video file to process.
+   * Can be a File, Blob, ReadableStream, URL, or string URL.
+   */
+  data: FileInput;
+  /**
+   * Optional reference image to guide what to add to the video.
+   * Can be a File, Blob, ReadableStream, URL, or string URL.
+   */
+  reference_image?: FileInput;
+}
 /**
  * Model-specific input documentation for lucy-restyle-v2v.
  * Allows either prompt or reference_image (mutually exclusive).
@@ -85,7 +116,7 @@ interface PromptInput {
  * This allows different models to have field-specific documentation while maintaining type safety.
  * Specific models are checked first, then falls back to category-based selection.
  */
-type ModelSpecificInputs<T extends ModelDefinition> = T["name"] extends "lucy-pro-i2i" ? ImageEditingInputs : T["name"] extends "lucy-restyle-v2v" ? VideoRestyleInputs : T["name"] extends ImageModels ? ImageGenerationInputs : T["name"] extends VideoModels ? VideoModelInputs : PromptInput;
+type ModelSpecificInputs<T extends ModelDefinition> = T["name"] extends "lucy-pro-i2i" ? ImageEditingInputs : T["name"] extends "lucy-restyle-v2v" ? VideoRestyleInputs : T["name"] extends "lucy-pro-v2v" ? VideoEditInputs : T["name"] extends ImageModels ? ImageGenerationInputs : T["name"] extends VideoModels ? VideoModelInputs : PromptInput;
 interface ProcessInputs {
   /**
    * Random seed for reproducible results.
@@ -172,4 +203,4 @@ type ProcessOptions<T extends ImageModelDefinition = ImageModelDefinition> = {
   signal?: AbortSignal;
 } & MergeDocumentedInputs<T>;
 //#endregion
-export { FileInput, InferModelInputs, ModelSpecificInputs, ProcessInputs, ProcessOptions };
+export { FileInput, InferModelInputs, ModelSpecificInputs, ProcessInputs, ProcessOptions, ReactNativeFile };

package/dist/queue/request.js

@@ -10,9 +10,13 @@ async function submitJob({ baseUrl, apiKey, model, inputs, signal, integration }
 	const formData = buildFormData(inputs);
 	if (!model.queueUrlPath) throw createQueueSubmitError(`Model ${model.name} does not support queue processing`, 400);
 	const endpoint = `${baseUrl}${model.queueUrlPath}`;
+	const headers = buildAuthHeaders({
+		apiKey,
+		integration
+	});
 	const response = await fetch(endpoint, {
 		method: "POST",
-		headers: buildAuthHeaders(apiKey, integration),
+		headers,
 		body: formData,
 		signal
 	});
@@ -28,9 +32,13 @@ async function submitJob({ baseUrl, apiKey, model, inputs, signal, integration }
 */
 async function getJobStatus({ baseUrl, apiKey, jobId, signal, integration }) {
 	const endpoint = `${baseUrl}/v1/jobs/${jobId}`;
+	const headers = buildAuthHeaders({
+		apiKey,
+		integration
+	});
 	const response = await fetch(endpoint, {
 		method: "GET",
-		headers: buildAuthHeaders(apiKey, integration),
+		headers,
 		signal
 	});
 	if (!response.ok) {
@@ -45,9 +53,13 @@ async function getJobStatus({ baseUrl, apiKey, jobId, signal, integration }) {
 */
 async function getJobContent({ baseUrl, apiKey, jobId, signal, integration }) {
 	const endpoint = `${baseUrl}/v1/jobs/${jobId}/content`;
+	const headers = buildAuthHeaders({
+		apiKey,
+		integration
+	});
 	const response = await fetch(endpoint, {
 		method: "GET",
-		headers: buildAuthHeaders(apiKey, integration),
+		headers,
 		signal
 	});
 	if (!response.ok) {

package/dist/shared/model.d.ts

@@ -33,7 +33,11 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-pro-i2v": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
     seed: z.ZodOptional<z.ZodNumber>;
     resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
       "720p": "720p";
@@ -42,13 +46,26 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-dev-i2v": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
     seed: z.ZodOptional<z.ZodNumber>;
     resolution: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"720p">>>;
   }, z.core.$strip>;
   readonly "lucy-pro-v2v": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>>;
     seed: z.ZodOptional<z.ZodNumber>;
     resolution: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"720p">>>;
     enhance_prompt: z.ZodOptional<z.ZodBoolean>;
@@ -56,15 +73,27 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-fast-v2v": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
     seed: z.ZodOptional<z.ZodNumber>;
     resolution: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"720p">>>;
     enhance_prompt: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>;
   readonly "lucy-pro-flf2v": z.ZodObject<{
     prompt: z.ZodString;
-    start: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
-    end: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    start: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
+    end: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
     seed: z.ZodOptional<z.ZodNumber>;
     resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
       "720p": "720p";
@@ -73,7 +102,11 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-pro-i2i": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
     seed: z.ZodOptional<z.ZodNumber>;
     resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
       "720p": "720p";
@@ -82,7 +115,11 @@ declare const modelInputSchemas: {
     enhance_prompt: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>;
   readonly "lucy-motion": z.ZodObject<{
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
     trajectory: z.ZodArray<z.ZodObject<{
       frame: z.ZodNumber;
       x: z.ZodNumber;
@@ -93,8 +130,16 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-restyle-v2v": z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>>;
+    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+      uri: z.ZodString;
+      type: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>]>;
     seed: z.ZodOptional<z.ZodNumber>;
     resolution: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"720p">>>;
     enhance_prompt: z.ZodOptional<z.ZodBoolean>;

package/dist/shared/model.js

@@ -38,7 +38,12 @@ const fileInputSchema = z.union([
 	z.instanceof(Blob),
 	z.instanceof(ReadableStream),
 	z.instanceof(URL),
-	z.url()
+	z.url(),
+	z.object({
+		uri: z.string(),
+		type: z.string(),
+		name: z.string()
+	})
 ]);
 /**
 * Resolution schema for dev models. Supports only 720p.
@@ -87,6 +92,7 @@ const modelInputSchemas = {
 	"lucy-pro-v2v": z.object({
 		prompt: z.string().min(1).max(1e3).describe("The prompt to use for the generation"),
 		data: fileInputSchema.describe("The video data to use for generation (File, Blob, ReadableStream, URL, or string URL). Output video is limited to 5 seconds."),
+		reference_image: fileInputSchema.optional().describe("Optional reference image to guide what to add to the video (File, Blob, ReadableStream, URL, or string URL)"),
 		seed: z.number().optional().describe("The seed to use for the generation"),
 		resolution: proV2vResolutionSchema,
 		enhance_prompt: z.boolean().optional().describe("Whether to enhance the prompt"),

package/dist/shared/request.js

@@ -3,9 +3,17 @@ import { buildUserAgent } from "../utils/user-agent.js";
 
 //#region src/shared/request.ts
 /**
-* Convert various file input types to a Blob.
+* Type guard to check if a value is a React Native file object.
+*/
+function isReactNativeFile(value) {
+	return typeof value === "object" && value !== null && typeof value.uri === "string" && typeof value.type === "string" && typeof value.name === "string";
+}
+/**
+* Convert various file input types to a Blob or React Native file object.
+* React Native file objects are passed through as-is for proper FormData handling.
 */
 async function fileInputToBlob(input) {
+	if (isReactNativeFile(input)) return input;
 	if (input instanceof Blob || input instanceof File) return input;
 	if (input instanceof ReadableStream) return new Response(input).blob();
 	if (typeof input === "string" || input instanceof URL) {
@@ -20,10 +28,11 @@ async function fileInputToBlob(input) {
 /**
 * Build common headers for API requests.
 */
-function buildAuthHeaders(apiKey, integration) {
+function buildAuthHeaders(options = {}) {
+	const { apiKey, integration } = options;
 	return {
-		"X-API-KEY": apiKey,
-		"User-Agent": buildUserAgent(integration)
+		"User-Agent": buildUserAgent(integration),
+		...apiKey ? { "X-API-KEY": apiKey } : {}
 	};
 }
 /**
@@ -31,7 +40,8 @@ function buildAuthHeaders(apiKey, integration) {
 */
 function buildFormData(inputs) {
 	const formData = new FormData();
-	for (const [key, value] of Object.entries(inputs)) if (value !== void 0 && value !== null) if (value instanceof Blob) formData.append(key, value);
+	for (const [key, value] of Object.entries(inputs)) if (value !== void 0 && value !== null) if (isReactNativeFile(value)) formData.append(key, value);
+	else if (value instanceof Blob) formData.append(key, value);
 	else if (typeof value === "object" && value !== null) formData.append(key, JSON.stringify(value));
 	else formData.append(key, String(value));
 	return formData;

package/dist/tokens/client.js

@@ -5,9 +5,13 @@ import { buildAuthHeaders } from "../shared/request.js";
 const createTokensClient = (opts) => {
 	const { baseUrl, apiKey, integration } = opts;
 	const create = async () => {
+		const headers = buildAuthHeaders({
+			apiKey,
+			integration
+		});
 		const response = await fetch(`${baseUrl}/v1/client/tokens`, {
 			method: "POST",
-			headers: buildAuthHeaders(apiKey, integration)
+			headers
 		});
 		if (!response.ok) {
 			const errorText = await response.text().catch(() => "Unknown error");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decartai/sdk",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "description": "Decart's JavaScript SDK",
   "type": "module",
   "license": "MIT",