@runapi.ai/flux-2 0.2.5 → 0.2.7

package/README.md

@@ -1,8 +1,8 @@
-# Flux API JavaScript SDK for RunAPI
+# Flux 2 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, remix-image, and creative production flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+The Flux 2 JavaScript SDK is the language-specific package for Flux 2 on RunAPI. Use this package for image generation, image editing, and creative production workflows when your application needs request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
 
-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.
+This 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
 
@@ -27,16 +27,18 @@ 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'],
+  source_image_urls: ['https://cdn.runapi.ai/public/samples/image.jpg'],
   aspect_ratio: 'auto',
 });
 ```
 
 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 `textToImage` and `remixImage`. 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 are `textToImage` and `remixImage`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 

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';
 
+/**
+ * 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';
+/** 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;
+    /** Default: 1k. */
     output_resolution?: OutputResolution;
+    /** Content safety check toggle. */
     enable_safety_checker?: boolean;
+    /** Default: 1:1. */
     aspect_ratio?: AspectRatio;
 }
+/**
+ * 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;
+    /** Source image URLs to remix (1-8). */
     source_image_urls: string[];
+    /** URL for completion callback notifications. */
     callback_url?: string;
+    /** 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;
+/** 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,27 +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
@@ -80,10 +151,10 @@ declare class RemixImage {
  * });
  * ```
  */
-declare class Flux2Client {
-    /** Text-to-image operations. */
+declare class Flux2Client extends BaseClient {
+    /** Text-to-image generation. */
     readonly textToImage: TextToImage;
-    /** Remix-image operations. */
+    /** Transform source images with text-guided prompts. */
     readonly remixImage: RemixImage;
     constructor(options?: ClientOptions);
 }

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';
 
+/**
+ * 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';
+/** 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;
+    /** Default: 1k. */
     output_resolution?: OutputResolution;
+    /** Content safety check toggle. */
     enable_safety_checker?: boolean;
+    /** Default: 1:1. */
     aspect_ratio?: AspectRatio;
 }
+/**
+ * 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;
+    /** Source image URLs to remix (1-8). */
     source_image_urls: string[];
+    /** URL for completion callback notifications. */
     callback_url?: string;
+    /** 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;
+/** 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,27 +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
@@ -80,10 +151,10 @@ declare class RemixImage {
  * });
  * ```
  */
-declare class Flux2Client {
-    /** Text-to-image operations. */
+declare class Flux2Client extends BaseClient {
+    /** Text-to-image generation. */
     readonly textToImage: TextToImage;
-    /** Remix-image operations. */
+    /** Transform source images with text-guided prompts. */
     readonly remixImage: RemixImage;
     constructor(options?: ClientOptions);
 }

package/dist/index.js

@@ -41,12 +41,136 @@ var import_core3 = require("@runapi.ai/core");
 // src/resources/text-to-image.ts
 var import_core = require("@runapi.ai/core");
 var import_internal = require("@runapi.ai/core/internal");
+
+// src/contract_gen.ts
+var contract = {
+  "remix-image": {
+    "models": [
+      "flux-2-flex-remix-image",
+      "flux-2-pro-remix-image"
+    ],
+    "fields_by_model": {
+      "flux-2-flex-remix-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3",
+            "auto"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      },
+      "flux-2-pro-remix-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3",
+            "auto"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      }
+    }
+  },
+  "text-to-image": {
+    "models": [
+      "flux-2-flex-text-to-image",
+      "flux-2-pro-text-to-image"
+    ],
+    "fields_by_model": {
+      "flux-2-flex-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        }
+      },
+      "flux-2-pro-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-image.ts
 var ENDPOINT = "/api/v1/flux_2/text_to_image";
 var TextToImage = class {
   constructor(http) {
     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 +179,26 @@ 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) {
+    const body = (0, import_core.compactParams)(params);
+    (0, import_core.validateParams)(contract["text-to-image"], body);
     return this.http.request("POST", ENDPOINT, {
-      body: (0, import_core.compactParams)(params),
+      body,
       ...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
@@ -77,6 +215,12 @@ var RemixImage = class {
     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), {
@@ -85,12 +229,26 @@ var RemixImage = class {
     });
     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) {
+    const body = (0, import_core2.compactParams)(params);
+    (0, import_core2.validateParams)(contract["remix-image"], body);
     return this.http.request("POST", ENDPOINT2, {
-      body: (0, import_core2.compactParams)(params),
+      body,
       ...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
@@ -99,15 +257,15 @@ var RemixImage = class {
 };
 
 // src/client.ts
-var Flux2Client = class {
-  /** Text-to-image operations. */
+var Flux2Client = class extends import_core3.BaseClient {
+  /** Text-to-image generation. */
   textToImage;
-  /** Remix-image operations. */
+  /** Transform source images with text-guided prompts. */
   remixImage;
   constructor(options = {}) {
-    const http = (0, import_core3.createHttpClient)(options);
-    this.textToImage = new TextToImage(http);
-    this.remixImage = new RemixImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
+    this.remixImage = new RemixImage(this.http);
   }
 };
 

package/dist/index.js.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-image.ts","../src/contract_gen.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, ActionSchema } from '@runapi.ai/core';\nimport { compactParams, validateParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport { contract } from '../contract_gen';\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    const body = compactParams(params);\n    validateParams(contract['text-to-image'] as ActionSchema, body as Record<string, unknown>);\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body,\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","export const contract = {\n  \"remix-image\": {\n    \"models\": [\n      \"flux-2-flex-remix-image\",\n      \"flux-2-pro-remix-image\"\n    ],\n    \"fields_by_model\": {\n      \"flux-2-flex-remix-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\",\n            \"auto\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      },\n      \"flux-2-pro-remix-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\",\n            \"auto\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      }\n    }\n  },\n  \"text-to-image\": {\n    \"models\": [\n      \"flux-2-flex-text-to-image\",\n      \"flux-2-pro-text-to-image\"\n    ],\n    \"fields_by_model\": {\n      \"flux-2-flex-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        }\n      },\n      \"flux-2-pro-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        }\n      }\n    }\n  }\n} as const;\n","import type { HttpClient, RequestOptions, PollingOptions, ActionSchema } from '@runapi.ai/core';\nimport { compactParams, validateParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport { contract } from '../contract_gen';\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    const body = compactParams(params);\n    validateParams(contract['remix-image'] as ActionSchema, body as Record<string, unknown>);\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body,\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":"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","names":["import_core","import_core","import_internal","ENDPOINT","import_core"]}

package/dist/index.mjs

@@ -1,15 +1,139 @@
 // 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";
+import { compactParams, validateParams } from "@runapi.ai/core";
 import { pollUntilComplete } from "@runapi.ai/core/internal";
+
+// src/contract_gen.ts
+var contract = {
+  "remix-image": {
+    "models": [
+      "flux-2-flex-remix-image",
+      "flux-2-pro-remix-image"
+    ],
+    "fields_by_model": {
+      "flux-2-flex-remix-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3",
+            "auto"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      },
+      "flux-2-pro-remix-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3",
+            "auto"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      }
+    }
+  },
+  "text-to-image": {
+    "models": [
+      "flux-2-flex-text-to-image",
+      "flux-2-pro-text-to-image"
+    ],
+    "fields_by_model": {
+      "flux-2-flex-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        }
+      },
+      "flux-2-pro-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "3:2",
+            "2:3"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k"
+          ]
+        },
+        "prompt": {
+          "required": true
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-image.ts
 var ENDPOINT = "/api/v1/flux_2/text_to_image";
 var TextToImage = class {
   constructor(http) {
     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 +142,26 @@ 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) {
+    const body = compactParams(params);
+    validateParams(contract["text-to-image"], body);
     return this.http.request("POST", ENDPOINT, {
-      body: compactParams(params),
+      body,
       ...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
@@ -32,7 +170,7 @@ var TextToImage = class {
 };
 
 // src/resources/remix-image.ts
-import { compactParams as compactParams2 } from "@runapi.ai/core";
+import { compactParams as compactParams2, validateParams as validateParams2 } from "@runapi.ai/core";
 import { pollUntilComplete as pollUntilComplete2 } from "@runapi.ai/core/internal";
 var ENDPOINT2 = "/api/v1/flux_2/remix_image";
 var RemixImage = class {
@@ -40,6 +178,12 @@ var RemixImage = class {
     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), {
@@ -48,12 +192,26 @@ var RemixImage = class {
     });
     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) {
+    const body = compactParams2(params);
+    validateParams2(contract["remix-image"], body);
     return this.http.request("POST", ENDPOINT2, {
-      body: compactParams2(params),
+      body,
       ...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
@@ -62,15 +220,15 @@ var RemixImage = class {
 };
 
 // src/client.ts
-var Flux2Client = class {
-  /** Text-to-image operations. */
+var Flux2Client = class extends BaseClient {
+  /** Text-to-image generation. */
   textToImage;
-  /** Remix-image operations. */
+  /** Transform source images with text-guided prompts. */
   remixImage;
   constructor(options = {}) {
-    const http = createHttpClient(options);
-    this.textToImage = new TextToImage(http);
-    this.remixImage = new RemixImage(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/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"]}
+{"version":3,"sources":["../src/client.ts","../src/resources/text-to-image.ts","../src/contract_gen.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, ActionSchema } from '@runapi.ai/core';\nimport { compactParams, validateParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport { contract } from '../contract_gen';\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    const body = compactParams(params);\n    validateParams(contract['text-to-image'] as ActionSchema, body as Record<string, unknown>);\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body,\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","export const contract = {\n  \"remix-image\": {\n    \"models\": [\n      \"flux-2-flex-remix-image\",\n      \"flux-2-pro-remix-image\"\n    ],\n    \"fields_by_model\": {\n      \"flux-2-flex-remix-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\",\n            \"auto\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      },\n      \"flux-2-pro-remix-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\",\n            \"auto\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      }\n    }\n  },\n  \"text-to-image\": {\n    \"models\": [\n      \"flux-2-flex-text-to-image\",\n      \"flux-2-pro-text-to-image\"\n    ],\n    \"fields_by_model\": {\n      \"flux-2-flex-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        }\n      },\n      \"flux-2-pro-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"3:2\",\n            \"2:3\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\"\n          ]\n        },\n        \"prompt\": {\n          \"required\": true\n        }\n      }\n    }\n  }\n} as const;\n","import type { HttpClient, RequestOptions, PollingOptions, ActionSchema } from '@runapi.ai/core';\nimport { compactParams, validateParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport { contract } from '../contract_gen';\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    const body = compactParams(params);\n    validateParams(contract['remix-image'] as ActionSchema, body as Record<string, unknown>);\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body,\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":"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","names":["compactParams","validateParams","pollUntilComplete","ENDPOINT","pollUntilComplete","compactParams","validateParams"]}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@runapi.ai/flux-2",
-  "version": "0.2.5",
-  "description": "RunAPI Flux 2 SDK for JavaScript, Ruby, and Go",
+  "runapi": {
+    "slug": "flux-2"
+  },
+  "version": "0.2.7",
+  "description": "RunAPI Flux 2 SDK for text-to-image and remix-image workflows in JavaScript, Python, Ruby, Go, and Java",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -28,7 +31,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.5"
+    "@runapi.ai/core": "^0.2.7"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -47,8 +50,16 @@
     "api",
     "sdk",
     "typescript",
+    "python",
     "ruby",
-    "golang"
+    "golang",
+    "java",
+    "maven",
+    "gradle",
+    "image-generation",
+    "text-to-image",
+    "image-api",
+    "flux-api"
   ],
   "author": "RunAPI",
   "license": "Apache-2.0",
@@ -56,5 +67,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/runapi-ai/flux-2-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runapi-ai/flux-2-sdk/issues"
   }
 }

package/skills/flux-2/README.md

@@ -59,7 +59,7 @@ const result = await client.textToImage.run({
 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'],
+  source_image_urls: ['https://cdn.runapi.ai/public/samples/image.jpg'],
   aspect_ratio: 'auto',
 });
 ```
@@ -83,9 +83,11 @@ const remix = await client.remixImage.run({
 
 ## 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.
+- For pricing, rate-limit, and commercial-usage answers, link to the variant page rather than the repository README.
 
 ## License
 

package/skills/flux-2/SKILL.md

@@ -25,14 +25,23 @@ metadata:
 
 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 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**.
+- 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 commands and request fields with CLI help:
 
@@ -60,13 +69,9 @@ runapi wait <task-id> --service flux-2 --action remix-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