@runapi.ai/gpt-4o-image 0.2.5 → 0.2.6

package/README.md

@@ -24,6 +24,8 @@ const status = await client.generations.get(task.id);
 
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## Language notes
 
 Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building image applications. The available resources include generations. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

package/dist/index.d.mts

@@ -1,23 +1,39 @@
-import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, ClientOptions } from '@runapi.ai/core';
+import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, BaseClient, ClientOptions } from '@runapi.ai/core';
 export { AuthenticationError, InsufficientCreditsError, NetworkError, NotFoundError, RateLimitError, RunApiError, ServiceUnavailableError, TaskFailedError, TaskTimeoutError, TimeoutError, ValidationError } from '@runapi.ai/core';
 
 type Gpt4oImageModel = 'gpt-4o-image';
+/** Required output aspect ratio. */
 type AspectRatio = '1:1' | '3:2' | '2:3';
+/** Batch output size: 1, 2, or 4 images per request. */
 type OutputCount = 1 | 2 | 4;
+/**
+ * Parameters for GPT-4o image generation and editing.
+ *
+ * - For pure generation, provide `prompt` (required) and `aspect_ratio`.
+ * - For editing, provide `source_image_urls` (up to 5); `prompt` becomes
+ *   optional since the model can generate variants without one.
+ * - For inpainting, also provide `mask_url` to indicate which regions of
+ *   the source image to regenerate.
+ */
 interface TextToImageParams {
     model: Gpt4oImageModel;
+    /** Text prompt; required when source_image_urls is not provided. */
     prompt?: string;
     aspect_ratio: AspectRatio;
+    /** Up to 5 source image URLs for edits or variants. */
     source_image_urls?: string[];
+    /** Mask image URL marking regions to regenerate (inpainting); only meaningful with source_image_urls. */
     mask_url?: string;
     output_count?: OutputCount;
     callback_url?: string;
+    /** Let the model expand short prompts with additional detail. */
     enable_prompt_expansion?: boolean;
 }
 interface TaskCreateResponse {
     id: string;
     status: string;
 }
+/** A generated image with its CDN URL. */
 interface Image {
     url: string;
 }
@@ -25,23 +41,72 @@ interface TextToImageResponse {
     id: string;
     status: AsyncTaskStatus;
     images?: Image[];
+    /** Intermediate status string while the task is running. */
     progress?: string;
     error?: string;
     [key: string]: unknown;
 }
 
+/**
+ * Generates images from a text prompt, optionally guided by source images and a mask.
+ * For pure generation, provide a prompt. For editing, provide source_image_urls
+ * (and optionally mask_url) to modify specific regions of the source.
+ */
 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<TextToImageResponse>;
+    /**
+     * 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>;
 }
 
 /**
- * GPT-4o Image text-to-image API client.
+ * GPT-4o Image generation and editing API client.
+ *
+ * Supports pure text-to-image generation, image editing with source images,
+ * and inpainting with an optional mask. At least one of `prompt` or
+ * `source_image_urls` must be provided.
+ *
+ * @example
+ * ```typescript
+ * const client = new Gpt4oImageClient({ apiKey: 'your-api-key' });
+ *
+ * // Pure generation
+ * const result = await client.textToImage.run({
+ *   model: 'gpt-4o-image',
+ *   prompt: 'A watercolor painting of a sunset',
+ *   aspect_ratio: '3:2',
+ * });
+ *
+ * // Edit with source images
+ * const edited = await client.textToImage.run({
+ *   model: 'gpt-4o-image',
+ *   prompt: 'Add a rainbow',
+ *   aspect_ratio: '3:2',
+ *   source_image_urls: ['https://example.com/photo.jpg'],
+ * });
+ * ```
  */
-declare class Gpt4oImageClient {
+declare class Gpt4oImageClient extends BaseClient {
+    /** Image generation, editing, and inpainting operations. */
     readonly textToImage: TextToImage;
     constructor(options?: ClientOptions);
 }

package/dist/index.d.ts

@@ -1,23 +1,39 @@
-import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, ClientOptions } from '@runapi.ai/core';
+import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, BaseClient, ClientOptions } from '@runapi.ai/core';
 export { AuthenticationError, InsufficientCreditsError, NetworkError, NotFoundError, RateLimitError, RunApiError, ServiceUnavailableError, TaskFailedError, TaskTimeoutError, TimeoutError, ValidationError } from '@runapi.ai/core';
 
 type Gpt4oImageModel = 'gpt-4o-image';
+/** Required output aspect ratio. */
 type AspectRatio = '1:1' | '3:2' | '2:3';
+/** Batch output size: 1, 2, or 4 images per request. */
 type OutputCount = 1 | 2 | 4;
+/**
+ * Parameters for GPT-4o image generation and editing.
+ *
+ * - For pure generation, provide `prompt` (required) and `aspect_ratio`.
+ * - For editing, provide `source_image_urls` (up to 5); `prompt` becomes
+ *   optional since the model can generate variants without one.
+ * - For inpainting, also provide `mask_url` to indicate which regions of
+ *   the source image to regenerate.
+ */
 interface TextToImageParams {
     model: Gpt4oImageModel;
+    /** Text prompt; required when source_image_urls is not provided. */
     prompt?: string;
     aspect_ratio: AspectRatio;
+    /** Up to 5 source image URLs for edits or variants. */
     source_image_urls?: string[];
+    /** Mask image URL marking regions to regenerate (inpainting); only meaningful with source_image_urls. */
     mask_url?: string;
     output_count?: OutputCount;
     callback_url?: string;
+    /** Let the model expand short prompts with additional detail. */
     enable_prompt_expansion?: boolean;
 }
 interface TaskCreateResponse {
     id: string;
     status: string;
 }
+/** A generated image with its CDN URL. */
 interface Image {
     url: string;
 }
@@ -25,23 +41,72 @@ interface TextToImageResponse {
     id: string;
     status: AsyncTaskStatus;
     images?: Image[];
+    /** Intermediate status string while the task is running. */
     progress?: string;
     error?: string;
     [key: string]: unknown;
 }
 
+/**
+ * Generates images from a text prompt, optionally guided by source images and a mask.
+ * For pure generation, provide a prompt. For editing, provide source_image_urls
+ * (and optionally mask_url) to modify specific regions of the source.
+ */
 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<TextToImageResponse>;
+    /**
+     * 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>;
 }
 
 /**
- * GPT-4o Image text-to-image API client.
+ * GPT-4o Image generation and editing API client.
+ *
+ * Supports pure text-to-image generation, image editing with source images,
+ * and inpainting with an optional mask. At least one of `prompt` or
+ * `source_image_urls` must be provided.
+ *
+ * @example
+ * ```typescript
+ * const client = new Gpt4oImageClient({ apiKey: 'your-api-key' });
+ *
+ * // Pure generation
+ * const result = await client.textToImage.run({
+ *   model: 'gpt-4o-image',
+ *   prompt: 'A watercolor painting of a sunset',
+ *   aspect_ratio: '3:2',
+ * });
+ *
+ * // Edit with source images
+ * const edited = await client.textToImage.run({
+ *   model: 'gpt-4o-image',
+ *   prompt: 'Add a rainbow',
+ *   aspect_ratio: '3:2',
+ *   source_image_urls: ['https://example.com/photo.jpg'],
+ * });
+ * ```
  */
-declare class Gpt4oImageClient {
+declare class Gpt4oImageClient extends BaseClient {
+    /** Image generation, editing, and inpainting operations. */
     readonly textToImage: TextToImage;
     constructor(options?: ClientOptions);
 }

package/dist/index.js

@@ -47,6 +47,12 @@ var TextToImage = class {
     this.http = http;
   }
   http;
+  /**
+   * Generate an image and wait until complete.
+   * @param params Text-to-image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text-to-image result.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     return (0, import_internal.pollUntilComplete)(() => this.get(id, options), {
@@ -54,12 +60,24 @@ var TextToImage = class {
       pollIntervalMs: options?.pollIntervalMs
     });
   }
+  /**
+   * Create a text-to-image task; returns immediately with a task id.
+   * @param params Text-to-image parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
     return this.http.request("POST", ENDPOINT, {
       body: (0, import_core.compactParams)(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text-to-image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text-to-image status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -68,11 +86,12 @@ var TextToImage = class {
 };
 
 // src/client.ts
-var Gpt4oImageClient = class {
+var Gpt4oImageClient = class extends import_core2.BaseClient {
+  /** Image generation, editing, and inpainting operations. */
   textToImage;
   constructor(options = {}) {
-    const http = (0, import_core2.createHttpClient)(options);
-    this.textToImage = new TextToImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
   }
 };
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-image.ts"],"sourcesContent":["export { Gpt4oImageClient } 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 * GPT-4o Image text-to-image API client.\n */\nexport class Gpt4oImageClient {\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, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gpt_4o_image/text_to_image';\n\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<TextToImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\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;AAGlC,IAAM,WAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAyE;AAC5G,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,eAAO,mCAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzE,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAAA,EACH;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;;;ADxBO,IAAM,mBAAN,MAAuB;AAAA,EACZ;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,WAAO,+BAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;ADTA,IAAAC,eAYO;","names":["import_core","import_core"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-image.ts"],"sourcesContent":["export { Gpt4oImageClient } 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';\n\n/**\n * GPT-4o Image generation and editing API client.\n *\n * Supports pure text-to-image generation, image editing with source images,\n * and inpainting with an optional mask. At least one of `prompt` or\n * `source_image_urls` must be provided.\n *\n * @example\n * ```typescript\n * const client = new Gpt4oImageClient({ apiKey: 'your-api-key' });\n *\n * // Pure generation\n * const result = await client.textToImage.run({\n *   model: 'gpt-4o-image',\n *   prompt: 'A watercolor painting of a sunset',\n *   aspect_ratio: '3:2',\n * });\n *\n * // Edit with source images\n * const edited = await client.textToImage.run({\n *   model: 'gpt-4o-image',\n *   prompt: 'Add a rainbow',\n *   aspect_ratio: '3:2',\n *   source_image_urls: ['https://example.com/photo.jpg'],\n * });\n * ```\n */\nexport class Gpt4oImageClient extends BaseClient {\n  /** Image generation, editing, and inpainting operations. */\n  public readonly textToImage: TextToImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n  }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gpt_4o_image/text_to_image';\n\n/**\n * Generates images from a text prompt, optionally guided by source images and a mask.\n * For pure generation, provide a prompt. For editing, provide source_image_urls\n * (and optionally mask_url) to modify specific regions of the source.\n */\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<TextToImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n  }\n\n  /**\n   * Create a text-to-image task; returns immediately with a task id.\n   * @param params Text-to-image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text-to-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text-to-image status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,eAA+C;;;ACC/C,kBAA8B;AAC9B,sBAAkC;AAGlC,IAAM,WAAW;AAOV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAyE;AAC5G,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,eAAO,mCAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzE,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQ,UAAU;AAAA,MAC7D,UAAM,2BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAG,QAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ADvBO,IAAM,mBAAN,cAA+B,wBAAW;AAAA;AAAA,EAE/B;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAAA,EAC9C;AACF;;;ADlCA,IAAAC,eAYO;","names":["import_core","import_core"]}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/client.ts
-import { createHttpClient } from "@runapi.ai/core";
+import { BaseClient } from "@runapi.ai/core";
 
 // src/resources/text-to-image.ts
 import { compactParams } from "@runapi.ai/core";
@@ -10,6 +10,12 @@ var TextToImage = class {
     this.http = http;
   }
   http;
+  /**
+   * Generate an image and wait until complete.
+   * @param params Text-to-image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text-to-image result.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     return pollUntilComplete(() => this.get(id, options), {
@@ -17,12 +23,24 @@ var TextToImage = class {
       pollIntervalMs: options?.pollIntervalMs
     });
   }
+  /**
+   * Create a text-to-image task; returns immediately with a task id.
+   * @param params Text-to-image parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
     return this.http.request("POST", ENDPOINT, {
       body: compactParams(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text-to-image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text-to-image status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -31,11 +49,12 @@ var TextToImage = class {
 };
 
 // src/client.ts
-var Gpt4oImageClient = class {
+var Gpt4oImageClient = class extends BaseClient {
+  /** Image generation, editing, and inpainting operations. */
   textToImage;
   constructor(options = {}) {
-    const http = createHttpClient(options);
-    this.textToImage = new TextToImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
   }
 };
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/resources/text-to-image.ts","../src/index.ts"],"sourcesContent":["import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\n\n/**\n * GPT-4o Image text-to-image API client.\n */\nexport class Gpt4oImageClient {\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, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gpt_4o_image/text_to_image';\n\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToImageParams, options?: RequestOptions & PollingOptions): Promise<TextToImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\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 { Gpt4oImageClient } 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;AAGlC,IAAM,WAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAyE;AAC5G,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,WAAO,kBAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzE,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAAA,EACH;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;;;ADxBO,IAAM,mBAAN,MAAuB;AAAA,EACZ;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO,iBAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;AETA;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/index.ts"],"sourcesContent":["import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\n\n/**\n * GPT-4o Image generation and editing API client.\n *\n * Supports pure text-to-image generation, image editing with source images,\n * and inpainting with an optional mask. At least one of `prompt` or\n * `source_image_urls` must be provided.\n *\n * @example\n * ```typescript\n * const client = new Gpt4oImageClient({ apiKey: 'your-api-key' });\n *\n * // Pure generation\n * const result = await client.textToImage.run({\n *   model: 'gpt-4o-image',\n *   prompt: 'A watercolor painting of a sunset',\n *   aspect_ratio: '3:2',\n * });\n *\n * // Edit with source images\n * const edited = await client.textToImage.run({\n *   model: 'gpt-4o-image',\n *   prompt: 'Add a rainbow',\n *   aspect_ratio: '3:2',\n *   source_image_urls: ['https://example.com/photo.jpg'],\n * });\n * ```\n */\nexport class Gpt4oImageClient extends BaseClient {\n  /** Image generation, editing, and inpainting operations. */\n  public readonly textToImage: TextToImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n  }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gpt_4o_image/text_to_image';\n\n/**\n * Generates images from a text prompt, optionally guided by source images and a mask.\n * For pure generation, provide a prompt. For editing, provide source_image_urls\n * (and optionally mask_url) to modify specific regions of the source.\n */\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<TextToImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<TextToImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n  }\n\n  /**\n   * Create a text-to-image task; returns immediately with a task id.\n   * @param params Text-to-image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: TextToImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text-to-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text-to-image status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { Gpt4oImageClient } from './client';\nexport * from './types';\n\n// Re-export core errors for convenience\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n  TaskTimeoutError,\n  TaskFailedError,\n} from '@runapi.ai/core';\n"],"mappings":";AAAA,SAAS,kBAAsC;;;ACC/C,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAGlC,IAAM,WAAW;AAOV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAyE;AAC5G,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,WAAO,kBAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzE,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQ,UAAU;AAAA,MAC7D,MAAM,cAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAG,QAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ADvBO,IAAM,mBAAN,cAA+B,WAAW;AAAA;AAAA,EAE/B;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAAA,EAC9C;AACF;;;AElCA;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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/gpt-4o-image",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "RunAPI GPT-4o Image SDK for JavaScript, Ruby, and Go",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -27,7 +27,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.5"
+    "@runapi.ai/core": "^0.2.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",