@runapi.ai/flux-2 0.2.3 → 0.2.5

package/README.md

@@ -1,32 +1,42 @@
 # 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.
 
 ## 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 +46,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,28 +1,28 @@
 import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, 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';
+type Flux2Model = 'flux-2-pro-text-to-image' | 'flux-2-pro-remix-image' | 'flux-2-flex-text-to-image' | 'flux-2-flex-remix-image';
 type AspectRatio = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '3:2' | '2:3';
-type AspectRatioI2I = AspectRatio | 'auto';
-type Resolution = '1K' | '2K';
+type RemixAspectRatio = AspectRatio | 'auto';
+type OutputResolution = '1k' | '2k';
 interface GenerationT2IParams {
     model: 'flux-2-pro-text-to-image' | 'flux-2-flex-text-to-image';
     prompt: string;
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
+    output_resolution?: OutputResolution;
+    enable_safety_checker?: boolean;
     aspect_ratio?: AspectRatio;
 }
-interface GenerationI2IParams {
-    model: 'flux-2-pro-image-to-image' | 'flux-2-flex-image-to-image';
+interface RemixImageParams {
+    model: 'flux-2-pro-remix-image' | 'flux-2-flex-remix-image';
     prompt: string;
-    input_urls: string[];
+    source_image_urls: string[];
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
-    aspect_ratio?: AspectRatioI2I;
+    output_resolution?: OutputResolution;
+    enable_safety_checker?: boolean;
+    aspect_ratio?: RemixAspectRatio;
 }
-type TextToImageParams = GenerationT2IParams | GenerationI2IParams;
+type TextToImageParams = GenerationT2IParams;
 interface TaskCreateResponse {
     id: string;
 }
@@ -45,6 +45,8 @@ type CompletedTextToImageResponse = TextToImageResponse & {
     status: 'completed';
     images: Image[];
 };
+type RemixImageResponse = TextToImageResponse;
+type CompletedRemixImageResponse = CompletedTextToImageResponse;
 
 declare class TextToImage {
     private readonly http;
@@ -54,6 +56,14 @@ declare class TextToImage {
     get(id: string, options?: RequestOptions): Promise<TextToImageResponse>;
 }
 
+declare class RemixImage {
+    private readonly http;
+    constructor(http: HttpClient);
+    run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedRemixImageResponse>;
+    create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    get(id: string, options?: RequestOptions): Promise<RemixImageResponse>;
+}
+
 /**
  * Flux 2 text-to-image API client.
  *
@@ -73,7 +83,9 @@ declare class TextToImage {
 declare class Flux2Client {
     /** Text-to-image operations. */
     readonly textToImage: TextToImage;
+    /** Remix-image operations. */
+    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,28 +1,28 @@
 import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, 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';
+type Flux2Model = 'flux-2-pro-text-to-image' | 'flux-2-pro-remix-image' | 'flux-2-flex-text-to-image' | 'flux-2-flex-remix-image';
 type AspectRatio = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '3:2' | '2:3';
-type AspectRatioI2I = AspectRatio | 'auto';
-type Resolution = '1K' | '2K';
+type RemixAspectRatio = AspectRatio | 'auto';
+type OutputResolution = '1k' | '2k';
 interface GenerationT2IParams {
     model: 'flux-2-pro-text-to-image' | 'flux-2-flex-text-to-image';
     prompt: string;
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
+    output_resolution?: OutputResolution;
+    enable_safety_checker?: boolean;
     aspect_ratio?: AspectRatio;
 }
-interface GenerationI2IParams {
-    model: 'flux-2-pro-image-to-image' | 'flux-2-flex-image-to-image';
+interface RemixImageParams {
+    model: 'flux-2-pro-remix-image' | 'flux-2-flex-remix-image';
     prompt: string;
-    input_urls: string[];
+    source_image_urls: string[];
     callback_url?: string;
-    resolution?: Resolution;
-    nsfw_checker?: boolean;
-    aspect_ratio?: AspectRatioI2I;
+    output_resolution?: OutputResolution;
+    enable_safety_checker?: boolean;
+    aspect_ratio?: RemixAspectRatio;
 }
-type TextToImageParams = GenerationT2IParams | GenerationI2IParams;
+type TextToImageParams = GenerationT2IParams;
 interface TaskCreateResponse {
     id: string;
 }
@@ -45,6 +45,8 @@ type CompletedTextToImageResponse = TextToImageResponse & {
     status: 'completed';
     images: Image[];
 };
+type RemixImageResponse = TextToImageResponse;
+type CompletedRemixImageResponse = CompletedTextToImageResponse;
 
 declare class TextToImage {
     private readonly http;
@@ -54,6 +56,14 @@ declare class TextToImage {
     get(id: string, options?: RequestOptions): Promise<TextToImageResponse>;
 }
 
+declare class RemixImage {
+    private readonly http;
+    constructor(http: HttpClient);
+    run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedRemixImageResponse>;
+    create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    get(id: string, options?: RequestOptions): Promise<RemixImageResponse>;
+}
+
 /**
  * Flux 2 text-to-image API client.
  *
@@ -73,7 +83,9 @@ declare class TextToImage {
 declare class Flux2Client {
     /** Text-to-image operations. */
     readonly textToImage: TextToImage;
+    /** Remix-image operations. */
+    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");
@@ -68,18 +68,51 @@ 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;
+  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;
+  }
+  async create(params, options) {
+    return this.http.request("POST", ENDPOINT2, {
+      body: (0, import_core2.compactParams)(params),
+      ...options
+    });
+  }
+  async get(id, options) {
+    return this.http.request("GET", `${ENDPOINT2}/${id}`, {
+      ...options
+    });
+  }
+};
+
 // src/client.ts
 var Flux2Client = class {
   /** Text-to-image operations. */
   textToImage;
+  /** Remix-image operations. */
+  remixImage;
   constructor(options = {}) {
-    const http = (0, import_core2.createHttpClient)(options);
+    const http = (0, import_core3.createHttpClient)(options);
     this.textToImage = new TextToImage(http);
+    this.remixImage = new RemixImage(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 { createHttpClient, 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 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  /** Remix-image operations. */\n  public readonly remixImage: RemixImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n    this.remixImage = new RemixImage(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","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\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\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  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  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,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;;;ACnCA,IAAAC,eAA8B;AAC9B,IAAAC,mBAAkC;AAQlC,IAAMC,YAAW;AAEV,IAAM,aAAN,MAAiB;AAAA,EACtB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,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,EAEA,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,EAEA,MAAM,IAAI,IAAY,SAAuD;AAC3E,WAAO,KAAK,KAAK,QAA4B,OAAO,GAAGA,SAAQ,IAAI,EAAE,IAAI;AAAA,MACvE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhBO,IAAM,cAAN,MAAkB;AAAA;AAAA,EAEP;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,WAAO,+BAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AACvC,SAAK,aAAa,IAAI,WAAW,IAAI;AAAA,EACvC;AACF;;;AD3BA,IAAAC,eAYO;","names":["import_core","import_core","import_internal","ENDPOINT","import_core"]}

package/dist/index.mjs

@@ -31,13 +31,46 @@ 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;
+  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;
+  }
+  async create(params, options) {
+    return this.http.request("POST", ENDPOINT2, {
+      body: compactParams2(params),
+      ...options
+    });
+  }
+  async get(id, options) {
+    return this.http.request("GET", `${ENDPOINT2}/${id}`, {
+      ...options
+    });
+  }
+};
+
 // src/client.ts
 var Flux2Client = class {
   /** Text-to-image operations. */
   textToImage;
+  /** Remix-image operations. */
+  remixImage;
   constructor(options = {}) {
     const http = createHttpClient(options);
     this.textToImage = new TextToImage(http);
+    this.remixImage = new RemixImage(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 { createHttpClient, 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 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  /** Remix-image operations. */\n  public readonly remixImage: RemixImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n    this.remixImage = new RemixImage(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","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\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\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  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  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,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;;;ACnCA,SAAS,iBAAAA,sBAAqB;AAC9B,SAAS,qBAAAC,0BAAyB;AAQlC,IAAMC,YAAW;AAEV,IAAM,aAAN,MAAiB;AAAA,EACtB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,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,EAEA,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,EAEA,MAAM,IAAI,IAAY,SAAuD;AAC3E,WAAO,KAAK,KAAK,QAA4B,OAAO,GAAGE,SAAQ,IAAI,EAAE,IAAI;AAAA,MACvE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhBO,IAAM,cAAN,MAAkB;AAAA;AAAA,EAEP;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO,iBAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AACvC,SAAK,aAAa,IAAI,WAAW,IAAI;AAAA,EACvC;AACF;;;AG3BA;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.3",
+  "version": "0.2.5",
   "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.3"
+    "@runapi.ai/core": "^0.2.5"
   },
   "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,9 +77,9 @@ 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
 

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,30 @@ 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
 
-- One-off generation, editing, or transformation for the user → use the **CLI path** with the `runapi` binary.
+- One-off generation or remixing 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**.
 
 ## 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.
 
-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,9 +54,11 @@ 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
 
@@ -73,7 +77,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)