@runapi.ai/flux-2 0.2.4 → 0.2.6

package/README.md

@@ -1,32 +1,44 @@
 # Flux API JavaScript SDK for RunAPI
 
-The flux api JavaScript SDK is the language-specific package for Flux 2 on RunAPI. Use this flux api package for text-to-image, image-to-image, edit, and creative production flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+The flux api JavaScript SDK is the language-specific package for Flux 2 on RunAPI. Use this flux api package for text-to-image, remix-image, and creative production flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
 
-This flux api README is the JavaScript package guide inside the public `flux2-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/flux-2; for API reference, use https://runapi.ai/docs#flux-2; for SDK docs, use https://runapi.ai/docs#sdk-flux-2.
+This flux api README is the JavaScript package guide inside the public `flux-2-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/flux-2; for API reference, use https://runapi.ai/docs#flux-2; for SDK docs, use https://runapi.ai/docs#sdk-flux-2.
 
 ## Install
 
 ```bash
-npm install @runapi.ai/flux2
+npm install @runapi.ai/flux-2
 ```
 
 ## Quick start
 
 ```typescript
-import { Flux2Client } from '@runapi.ai/flux2';
+import { Flux2Client } from '@runapi.ai/flux-2';
 
 const client = new Flux2Client();
-const task = await client.generations.create({
-  // Pass the Flux 2 JSON request body from https://runapi.ai/docs#flux-2.
+
+const task = await client.textToImage.create({
+  model: 'flux-2-pro-text-to-image',
+  prompt: 'A cinematic product photo on warm paper',
+  aspect_ratio: '1:1',
+});
+const status = await client.textToImage.get(task.id);
+
+const remix = await client.remixImage.create({
+  model: 'flux-2-pro-remix-image',
+  prompt: 'Turn this product shot into a warm editorial photo',
+  source_image_urls: ['https://example.com/source.jpg'],
+  aspect_ratio: 'auto',
 });
-const status = await client.generations.get(task.id);
 ```
 
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## Language notes
 
-Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building image applications. The available resources include generations. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building image applications. The available resources include `textToImage` and `remixImage`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 
@@ -36,7 +48,7 @@ Use the TypeScript types in `src/types.ts` and the resource classes under `src/r
 - Pricing and rate limits: https://runapi.ai/models/flux-2/pro-text-to-image
 - Provider comparison: https://runapi.ai/providers/black-forest-labs
 - Full catalog: https://runapi.ai/models
-- Repository: https://github.com/runapi-ai/flux2-sdk
+- Repository: https://github.com/runapi-ai/flux-2-sdk
 
 ## License
 

package/dist/index.d.mts

@@ -1,34 +1,63 @@
-import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, ClientOptions } from '@runapi.ai/core';
+import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, BaseClient, ClientOptions } from '@runapi.ai/core';
 export { AuthenticationError, InsufficientCreditsError, NetworkError, NotFoundError, RateLimitError, RunApiError, ServiceUnavailableError, TaskFailedError, TaskTimeoutError, TimeoutError, ValidationError } from '@runapi.ai/core';
 
-type Flux2Model = 'flux-2-pro-text-to-image' | 'flux-2-pro-image-to-image' | 'flux-2-flex-text-to-image' | 'flux-2-flex-image-to-image';
+/**
+ * All Flux 2 model slugs. Each operation has pro (higher fidelity) and
+ * flex (faster, lower cost) tiers.
+ */
+type Flux2Model = 'flux-2-pro-text-to-image' | 'flux-2-pro-remix-image' | 'flux-2-flex-text-to-image' | 'flux-2-flex-remix-image';
+/** Output aspect ratio for text-to-image generation. */
 type AspectRatio = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '3:2' | '2:3';
-type AspectRatioI2I = AspectRatio | 'auto';
-type Resolution = '1K' | '2K';
+/** Aspect ratios for remix, including 'auto' to preserve the source image ratio. */
+type RemixAspectRatio = AspectRatio | 'auto';
+/** Output resolution tier for Flux 2 generation (max 2k). */
+type OutputResolution = '1k' | '2k';
+/** Parameters for Flux 2 text-to-image generation (pro or flex tier). */
 interface GenerationT2IParams {
     model: 'flux-2-pro-text-to-image' | 'flux-2-flex-text-to-image';
+    /** Text description of desired image, 3-5000 characters. */
     prompt: string;
+    /** URL for completion callback notifications. */
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
+    /** Default: 1k. */
+    output_resolution?: OutputResolution;
+    /** Content safety check toggle. */
+    enable_safety_checker?: boolean;
+    /** Default: 1:1. */
     aspect_ratio?: AspectRatio;
 }
-interface GenerationI2IParams {
-    model: 'flux-2-pro-image-to-image' | 'flux-2-flex-image-to-image';
+/**
+ * Parameters for Flux 2 image remix (pro or flex tier).
+ * Transforms source images guided by a text prompt.
+ */
+interface RemixImageParams {
+    model: 'flux-2-pro-remix-image' | 'flux-2-flex-remix-image';
+    /** Text description guiding the transformation, 3-5000 characters. */
     prompt: string;
-    input_urls: string[];
+    /** Source image URLs to remix (1-8). */
+    source_image_urls: string[];
+    /** URL for completion callback notifications. */
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
-    aspect_ratio?: AspectRatioI2I;
+    /** Default: 1k. */
+    output_resolution?: OutputResolution;
+    /** Content safety check toggle. */
+    enable_safety_checker?: boolean;
+    /** 'auto' preserves the source image aspect ratio. */
+    aspect_ratio?: RemixAspectRatio;
 }
-type TextToImageParams = GenerationT2IParams | GenerationI2IParams;
+type TextToImageParams = GenerationT2IParams;
+/** Acknowledged task with its server-assigned ID. */
 interface TaskCreateResponse {
     id: string;
 }
+/** A single generated image with its CDN URL. */
 interface Image {
     url: string;
 }
+/**
+ * Generation result for a Flux 2 task.
+ * `images` is populated once `status` reaches `'completed'`.
+ */
 interface TextToImageResponse {
     id: string;
     status: AsyncTaskStatus;
@@ -45,17 +74,69 @@ type CompletedTextToImageResponse = TextToImageResponse & {
     status: 'completed';
     images: Image[];
 };
+/** Remix response -- same shape as generation. */
+type RemixImageResponse = TextToImageResponse;
+type CompletedRemixImageResponse = CompletedTextToImageResponse;
 
+/** Flux 2 text-to-image generation resource. */
 declare class TextToImage {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Generate an image and wait until complete.
+     * @param params Text-to-image parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text-to-image result.
+     */
     run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToImageResponse>;
+    /**
+     * Create a text-to-image task; returns immediately with a task id.
+     * @param params Text-to-image parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
     create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of a text-to-image task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current text-to-image status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToImageResponse>;
 }
 
+/** Flux 2 image remix: transform source images with text-guided prompts. */
+declare class RemixImage {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Remix an image and wait until complete.
+     * @param params Image remix parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed remix result with images.
+     */
+    run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedRemixImageResponse>;
+    /**
+     * Create an image remix task; returns immediately with a task id.
+     * @param params Image remix parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
+    create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an image remix task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current remix status.
+     */
+    get(id: string, options?: RequestOptions): Promise<RemixImageResponse>;
+}
+
 /**
- * Flux 2 text-to-image API client.
+ * Flux 2 text-to-image and remix API client.
+ *
+ * Pro and flex tiers for both text-to-image generation and
+ * text-guided image remixing from source images.
  *
  * @example
  * ```typescript
@@ -70,10 +151,12 @@ declare class TextToImage {
  * });
  * ```
  */
-declare class Flux2Client {
-    /** Text-to-image operations. */
+declare class Flux2Client extends BaseClient {
+    /** Text-to-image generation. */
     readonly textToImage: TextToImage;
+    /** Transform source images with text-guided prompts. */
+    readonly remixImage: RemixImage;
     constructor(options?: ClientOptions);
 }
 
-export { type AspectRatio, type AspectRatioI2I, type CompletedTextToImageResponse, Flux2Client, type Flux2Model, type GenerationI2IParams, type GenerationT2IParams, type Image, type Resolution, type TaskCreateResponse, type TextToImageParams, type TextToImageResponse };
+export { type AspectRatio, type CompletedRemixImageResponse, type CompletedTextToImageResponse, Flux2Client, type Flux2Model, type GenerationT2IParams, type Image, type OutputResolution, type RemixAspectRatio, type RemixImageParams, type RemixImageResponse, type TaskCreateResponse, type TextToImageParams, type TextToImageResponse };

package/dist/index.d.ts

@@ -1,34 +1,63 @@
-import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, ClientOptions } from '@runapi.ai/core';
+import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, BaseClient, ClientOptions } from '@runapi.ai/core';
 export { AuthenticationError, InsufficientCreditsError, NetworkError, NotFoundError, RateLimitError, RunApiError, ServiceUnavailableError, TaskFailedError, TaskTimeoutError, TimeoutError, ValidationError } from '@runapi.ai/core';
 
-type Flux2Model = 'flux-2-pro-text-to-image' | 'flux-2-pro-image-to-image' | 'flux-2-flex-text-to-image' | 'flux-2-flex-image-to-image';
+/**
+ * All Flux 2 model slugs. Each operation has pro (higher fidelity) and
+ * flex (faster, lower cost) tiers.
+ */
+type Flux2Model = 'flux-2-pro-text-to-image' | 'flux-2-pro-remix-image' | 'flux-2-flex-text-to-image' | 'flux-2-flex-remix-image';
+/** Output aspect ratio for text-to-image generation. */
 type AspectRatio = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '3:2' | '2:3';
-type AspectRatioI2I = AspectRatio | 'auto';
-type Resolution = '1K' | '2K';
+/** Aspect ratios for remix, including 'auto' to preserve the source image ratio. */
+type RemixAspectRatio = AspectRatio | 'auto';
+/** Output resolution tier for Flux 2 generation (max 2k). */
+type OutputResolution = '1k' | '2k';
+/** Parameters for Flux 2 text-to-image generation (pro or flex tier). */
 interface GenerationT2IParams {
     model: 'flux-2-pro-text-to-image' | 'flux-2-flex-text-to-image';
+    /** Text description of desired image, 3-5000 characters. */
     prompt: string;
+    /** URL for completion callback notifications. */
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
+    /** Default: 1k. */
+    output_resolution?: OutputResolution;
+    /** Content safety check toggle. */
+    enable_safety_checker?: boolean;
+    /** Default: 1:1. */
     aspect_ratio?: AspectRatio;
 }
-interface GenerationI2IParams {
-    model: 'flux-2-pro-image-to-image' | 'flux-2-flex-image-to-image';
+/**
+ * Parameters for Flux 2 image remix (pro or flex tier).
+ * Transforms source images guided by a text prompt.
+ */
+interface RemixImageParams {
+    model: 'flux-2-pro-remix-image' | 'flux-2-flex-remix-image';
+    /** Text description guiding the transformation, 3-5000 characters. */
     prompt: string;
-    input_urls: string[];
+    /** Source image URLs to remix (1-8). */
+    source_image_urls: string[];
+    /** URL for completion callback notifications. */
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
-    aspect_ratio?: AspectRatioI2I;
+    /** Default: 1k. */
+    output_resolution?: OutputResolution;
+    /** Content safety check toggle. */
+    enable_safety_checker?: boolean;
+    /** 'auto' preserves the source image aspect ratio. */
+    aspect_ratio?: RemixAspectRatio;
 }
-type TextToImageParams = GenerationT2IParams | GenerationI2IParams;
+type TextToImageParams = GenerationT2IParams;
+/** Acknowledged task with its server-assigned ID. */
 interface TaskCreateResponse {
     id: string;
 }
+/** A single generated image with its CDN URL. */
 interface Image {
     url: string;
 }
+/**
+ * Generation result for a Flux 2 task.
+ * `images` is populated once `status` reaches `'completed'`.
+ */
 interface TextToImageResponse {
     id: string;
     status: AsyncTaskStatus;
@@ -45,17 +74,69 @@ type CompletedTextToImageResponse = TextToImageResponse & {
     status: 'completed';
     images: Image[];
 };
+/** Remix response -- same shape as generation. */
+type RemixImageResponse = TextToImageResponse;
+type CompletedRemixImageResponse = CompletedTextToImageResponse;
 
+/** Flux 2 text-to-image generation resource. */
 declare class TextToImage {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Generate an image and wait until complete.
+     * @param params Text-to-image parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text-to-image result.
+     */
     run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToImageResponse>;
+    /**
+     * Create a text-to-image task; returns immediately with a task id.
+     * @param params Text-to-image parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
     create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of a text-to-image task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current text-to-image status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToImageResponse>;
 }
 
+/** Flux 2 image remix: transform source images with text-guided prompts. */
+declare class RemixImage {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Remix an image and wait until complete.
+     * @param params Image remix parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed remix result with images.
+     */
+    run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedRemixImageResponse>;
+    /**
+     * Create an image remix task; returns immediately with a task id.
+     * @param params Image remix parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
+    create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an image remix task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current remix status.
+     */
+    get(id: string, options?: RequestOptions): Promise<RemixImageResponse>;
+}
+
 /**
- * Flux 2 text-to-image API client.
+ * Flux 2 text-to-image and remix API client.
+ *
+ * Pro and flex tiers for both text-to-image generation and
+ * text-guided image remixing from source images.
  *
  * @example
  * ```typescript
@@ -70,10 +151,12 @@ declare class TextToImage {
  * });
  * ```
  */
-declare class Flux2Client {
-    /** Text-to-image operations. */
+declare class Flux2Client extends BaseClient {
+    /** Text-to-image generation. */
     readonly textToImage: TextToImage;
+    /** Transform source images with text-guided prompts. */
+    readonly remixImage: RemixImage;
     constructor(options?: ClientOptions);
 }
 
-export { type AspectRatio, type AspectRatioI2I, type CompletedTextToImageResponse, Flux2Client, type Flux2Model, type GenerationI2IParams, type GenerationT2IParams, type Image, type Resolution, type TaskCreateResponse, type TextToImageParams, type TextToImageResponse };
+export { type AspectRatio, type CompletedRemixImageResponse, type CompletedTextToImageResponse, Flux2Client, type Flux2Model, type GenerationT2IParams, type Image, type OutputResolution, type RemixAspectRatio, type RemixImageParams, type RemixImageResponse, type TaskCreateResponse, type TextToImageParams, type TextToImageResponse };

package/dist/index.js

@@ -20,23 +20,23 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  AuthenticationError: () => import_core3.AuthenticationError,
+  AuthenticationError: () => import_core4.AuthenticationError,
   Flux2Client: () => Flux2Client,
-  InsufficientCreditsError: () => import_core3.InsufficientCreditsError,
-  NetworkError: () => import_core3.NetworkError,
-  NotFoundError: () => import_core3.NotFoundError,
-  RateLimitError: () => import_core3.RateLimitError,
-  RunApiError: () => import_core3.RunApiError,
-  ServiceUnavailableError: () => import_core3.ServiceUnavailableError,
-  TaskFailedError: () => import_core3.TaskFailedError,
-  TaskTimeoutError: () => import_core3.TaskTimeoutError,
-  TimeoutError: () => import_core3.TimeoutError,
-  ValidationError: () => import_core3.ValidationError
+  InsufficientCreditsError: () => import_core4.InsufficientCreditsError,
+  NetworkError: () => import_core4.NetworkError,
+  NotFoundError: () => import_core4.NotFoundError,
+  RateLimitError: () => import_core4.RateLimitError,
+  RunApiError: () => import_core4.RunApiError,
+  ServiceUnavailableError: () => import_core4.ServiceUnavailableError,
+  TaskFailedError: () => import_core4.TaskFailedError,
+  TaskTimeoutError: () => import_core4.TaskTimeoutError,
+  TimeoutError: () => import_core4.TimeoutError,
+  ValidationError: () => import_core4.ValidationError
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var import_core2 = require("@runapi.ai/core");
+var import_core3 = require("@runapi.ai/core");
 
 // src/resources/text-to-image.ts
 var import_core = require("@runapi.ai/core");
@@ -47,6 +47,12 @@ var TextToImage = class {
     this.http = http;
   }
   http;
+  /**
+   * Generate an image and wait until complete.
+   * @param params Text-to-image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text-to-image result.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await (0, import_internal.pollUntilComplete)(() => this.get(id, options), {
@@ -55,12 +61,24 @@ var TextToImage = class {
     });
     return response;
   }
+  /**
+   * Create a text-to-image task; returns immediately with a task id.
+   * @param params Text-to-image parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
     return this.http.request("POST", ENDPOINT, {
       body: (0, import_core.compactParams)(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text-to-image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text-to-image status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -68,18 +86,69 @@ var TextToImage = class {
   }
 };
 
+// src/resources/remix-image.ts
+var import_core2 = require("@runapi.ai/core");
+var import_internal2 = require("@runapi.ai/core/internal");
+var ENDPOINT2 = "/api/v1/flux_2/remix_image";
+var RemixImage = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Remix an image and wait until complete.
+   * @param params Image remix parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed remix result with images.
+   */
+  async run(params, options) {
+    const { id } = await this.create(params, options);
+    const response = await (0, import_internal2.pollUntilComplete)(() => this.get(id, options), {
+      maxWaitMs: options?.maxWaitMs,
+      pollIntervalMs: options?.pollIntervalMs
+    });
+    return response;
+  }
+  /**
+   * Create an image remix task; returns immediately with a task id.
+   * @param params Image remix parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
+  async create(params, options) {
+    return this.http.request("POST", ENDPOINT2, {
+      body: (0, import_core2.compactParams)(params),
+      ...options
+    });
+  }
+  /**
+   * Fetch the current status of an image remix task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current remix status.
+   */
+  async get(id, options) {
+    return this.http.request("GET", `${ENDPOINT2}/${id}`, {
+      ...options
+    });
+  }
+};
+
 // src/client.ts
-var Flux2Client = class {
-  /** Text-to-image operations. */
+var Flux2Client = class extends import_core3.BaseClient {
+  /** Text-to-image generation. */
   textToImage;
+  /** Transform source images with text-guided prompts. */
+  remixImage;
   constructor(options = {}) {
-    const http = (0, import_core2.createHttpClient)(options);
-    this.textToImage = new TextToImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
+    this.remixImage = new RemixImage(this.http);
   }
 };
 
 // src/index.ts
-var import_core3 = require("@runapi.ai/core");
+var import_core4 = require("@runapi.ai/core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-image.ts"],"sourcesContent":["export { Flux2Client } from './client';\nexport * from './types';\n\n// Re-export core errors for convenience\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n  TaskTimeoutError,\n  TaskFailedError,\n} from '@runapi.ai/core';\n","import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\n\n/**\n * Flux 2 text-to-image API client.\n *\n * @example\n * ```typescript\n * const client = new Flux2Client({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToImage.run({\n *   model: 'flux-2-pro-text-to-image',\n *   prompt: 'A futuristic cityscape at night',\n * });\n * ```\n */\nexport class Flux2Client {\n  /** Text-to-image operations. */\n  public readonly textToImage: TextToImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToImageResponse,\n  TextToImageParams,\n  TextToImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/flux_2/text_to_image';\n\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToImageResponse;\n  }\n\n  async create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,eAAqD;;;ACCrD,kBAA8B;AAC9B,sBAAkC;AAQlC,IAAM,WAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,UAAM,mCAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQ,UAAU;AAAA,MAC7D,UAAM,2BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAG,QAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ADjBO,IAAM,cAAN,MAAkB;AAAA;AAAA,EAEP;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,WAAO,+BAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;ADvBA,IAAAC,eAYO;","names":["import_core","import_core"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-image.ts","../src/resources/remix-image.ts"],"sourcesContent":["export { Flux2Client } from './client';\nexport * from './types';\n\n// Re-export core errors for convenience\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n  TaskTimeoutError,\n  TaskFailedError,\n} from '@runapi.ai/core';\n","import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\nimport { RemixImage } from './resources/remix-image';\n\n/**\n * Flux 2 text-to-image and remix API client.\n *\n * Pro and flex tiers for both text-to-image generation and\n * text-guided image remixing from source images.\n *\n * @example\n * ```typescript\n * const client = new Flux2Client({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToImage.run({\n *   model: 'flux-2-pro-text-to-image',\n *   prompt: 'A futuristic cityscape at night',\n * });\n * ```\n */\nexport class Flux2Client extends BaseClient {\n  /** Text-to-image generation. */\n  public readonly textToImage: TextToImage;\n  /** Transform source images with text-guided prompts. */\n  public readonly remixImage: RemixImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n    this.remixImage = new RemixImage(this.http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToImageResponse,\n  TextToImageParams,\n  TextToImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/flux_2/text_to_image';\n\n/** Flux 2 text-to-image generation resource. */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate an image and wait until complete.\n   * @param params Text-to-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed text-to-image result.\n   */\n  async run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToImageResponse;\n  }\n\n  /**\n   * Create a text-to-image task; returns immediately with a task id.\n   * @param params Text-to-image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text-to-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text-to-image status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedRemixImageResponse,\n  RemixImageParams,\n  RemixImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/flux_2/remix_image';\n\n/** Flux 2 image remix: transform source images with text-guided prompts. */\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Remix an image and wait until complete.\n   * @param params Image remix parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed remix result with images.\n   */\n  async run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedRemixImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<RemixImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedRemixImageResponse;\n  }\n\n  /**\n   * Create an image remix task; returns immediately with a task id.\n   * @param params Image remix parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of an image remix task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current remix status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<RemixImageResponse> {\n    return this.http.request<RemixImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,eAA+C;;;ACC/C,kBAA8B;AAC9B,sBAAkC;AAQlC,IAAM,WAAW;AAGV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,UAAM,mCAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQ,UAAU;AAAA,MAC7D,UAAM,2BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAG,QAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACtDA,IAAAC,eAA8B;AAC9B,IAAAC,mBAAkC;AAQlC,IAAMC,YAAW;AAGV,IAAM,aAAN,MAAiB;AAAA,EACtB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA0B,SAAiF;AACnH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,UAAM,oCAAsC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACxF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA0B,SAAuD;AAC5F,WAAO,KAAK,KAAK,QAA4B,QAAQA,WAAU;AAAA,MAC7D,UAAM,4BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAuD;AAC3E,WAAO,KAAK,KAAK,QAA4B,OAAO,GAAGA,SAAQ,IAAI,EAAE,IAAI;AAAA,MACvE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhCO,IAAM,cAAN,cAA0B,wBAAW;AAAA;AAAA,EAE1B;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,aAAa,IAAI,WAAW,KAAK,IAAI;AAAA,EAC5C;AACF;;;AD9BA,IAAAC,eAYO;","names":["import_core","import_core","import_internal","ENDPOINT","import_core"]}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/client.ts
-import { createHttpClient } from "@runapi.ai/core";
+import { BaseClient } from "@runapi.ai/core";
 
 // src/resources/text-to-image.ts
 import { compactParams } from "@runapi.ai/core";
@@ -10,6 +10,12 @@ var TextToImage = class {
     this.http = http;
   }
   http;
+  /**
+   * Generate an image and wait until complete.
+   * @param params Text-to-image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text-to-image result.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete(() => this.get(id, options), {
@@ -18,12 +24,24 @@ var TextToImage = class {
     });
     return response;
   }
+  /**
+   * Create a text-to-image task; returns immediately with a task id.
+   * @param params Text-to-image parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
     return this.http.request("POST", ENDPOINT, {
       body: compactParams(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text-to-image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text-to-image status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -31,13 +49,64 @@ var TextToImage = class {
   }
 };
 
+// src/resources/remix-image.ts
+import { compactParams as compactParams2 } from "@runapi.ai/core";
+import { pollUntilComplete as pollUntilComplete2 } from "@runapi.ai/core/internal";
+var ENDPOINT2 = "/api/v1/flux_2/remix_image";
+var RemixImage = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Remix an image and wait until complete.
+   * @param params Image remix parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed remix result with images.
+   */
+  async run(params, options) {
+    const { id } = await this.create(params, options);
+    const response = await pollUntilComplete2(() => this.get(id, options), {
+      maxWaitMs: options?.maxWaitMs,
+      pollIntervalMs: options?.pollIntervalMs
+    });
+    return response;
+  }
+  /**
+   * Create an image remix task; returns immediately with a task id.
+   * @param params Image remix parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
+  async create(params, options) {
+    return this.http.request("POST", ENDPOINT2, {
+      body: compactParams2(params),
+      ...options
+    });
+  }
+  /**
+   * Fetch the current status of an image remix task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current remix status.
+   */
+  async get(id, options) {
+    return this.http.request("GET", `${ENDPOINT2}/${id}`, {
+      ...options
+    });
+  }
+};
+
 // src/client.ts
-var Flux2Client = class {
-  /** Text-to-image operations. */
+var Flux2Client = class extends BaseClient {
+  /** Text-to-image generation. */
   textToImage;
+  /** Transform source images with text-guided prompts. */
+  remixImage;
   constructor(options = {}) {
-    const http = createHttpClient(options);
-    this.textToImage = new TextToImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
+    this.remixImage = new RemixImage(this.http);
   }
 };
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/resources/text-to-image.ts","../src/index.ts"],"sourcesContent":["import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\n\n/**\n * Flux 2 text-to-image API client.\n *\n * @example\n * ```typescript\n * const client = new Flux2Client({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToImage.run({\n *   model: 'flux-2-pro-text-to-image',\n *   prompt: 'A futuristic cityscape at night',\n * });\n * ```\n */\nexport class Flux2Client {\n  /** Text-to-image operations. */\n  public readonly textToImage: TextToImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToImageResponse,\n  TextToImageParams,\n  TextToImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/flux_2/text_to_image';\n\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToImageResponse;\n  }\n\n  async create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { Flux2Client } from './client';\nexport * from './types';\n\n// Re-export core errors for convenience\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n  TaskTimeoutError,\n  TaskFailedError,\n} from '@runapi.ai/core';\n"],"mappings":";AAAA,SAAS,wBAA4C;;;ACCrD,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAQlC,IAAM,WAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,MAAM,kBAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQ,UAAU;AAAA,MAC7D,MAAM,cAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAG,QAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ADjBO,IAAM,cAAN,MAAkB;AAAA;AAAA,EAEP;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO,iBAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;AEvBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/resources/text-to-image.ts","../src/resources/remix-image.ts","../src/index.ts"],"sourcesContent":["import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\nimport { RemixImage } from './resources/remix-image';\n\n/**\n * Flux 2 text-to-image and remix API client.\n *\n * Pro and flex tiers for both text-to-image generation and\n * text-guided image remixing from source images.\n *\n * @example\n * ```typescript\n * const client = new Flux2Client({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToImage.run({\n *   model: 'flux-2-pro-text-to-image',\n *   prompt: 'A futuristic cityscape at night',\n * });\n * ```\n */\nexport class Flux2Client extends BaseClient {\n  /** Text-to-image generation. */\n  public readonly textToImage: TextToImage;\n  /** Transform source images with text-guided prompts. */\n  public readonly remixImage: RemixImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n    this.remixImage = new RemixImage(this.http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToImageResponse,\n  TextToImageParams,\n  TextToImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/flux_2/text_to_image';\n\n/** Flux 2 text-to-image generation resource. */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate an image and wait until complete.\n   * @param params Text-to-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed text-to-image result.\n   */\n  async run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToImageResponse;\n  }\n\n  /**\n   * Create a text-to-image task; returns immediately with a task id.\n   * @param params Text-to-image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text-to-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text-to-image status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedRemixImageResponse,\n  RemixImageParams,\n  RemixImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/flux_2/remix_image';\n\n/** Flux 2 image remix: transform source images with text-guided prompts. */\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Remix an image and wait until complete.\n   * @param params Image remix parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed remix result with images.\n   */\n  async run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedRemixImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<RemixImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedRemixImageResponse;\n  }\n\n  /**\n   * Create an image remix task; returns immediately with a task id.\n   * @param params Image remix parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of an image remix task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current remix status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<RemixImageResponse> {\n    return this.http.request<RemixImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { Flux2Client } from './client';\nexport * from './types';\n\n// Re-export core errors for convenience\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n  TaskTimeoutError,\n  TaskFailedError,\n} from '@runapi.ai/core';\n"],"mappings":";AAAA,SAAS,kBAAsC;;;ACC/C,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAQlC,IAAM,WAAW;AAGV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,MAAM,kBAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQ,UAAU;AAAA,MAC7D,MAAM,cAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAG,QAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACtDA,SAAS,iBAAAA,sBAAqB;AAC9B,SAAS,qBAAAC,0BAAyB;AAQlC,IAAMC,YAAW;AAGV,IAAM,aAAN,MAAiB;AAAA,EACtB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA0B,SAAiF;AACnH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,MAAMD,mBAAsC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACxF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA0B,SAAuD;AAC5F,WAAO,KAAK,KAAK,QAA4B,QAAQC,WAAU;AAAA,MAC7D,MAAMF,eAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAuD;AAC3E,WAAO,KAAK,KAAK,QAA4B,OAAO,GAAGE,SAAQ,IAAI,EAAE,IAAI;AAAA,MACvE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhCO,IAAM,cAAN,cAA0B,WAAW;AAAA;AAAA,EAE1B;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,aAAa,IAAI,WAAW,KAAK,IAAI;AAAA,EAC5C;AACF;;;AG9BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["compactParams","pollUntilComplete","ENDPOINT"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/flux-2",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "RunAPI Flux 2 SDK for JavaScript, Ruby, and Go",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -28,7 +28,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.4"
+    "@runapi.ai/core": "^0.2.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/skills/flux-2/README.md

@@ -21,7 +21,7 @@
 </div>
 <br/>
 
-Generate images with Flux 2 Pro and Flex text-to-image and image-to-image. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate Flux 2 through RunAPI.
+Generate and remix images with Flux 2 Pro and Flex. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate Flux 2 through RunAPI.
 
 The canonical agent file is `skills/flux-2/SKILL.md`.
 
@@ -55,6 +55,13 @@ const result = await client.textToImage.run({
   prompt: 'A cinematic product photo on warm paper',
   aspect_ratio: '1:1',
 });
+
+const remix = await client.remixImage.run({
+  model: 'flux-2-pro-remix-image',
+  prompt: 'Make this product shot feel like a warm editorial photo',
+  source_image_urls: ['https://example.com/source.jpg'],
+  aspect_ratio: 'auto',
+});
 ```
 
 ## Routing
@@ -70,12 +77,14 @@ const result = await client.textToImage.run({
 ## Variants
 
 - [Flux 2 Pro text to image](https://runapi.ai/models/flux-2/pro-text-to-image)
-- [Flux 2 Pro image to image](https://runapi.ai/models/flux-2/pro-image-to-image)
+- [Flux 2 Pro remix image](https://runapi.ai/models/flux-2/pro-remix-image)
 - [Flux 2 Flex text to image](https://runapi.ai/models/flux-2/flex-text-to-image)
-- [Flux 2 Flex image to image](https://runapi.ai/models/flux-2/flex-image-to-image)
+- [Flux 2 Flex remix image](https://runapi.ai/models/flux-2/flex-remix-image)
 
 ## Agent rules
 
+- Integration work uses the target language SDK; one-off generation, manual smoke tests, debugging, or user-requested CLI runs use the RunAPI CLI skill: https://github.com/runapi-ai/cli-skill
+- RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
 - Keep API keys in `RUNAPI_API_KEY` or RunAPI CLI config; never commit secrets.
 - Prefer `create`, `get`, and `run` JSON passthrough patterns instead of inventing flags for every model parameter.
 - For flux api pricing, rate-limit, and commercial-usage answers, link to the variant page rather than the repository README.

package/skills/flux-2/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: flux-2
-description: Generate and edit images with Flux 2 through RunAPI. Use when the user asks an agent to create, edit, or transform images with Flux 2. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
+description: Generate and remix images with Flux 2 through RunAPI. Use when the user asks an agent to create or transform images with Flux 2. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
 documentation: https://runapi.ai/models/flux-2.md
 provider_page: https://runapi.ai/providers/black-forest-labs.md
 catalog: https://runapi.ai/models.md
@@ -23,28 +23,39 @@ metadata:
 
 # Flux 2 on RunAPI
 
-Generate and edit images with Flux 2 through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
+Generate and remix images with Flux 2 through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
 
-## Routing decision
+## Critical: Integration Runtime
 
-- One-off generation, editing, or transformation for the user → use the **CLI path** with the `runapi` binary.
-- Building an app, backend, worker, library, or production codebase → use the **SDK integration path**.
+- Integration work (app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production codebase) uses the **SDK integration path** for the target language.
+- One-off generation, editing, transformation, manual smoke tests, debugging, or user-requested CLI runs use the **CLI path** with the `runapi` binary. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill.
+- Never shell out to the `runapi` CLI as the production runtime integration layer.
+
+## SDK integration path
+
+When integrating Flux 2 into an app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production workflow, start by checking the current SDK package and official usage. Confirm install commands, client methods (`create`, `get`, `run`), request fields, response shape, and error classes before using CLI help or raw HTTP examples. Use a RunAPI SDK package:
+
+- JavaScript / TypeScript: `@runapi.ai/flux-2`
+- Ruby: `runapi-flux_2`
+- Go: `github.com/runapi-ai/flux-2-sdk/go`
 
 ## CLI path
 
-The `runapi` binary is the runtime dependency. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.
+The `runapi` binary is the one-off and manual testing runtime dependency. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.
 
-Inspect the available actions and request fields with CLI help:
+Inspect the available commands and request fields with CLI help:
 
 ```shell
 runapi flux-2 --help
 runapi flux-2 text-to-image --help
+runapi flux-2 remix-image --help
 ```
 
 Run a one-off task (synchronous — polls until the task completes):
 
 ```shell
 runapi flux-2 text-to-image --input-file request.json
+runapi flux-2 remix-image --input-file remix-request.json
 ```
 
 Submit asynchronously and poll separately:
@@ -52,17 +63,15 @@ Submit asynchronously and poll separately:
 ```shell
 runapi flux-2 text-to-image --async --input-file request.json
 runapi wait <task-id> --service flux-2 --action text-to-image
+runapi flux-2 remix-image --async --input-file remix-request.json
+runapi wait <task-id> --service flux-2 --action remix-image
 ```
 
-Available actions: `text-to-image`.
+Available commands: `text-to-image`, `remix-image`.
 
-## SDK integration path
-
-When integrating Flux 2 into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:
+## Generated file storage
 
-- JavaScript / TypeScript: `@runapi.ai/flux-2`
-- Ruby: `runapi-flux_2`
-- Go: `github.com/runapi-ai/flux-2-sdk/go`
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
 
 ## References
 
@@ -73,7 +82,6 @@ When integrating Flux 2 into an app, backend, worker, or library — not for one
 ## Variants
 
 - [Flux 2 Pro text to image](https://runapi.ai/models/flux-2/pro-text-to-image.md)
-- [Flux 2 Pro image to image](https://runapi.ai/models/flux-2/pro-image-to-image.md)
+- [Flux 2 Pro remix image](https://runapi.ai/models/flux-2/pro-remix-image.md)
 - [Flux 2 Flex text to image](https://runapi.ai/models/flux-2/flex-text-to-image.md)
-- [Flux 2 Flex image to image](https://runapi.ai/models/flux-2/flex-image-to-image.md)
-
+- [Flux 2 Flex remix image](https://runapi.ai/models/flux-2/flex-remix-image.md)