@runapi.ai/imagen-4 0.2.6 → 0.2.7

package/README.md

@@ -1,25 +1,25 @@
-# Imagen API JavaScript SDK for RunAPI
+# Imagen 4 API JavaScript SDK for RunAPI
 
-The imagen api JavaScript SDK is the language-specific package for Imagen 4 on RunAPI. Use this imagen api package for text-to-image, image editing, and creative production flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+The Imagen 4 JavaScript SDK is the language-specific package for Imagen 4 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 imagen api README is the JavaScript package guide inside the public `imagen4-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/imagen-4; for API reference, use https://runapi.ai/docs#imagen-4; for SDK docs, use https://runapi.ai/docs#sdk-imagen-4.
+This README is the JavaScript package guide inside the public `imagen-4-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/imagen-4; for API reference, use https://runapi.ai/docs#imagen-4; for SDK docs, use https://runapi.ai/docs#sdk-imagen-4.
 
 ## Install
 
 ```bash
-npm install @runapi.ai/imagen4
+npm install @runapi.ai/imagen-4
 ```
 
 ## Quick start
 
 ```typescript
-import { Imagen4Client } from '@runapi.ai/imagen4';
+import { Imagen4Client } from '@runapi.ai/imagen-4';
 
 const client = new Imagen4Client();
-const task = await client.generations.create({
+const task = await client.textToImage.create({
   // Pass the Imagen 4 JSON request body from https://runapi.ai/docs#imagen-4.
 });
-const status = await client.generations.get(task.id);
+const status = await client.textToImage.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.
@@ -28,7 +28,7 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 
 ## 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 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.js

@@ -43,6 +43,118 @@ 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": [
+      "imagen-4-pro-remix-image"
+    ],
+    "fields_by_model": {
+      "imagen-4-pro-remix-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "2:3",
+            "3:2",
+            "3:4",
+            "4:3",
+            "4:5",
+            "5:4",
+            "9:16",
+            "16:9",
+            "21:9",
+            "auto"
+          ]
+        },
+        "output_format": {
+          "enum": [
+            "png",
+            "jpg"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k",
+            "4k"
+          ]
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      }
+    }
+  },
+  "text-to-image": {
+    "models": [
+      "imagen-4",
+      "imagen-4-fast",
+      "imagen-4-ultra"
+    ],
+    "fields_by_model": {
+      "imagen-4": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "16:9",
+            "9:16",
+            "3:4",
+            "4:3"
+          ]
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "imagen-4-fast": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "16:9",
+            "9:16",
+            "3:4",
+            "4:3"
+          ]
+        },
+        "output_count": {
+          "enum": [
+            1,
+            2,
+            3,
+            4
+          ],
+          "type": "integer"
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "imagen-4-ultra": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "16:9",
+            "9:16",
+            "3:4",
+            "4:3"
+          ]
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-image.ts
 var ENDPOINT = "/api/v1/imagen_4/text_to_image";
 var TextToImage = class {
   constructor(http) {
@@ -69,8 +181,10 @@ var TextToImage = class {
    * @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
     });
   }
@@ -116,8 +230,10 @@ var RemixImage = class {
    * @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
     });
   }

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 { Imagen4Client } from './client';\nexport { TextToImage } from './resources/text-to-image';\nexport { RemixImage } from './resources/remix-image';\nexport type * from './types';\n\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 * Imagen 4 image generation API client.\n *\n * Three text-to-image quality tiers (imagen-4, imagen-4-fast, imagen-4-ultra)\n * and a dedicated remix model for guided image transformation from source images.\n *\n * @example\n * ```typescript\n * const client = new Imagen4Client({ apiKey: 'your-api-key' });\n *\n * const result = await client.textToImage.run({\n *   model: 'imagen-4',\n *   prompt: 'A cat in a spacesuit on the moon',\n * });\n * ```\n */\nexport class Imagen4Client extends BaseClient {\n  /** Text-to-image generation across three quality tiers. */\n  public readonly textToImage: TextToImage;\n  /** Generate new images guided by one or more source images combined with a text prompt. */\n  public readonly remixImage: RemixImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n    this.remixImage = new RemixImage(this.http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/text_to_image';\n\n/**\n * Generates images from a text prompt.\n * Three model tiers are available: imagen-4 (standard), imagen-4-fast (lower latency,\n * batch output up to 4 images), and imagen-4-ultra (highest quality).\n */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate images from a text prompt and wait until complete.\n   * @param params Text-to-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\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   * Generate images from a text prompt; 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 task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { RemixImageParams, RemixImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/remix_image';\n\n/**\n * Generates new images guided by 1-8 source images combined with a text prompt.\n * Supports output resolution control (1k/2k/4k) and format selection (png/jpg).\n */\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Transform source images guided by a text prompt and wait until complete.\n   * @param params Remix-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\n   */\n  async run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<RemixImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<RemixImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n  }\n\n  /**\n   * Transform source images guided by a text prompt; returns immediately with a task id.\n   * @param params Remix-image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a remix-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current remix-image task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<RemixImageResponse> {\n    return this.http.request<RemixImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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;;;ACpDA,IAAAC,eAA8B;AAC9B,IAAAC,mBAAkC;AAGlC,IAAMC,YAAW;AAMV,IAAM,aAAN,MAAiB;AAAA,EACtB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA0B,SAAwE;AAC1G,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,eAAO,oCAAsC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACxE,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA0B,SAAuD;AAC5F,WAAO,KAAK,KAAK,QAA4B,QAAQA,WAAU;AAAA,MAC7D,UAAM,4BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAuD;AAC3E,WAAO,KAAK,KAAK,QAA4B,OAAO,GAAGA,SAAQ,IAAI,EAAE,IAAI;AAAA,MACvE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhCO,IAAM,gBAAN,cAA4B,wBAAW;AAAA;AAAA,EAE5B;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,aAAa,IAAI,WAAW,KAAK,IAAI;AAAA,EAC5C;AACF;;;AD1BA,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 { Imagen4Client } from './client';\nexport { TextToImage } from './resources/text-to-image';\nexport { RemixImage } from './resources/remix-image';\nexport type * from './types';\n\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 * Imagen 4 image generation API client.\n *\n * Three text-to-image quality tiers (imagen-4, imagen-4-fast, imagen-4-ultra)\n * and a dedicated remix model for guided image transformation from source images.\n *\n * @example\n * ```typescript\n * const client = new Imagen4Client({ apiKey: 'your-api-key' });\n *\n * const result = await client.textToImage.run({\n *   model: 'imagen-4',\n *   prompt: 'A cat in a spacesuit on the moon',\n * });\n * ```\n */\nexport class Imagen4Client extends BaseClient {\n  /** Text-to-image generation across three quality tiers. */\n  public readonly textToImage: TextToImage;\n  /** Generate new images guided by one or more source images combined with a text prompt. */\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 { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/text_to_image';\n\n/**\n * Generates images from a text prompt.\n * Three model tiers are available: imagen-4 (standard), imagen-4-fast (lower latency,\n * batch output up to 4 images), and imagen-4-ultra (highest quality).\n */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate images from a text prompt and wait until complete.\n   * @param params Text-to-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\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   * Generate images from a text prompt; 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 task 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      \"imagen-4-pro-remix-image\"\n    ],\n    \"fields_by_model\": {\n      \"imagen-4-pro-remix-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"2:3\",\n            \"3:2\",\n            \"3:4\",\n            \"4:3\",\n            \"4:5\",\n            \"5:4\",\n            \"9:16\",\n            \"16:9\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"output_format\": {\n          \"enum\": [\n            \"png\",\n            \"jpg\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\",\n            \"4k\"\n          ]\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      }\n    }\n  },\n  \"text-to-image\": {\n    \"models\": [\n      \"imagen-4\",\n      \"imagen-4-fast\",\n      \"imagen-4-ultra\"\n    ],\n    \"fields_by_model\": {\n      \"imagen-4\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"16:9\",\n            \"9:16\",\n            \"3:4\",\n            \"4:3\"\n          ]\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"imagen-4-fast\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"16:9\",\n            \"9:16\",\n            \"3:4\",\n            \"4:3\"\n          ]\n        },\n        \"output_count\": {\n          \"enum\": [\n            1,\n            2,\n            3,\n            4\n          ],\n          \"type\": \"integer\"\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"imagen-4-ultra\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"16:9\",\n            \"9:16\",\n            \"3:4\",\n            \"4:3\"\n          ]\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"seed\": {\n          \"type\": \"integer\"\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 { RemixImageParams, RemixImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/remix_image';\n\n/**\n * Generates new images guided by 1-8 source images combined with a text prompt.\n * Supports output resolution control (1k/2k/4k) and format selection (png/jpg).\n */\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Transform source images guided by a text prompt and wait until complete.\n   * @param params Remix-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\n   */\n  async run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<RemixImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<RemixImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n  }\n\n  /**\n   * Transform source images guided by a text prompt; returns immediately with a task id.\n   * @param params Remix-image 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 a remix-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current remix-image task 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

@@ -2,8 +2,120 @@
 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": [
+      "imagen-4-pro-remix-image"
+    ],
+    "fields_by_model": {
+      "imagen-4-pro-remix-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "2:3",
+            "3:2",
+            "3:4",
+            "4:3",
+            "4:5",
+            "5:4",
+            "9:16",
+            "16:9",
+            "21:9",
+            "auto"
+          ]
+        },
+        "output_format": {
+          "enum": [
+            "png",
+            "jpg"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k",
+            "4k"
+          ]
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      }
+    }
+  },
+  "text-to-image": {
+    "models": [
+      "imagen-4",
+      "imagen-4-fast",
+      "imagen-4-ultra"
+    ],
+    "fields_by_model": {
+      "imagen-4": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "16:9",
+            "9:16",
+            "3:4",
+            "4:3"
+          ]
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "imagen-4-fast": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "16:9",
+            "9:16",
+            "3:4",
+            "4:3"
+          ]
+        },
+        "output_count": {
+          "enum": [
+            1,
+            2,
+            3,
+            4
+          ],
+          "type": "integer"
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "imagen-4-ultra": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "16:9",
+            "9:16",
+            "3:4",
+            "4:3"
+          ]
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-image.ts
 var ENDPOINT = "/api/v1/imagen_4/text_to_image";
 var TextToImage = class {
   constructor(http) {
@@ -30,8 +142,10 @@ var TextToImage = class {
    * @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
     });
   }
@@ -49,7 +163,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/imagen_4/remix_image";
 var RemixImage = class {
@@ -77,8 +191,10 @@ var RemixImage = class {
    * @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
     });
   }

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 { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\nimport { RemixImage } from './resources/remix-image';\n\n/**\n * Imagen 4 image generation API client.\n *\n * Three text-to-image quality tiers (imagen-4, imagen-4-fast, imagen-4-ultra)\n * and a dedicated remix model for guided image transformation from source images.\n *\n * @example\n * ```typescript\n * const client = new Imagen4Client({ apiKey: 'your-api-key' });\n *\n * const result = await client.textToImage.run({\n *   model: 'imagen-4',\n *   prompt: 'A cat in a spacesuit on the moon',\n * });\n * ```\n */\nexport class Imagen4Client extends BaseClient {\n  /** Text-to-image generation across three quality tiers. */\n  public readonly textToImage: TextToImage;\n  /** Generate new images guided by one or more source images combined with a text prompt. */\n  public readonly remixImage: RemixImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n    this.remixImage = new RemixImage(this.http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/text_to_image';\n\n/**\n * Generates images from a text prompt.\n * Three model tiers are available: imagen-4 (standard), imagen-4-fast (lower latency,\n * batch output up to 4 images), and imagen-4-ultra (highest quality).\n */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate images from a text prompt and wait until complete.\n   * @param params Text-to-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\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   * Generate images from a text prompt; 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 task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToImageResponse> {\n    return this.http.request<TextToImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type { RemixImageParams, RemixImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/remix_image';\n\n/**\n * Generates new images guided by 1-8 source images combined with a text prompt.\n * Supports output resolution control (1k/2k/4k) and format selection (png/jpg).\n */\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Transform source images guided by a text prompt and wait until complete.\n   * @param params Remix-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\n   */\n  async run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<RemixImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<RemixImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n  }\n\n  /**\n   * Transform source images guided by a text prompt; returns immediately with a task id.\n   * @param params Remix-image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result with id.\n   */\n  async create(params: RemixImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a remix-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current remix-image task 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 { Imagen4Client } from './client';\nexport { TextToImage } from './resources/text-to-image';\nexport { RemixImage } from './resources/remix-image';\nexport type * from './types';\n\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;;;ACpDA,SAAS,iBAAAA,sBAAqB;AAC9B,SAAS,qBAAAC,0BAAyB;AAGlC,IAAMC,YAAW;AAMV,IAAM,aAAN,MAAiB;AAAA,EACtB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA0B,SAAwE;AAC1G,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,WAAOD,mBAAsC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACxE,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA0B,SAAuD;AAC5F,WAAO,KAAK,KAAK,QAA4B,QAAQC,WAAU;AAAA,MAC7D,MAAMF,eAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAuD;AAC3E,WAAO,KAAK,KAAK,QAA4B,OAAO,GAAGE,SAAQ,IAAI,EAAE,IAAI;AAAA,MACvE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhCO,IAAM,gBAAN,cAA4B,WAAW;AAAA;AAAA,EAE5B;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,aAAa,IAAI,WAAW,KAAK,IAAI;AAAA,EAC5C;AACF;;;AG1BA;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 * Imagen 4 image generation API client.\n *\n * Three text-to-image quality tiers (imagen-4, imagen-4-fast, imagen-4-ultra)\n * and a dedicated remix model for guided image transformation from source images.\n *\n * @example\n * ```typescript\n * const client = new Imagen4Client({ apiKey: 'your-api-key' });\n *\n * const result = await client.textToImage.run({\n *   model: 'imagen-4',\n *   prompt: 'A cat in a spacesuit on the moon',\n * });\n * ```\n */\nexport class Imagen4Client extends BaseClient {\n  /** Text-to-image generation across three quality tiers. */\n  public readonly textToImage: TextToImage;\n  /** Generate new images guided by one or more source images combined with a text prompt. */\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 { TextToImageParams, TextToImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/text_to_image';\n\n/**\n * Generates images from a text prompt.\n * Three model tiers are available: imagen-4 (standard), imagen-4-fast (lower latency,\n * batch output up to 4 images), and imagen-4-ultra (highest quality).\n */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate images from a text prompt and wait until complete.\n   * @param params Text-to-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\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   * Generate images from a text prompt; 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 task 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      \"imagen-4-pro-remix-image\"\n    ],\n    \"fields_by_model\": {\n      \"imagen-4-pro-remix-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"2:3\",\n            \"3:2\",\n            \"3:4\",\n            \"4:3\",\n            \"4:5\",\n            \"5:4\",\n            \"9:16\",\n            \"16:9\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"output_format\": {\n          \"enum\": [\n            \"png\",\n            \"jpg\"\n          ]\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\",\n            \"4k\"\n          ]\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      }\n    }\n  },\n  \"text-to-image\": {\n    \"models\": [\n      \"imagen-4\",\n      \"imagen-4-fast\",\n      \"imagen-4-ultra\"\n    ],\n    \"fields_by_model\": {\n      \"imagen-4\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"16:9\",\n            \"9:16\",\n            \"3:4\",\n            \"4:3\"\n          ]\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"imagen-4-fast\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"16:9\",\n            \"9:16\",\n            \"3:4\",\n            \"4:3\"\n          ]\n        },\n        \"output_count\": {\n          \"enum\": [\n            1,\n            2,\n            3,\n            4\n          ],\n          \"type\": \"integer\"\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"imagen-4-ultra\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"16:9\",\n            \"9:16\",\n            \"3:4\",\n            \"4:3\"\n          ]\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"seed\": {\n          \"type\": \"integer\"\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 { RemixImageParams, RemixImageResponse, TaskCreateResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/imagen_4/remix_image';\n\n/**\n * Generates new images guided by 1-8 source images combined with a text prompt.\n * Supports output resolution control (1k/2k/4k) and format selection (png/jpg).\n */\nexport class RemixImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Transform source images guided by a text prompt and wait until complete.\n   * @param params Remix-image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed task with images.\n   */\n  async run(params: RemixImageParams, options?: RequestOptions & PollingOptions): Promise<RemixImageResponse> {\n    const { id } = await this.create(params, options);\n    return pollUntilComplete<RemixImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n  }\n\n  /**\n   * Transform source images guided by a text prompt; returns immediately with a task id.\n   * @param params Remix-image 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 a remix-image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current remix-image task 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 { Imagen4Client } from './client';\nexport { TextToImage } from './resources/text-to-image';\nexport { RemixImage } from './resources/remix-image';\nexport type * from './types';\n\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/imagen-4",
-  "version": "0.2.6",
-  "description": "RunAPI Imagen 4 SDK for JavaScript, Ruby, and Go",
+  "runapi": {
+    "slug": "imagen-4"
+  },
+  "version": "0.2.7",
+  "description": "RunAPI Imagen 4 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",
@@ -27,7 +30,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.6"
+    "@runapi.ai/core": "^0.2.7"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -46,8 +49,16 @@
     "api",
     "sdk",
     "typescript",
+    "python",
     "ruby",
-    "golang"
+    "golang",
+    "java",
+    "maven",
+    "gradle",
+    "image-generation",
+    "text-to-image",
+    "image-api",
+    "imagen-api"
   ],
   "author": "RunAPI",
   "license": "Apache-2.0",
@@ -55,5 +66,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/runapi-ai/imagen-4-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runapi-ai/imagen-4-sdk/issues"
   }
 }