@runapi.ai/seedream 0.2.6 → 0.2.8

package/README.md

@@ -1,8 +1,8 @@
-# Seedream API JavaScript SDK for RunAPI
+# Seedream JavaScript SDK for RunAPI
 
-The seedream api JavaScript SDK is the language-specific package for Seedream on RunAPI. Use this seedream 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 Seedream JavaScript SDK is the language-specific package for Seedream 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 seedream api README is the JavaScript package guide inside the public `seedream-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/seedream; for API reference, use https://runapi.ai/docs#seedream; for SDK docs, use https://runapi.ai/docs#sdk-seedream.
+This README is the JavaScript package guide inside the public `seedream-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/seedream; for API reference, use https://runapi.ai/docs#seedream; for SDK docs, use https://runapi.ai/docs#sdk-seedream.
 
 ## Install
 
@@ -28,6 +28,8 @@ 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.
 
+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 package exposes `textToImage` for text models and `editImage` for editing models. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

package/dist/index.d.mts

@@ -1,25 +1,44 @@
-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';
 
+/** Union of all Seedream model identifiers across text-to-image and edit endpoints. */
 type SeedreamModel = 'seedream-4.5-text-to-image' | 'seedream-4.5-edit' | 'seedream-5-lite-text-to-image' | 'seedream-5-lite-edit' | 'seedream-v4-text-to-image' | 'seedream-v4-edit';
+/** Models accepted by the text-to-image endpoint. */
 type TextToImageModel = 'seedream-4.5-text-to-image' | 'seedream-5-lite-text-to-image' | 'seedream-v4-text-to-image';
+/** Models accepted by the edit-image endpoint. */
 type EditImageModel = 'seedream-4.5-edit' | 'seedream-5-lite-edit' | 'seedream-v4-edit';
 type AspectRatio = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '2:3' | '3:2' | '21:9';
+/** Quality preset for 4.5 and 5-lite models. */
 type OutputQuality = 'basic' | 'high';
+/** Pixel resolution tier for V4 models. */
 type V4OutputResolution = '1k' | '2k' | '4k';
+/**
+ * Shared parameters for 4.5 and 5-lite models.
+ * Both `aspect_ratio` and `output_quality` are required for these model families.
+ */
 interface ImageGenerationBaseParams {
     prompt: string;
     aspect_ratio: AspectRatio;
     output_quality: OutputQuality;
+    /** Toggle content safety filtering. */
     enable_safety_checker?: boolean;
     callback_url?: string;
 }
+/**
+ * Shared parameters for V4 models.
+ * Uses `output_resolution` instead of `output_quality`, and supports
+ * reproducible generation via `seed` and batch output via `output_count`.
+ */
 interface V4GenerationBaseParams {
     prompt: string;
     aspect_ratio?: AspectRatio;
+    /** Output resolution tier (default: "1k"). */
     output_resolution?: V4OutputResolution;
+    /** Number of images to generate (default: 1). */
     output_count?: number;
+    /** Fixed seed for reproducible generation. */
     seed?: number;
+    /** Toggle content safety filtering. */
     enable_safety_checker?: boolean;
     callback_url?: string;
 }
@@ -28,6 +47,7 @@ interface Generation45TextParams extends ImageGenerationBaseParams {
 }
 interface Generation45EditImageParams extends ImageGenerationBaseParams {
     model: 'seedream-4.5-edit';
+    /** Source image URLs to edit (up to 14 for 4.5 models). */
     source_image_urls: string[];
 }
 interface Generation5LiteTextParams extends ImageGenerationBaseParams {
@@ -35,6 +55,7 @@ interface Generation5LiteTextParams extends ImageGenerationBaseParams {
 }
 interface Generation5LiteEditParams extends ImageGenerationBaseParams {
     model: 'seedream-5-lite-edit';
+    /** Source image URLs to edit (up to 14 for 5-lite models). */
     source_image_urls: string[];
 }
 interface GenerationV4TextParams extends V4GenerationBaseParams {
@@ -42,6 +63,7 @@ interface GenerationV4TextParams extends V4GenerationBaseParams {
 }
 interface GenerationV4EditParams extends V4GenerationBaseParams {
     model: 'seedream-v4-edit';
+    /** Source image URLs to edit (up to 10 for V4 models). */
     source_image_urls: string[];
 }
 type TextToImageParams = Generation45TextParams | Generation5LiteTextParams | GenerationV4TextParams;
@@ -49,6 +71,7 @@ type EditImageParams = Generation45EditImageParams | Generation5LiteEditParams |
 interface TaskCreateResponse {
     id: string;
 }
+/** A generated image with its CDN URL. */
 interface Image {
     url: string;
 }
@@ -74,24 +97,99 @@ type CompletedEditImageResponse = EditImageResponse & {
     images: Image[];
 };
 
+/**
+ * Generates images from text prompts across Seedream model versions.
+ * Field requirements vary by model family: 4.5/5-lite require `aspect_ratio`
+ * and `output_quality`; V4 uses `output_resolution` and supports `seed`/`output_count`.
+ */
 declare class TextToImage {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create a text to image task and wait until complete.
+     * @param params Text to image parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text to image response.
+     */
     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.
+     */
     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 task status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToImageResponse>;
 }
 
+/**
+ * Modifies source images according to a text prompt.
+ * V4 models accept up to 10 source images; 4.5 and 5-lite accept up to 14.
+ */
 declare class EditImage {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create an edit image task and wait until complete.
+     * @param params Edit image parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed edit image response.
+     */
     run(params: EditImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditImageResponse>;
+    /**
+     * Create an edit image task; returns immediately with a task id.
+     * @param params Edit image parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result.
+     */
     create(params: EditImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an edit image task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current edit image task status.
+     */
     get(id: string, options?: RequestOptions): Promise<EditImageResponse>;
 }
 
-declare class SeedreamClient {
+/**
+ * Seedream image generation and editing API client.
+ *
+ * Three model families with different field requirements:
+ * - **4.5**: requires `aspect_ratio` and `output_quality`
+ * - **5-lite**: same required fields as 4.5, faster generation
+ * - **V4**: uses `output_resolution` instead; supports `seed` and batch `output_count`
+ *
+ * @example
+ * ```typescript
+ * const client = new SeedreamClient({ apiKey: 'your-api-key' });
+ *
+ * // Seedream 4.5
+ * const result = await client.textToImage.run({
+ *   model: 'seedream-4.5-text-to-image',
+ *   prompt: 'A beautiful product render',
+ *   aspect_ratio: '16:9',
+ *   output_quality: 'high',
+ * });
+ *
+ * // Seedream V4 with batch output
+ * const batch = await client.textToImage.run({
+ *   model: 'seedream-v4-text-to-image',
+ *   prompt: 'Minimalist logo design',
+ *   output_count: 4,
+ * });
+ * ```
+ */
+declare class SeedreamClient extends BaseClient {
+    /** Text-to-image generation across Seedream model versions. */
     readonly textToImage: TextToImage;
+    /** Edit source images according to a text prompt. */
     readonly editImage: EditImage;
     constructor(options?: ClientOptions);
 }

package/dist/index.d.ts

@@ -1,25 +1,44 @@
-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';
 
+/** Union of all Seedream model identifiers across text-to-image and edit endpoints. */
 type SeedreamModel = 'seedream-4.5-text-to-image' | 'seedream-4.5-edit' | 'seedream-5-lite-text-to-image' | 'seedream-5-lite-edit' | 'seedream-v4-text-to-image' | 'seedream-v4-edit';
+/** Models accepted by the text-to-image endpoint. */
 type TextToImageModel = 'seedream-4.5-text-to-image' | 'seedream-5-lite-text-to-image' | 'seedream-v4-text-to-image';
+/** Models accepted by the edit-image endpoint. */
 type EditImageModel = 'seedream-4.5-edit' | 'seedream-5-lite-edit' | 'seedream-v4-edit';
 type AspectRatio = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '2:3' | '3:2' | '21:9';
+/** Quality preset for 4.5 and 5-lite models. */
 type OutputQuality = 'basic' | 'high';
+/** Pixel resolution tier for V4 models. */
 type V4OutputResolution = '1k' | '2k' | '4k';
+/**
+ * Shared parameters for 4.5 and 5-lite models.
+ * Both `aspect_ratio` and `output_quality` are required for these model families.
+ */
 interface ImageGenerationBaseParams {
     prompt: string;
     aspect_ratio: AspectRatio;
     output_quality: OutputQuality;
+    /** Toggle content safety filtering. */
     enable_safety_checker?: boolean;
     callback_url?: string;
 }
+/**
+ * Shared parameters for V4 models.
+ * Uses `output_resolution` instead of `output_quality`, and supports
+ * reproducible generation via `seed` and batch output via `output_count`.
+ */
 interface V4GenerationBaseParams {
     prompt: string;
     aspect_ratio?: AspectRatio;
+    /** Output resolution tier (default: "1k"). */
     output_resolution?: V4OutputResolution;
+    /** Number of images to generate (default: 1). */
     output_count?: number;
+    /** Fixed seed for reproducible generation. */
     seed?: number;
+    /** Toggle content safety filtering. */
     enable_safety_checker?: boolean;
     callback_url?: string;
 }
@@ -28,6 +47,7 @@ interface Generation45TextParams extends ImageGenerationBaseParams {
 }
 interface Generation45EditImageParams extends ImageGenerationBaseParams {
     model: 'seedream-4.5-edit';
+    /** Source image URLs to edit (up to 14 for 4.5 models). */
     source_image_urls: string[];
 }
 interface Generation5LiteTextParams extends ImageGenerationBaseParams {
@@ -35,6 +55,7 @@ interface Generation5LiteTextParams extends ImageGenerationBaseParams {
 }
 interface Generation5LiteEditParams extends ImageGenerationBaseParams {
     model: 'seedream-5-lite-edit';
+    /** Source image URLs to edit (up to 14 for 5-lite models). */
     source_image_urls: string[];
 }
 interface GenerationV4TextParams extends V4GenerationBaseParams {
@@ -42,6 +63,7 @@ interface GenerationV4TextParams extends V4GenerationBaseParams {
 }
 interface GenerationV4EditParams extends V4GenerationBaseParams {
     model: 'seedream-v4-edit';
+    /** Source image URLs to edit (up to 10 for V4 models). */
     source_image_urls: string[];
 }
 type TextToImageParams = Generation45TextParams | Generation5LiteTextParams | GenerationV4TextParams;
@@ -49,6 +71,7 @@ type EditImageParams = Generation45EditImageParams | Generation5LiteEditParams |
 interface TaskCreateResponse {
     id: string;
 }
+/** A generated image with its CDN URL. */
 interface Image {
     url: string;
 }
@@ -74,24 +97,99 @@ type CompletedEditImageResponse = EditImageResponse & {
     images: Image[];
 };
 
+/**
+ * Generates images from text prompts across Seedream model versions.
+ * Field requirements vary by model family: 4.5/5-lite require `aspect_ratio`
+ * and `output_quality`; V4 uses `output_resolution` and supports `seed`/`output_count`.
+ */
 declare class TextToImage {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create a text to image task and wait until complete.
+     * @param params Text to image parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text to image response.
+     */
     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.
+     */
     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 task status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToImageResponse>;
 }
 
+/**
+ * Modifies source images according to a text prompt.
+ * V4 models accept up to 10 source images; 4.5 and 5-lite accept up to 14.
+ */
 declare class EditImage {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create an edit image task and wait until complete.
+     * @param params Edit image parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed edit image response.
+     */
     run(params: EditImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditImageResponse>;
+    /**
+     * Create an edit image task; returns immediately with a task id.
+     * @param params Edit image parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result.
+     */
     create(params: EditImageParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an edit image task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current edit image task status.
+     */
     get(id: string, options?: RequestOptions): Promise<EditImageResponse>;
 }
 
-declare class SeedreamClient {
+/**
+ * Seedream image generation and editing API client.
+ *
+ * Three model families with different field requirements:
+ * - **4.5**: requires `aspect_ratio` and `output_quality`
+ * - **5-lite**: same required fields as 4.5, faster generation
+ * - **V4**: uses `output_resolution` instead; supports `seed` and batch `output_count`
+ *
+ * @example
+ * ```typescript
+ * const client = new SeedreamClient({ apiKey: 'your-api-key' });
+ *
+ * // Seedream 4.5
+ * const result = await client.textToImage.run({
+ *   model: 'seedream-4.5-text-to-image',
+ *   prompt: 'A beautiful product render',
+ *   aspect_ratio: '16:9',
+ *   output_quality: 'high',
+ * });
+ *
+ * // Seedream V4 with batch output
+ * const batch = await client.textToImage.run({
+ *   model: 'seedream-v4-text-to-image',
+ *   prompt: 'Minimalist logo design',
+ *   output_count: 4,
+ * });
+ * ```
+ */
+declare class SeedreamClient extends BaseClient {
+    /** Text-to-image generation across Seedream model versions. */
     readonly textToImage: TextToImage;
+    /** Edit source images according to a text prompt. */
     readonly editImage: EditImage;
     constructor(options?: ClientOptions);
 }

package/dist/index.js

@@ -41,12 +41,233 @@ 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 = {
+  "edit-image": {
+    "models": [
+      "seedream-4.5-edit",
+      "seedream-5-lite-edit",
+      "seedream-v4-edit"
+    ],
+    "fields_by_model": {
+      "seedream-4.5-edit": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      },
+      "seedream-5-lite-edit": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      },
+      "seedream-v4-edit": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "3:2",
+            "2:3",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "output_count": {
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k",
+            "4k"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      }
+    }
+  },
+  "text-to-image": {
+    "models": [
+      "seedream-4.5-text-to-image",
+      "seedream-5-lite-text-to-image",
+      "seedream-v4-text-to-image"
+    ],
+    "fields_by_model": {
+      "seedream-4.5-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedream-5-lite-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedream-v4-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "3:2",
+            "2:3",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "output_count": {
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k",
+            "4k"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-image.ts
 var ENDPOINT = "/api/v1/seedream/text_to_image";
 var TextToImage = class {
   constructor(http) {
     this.http = http;
   }
   http;
+  /**
+   * Create a text to image task and wait until complete.
+   * @param params Text to image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text to image response.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await (0, import_internal.pollUntilComplete)(() => this.get(id, options), {
@@ -55,12 +276,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.
+   */
   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 task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -77,6 +312,12 @@ var EditImage = class {
     this.http = http;
   }
   http;
+  /**
+   * Create an edit image task and wait until complete.
+   * @param params Edit image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed edit image response.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await (0, import_internal2.pollUntilComplete)(() => this.get(id, options), {
@@ -85,12 +326,26 @@ var EditImage = class {
     });
     return response;
   }
+  /**
+   * Create an edit image task; returns immediately with a task id.
+   * @param params Edit image parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result.
+   */
   async create(params, options) {
+    const body = (0, import_core2.compactParams)(params);
+    (0, import_core2.validateParams)(contract["edit-image"], body);
     return this.http.request("POST", ENDPOINT2, {
-      body: (0, import_core2.compactParams)(params),
+      body,
       ...options
     });
   }
+  /**
+   * Fetch the current status of an edit image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current edit image task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT2}/${id}`, {
       ...options
@@ -99,13 +354,15 @@ var EditImage = class {
 };
 
 // src/client.ts
-var SeedreamClient = class {
+var SeedreamClient = class extends import_core3.BaseClient {
+  /** Text-to-image generation across Seedream model versions. */
   textToImage;
+  /** Edit source images according to a text prompt. */
   editImage;
   constructor(options = {}) {
-    const http = (0, import_core3.createHttpClient)(options);
-    this.textToImage = new TextToImage(http);
-    this.editImage = new EditImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
+    this.editImage = new EditImage(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/edit-image.ts"],"sourcesContent":["export { SeedreamClient } from './client';\nexport * 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 { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\nimport { EditImage } from './resources/edit-image';\n\nexport class SeedreamClient {\n  public readonly textToImage: TextToImage;\n  public readonly editImage: EditImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n    this.editImage = new EditImage(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/seedream/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  CompletedEditImageResponse,\n  EditImageParams,\n  EditImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedream/edit_image';\n\nexport class EditImage {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: EditImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<EditImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedEditImageResponse;\n  }\n\n  async create(params: EditImageParams, 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<EditImageResponse> {\n    return this.http.request<EditImageResponse>('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,YAAN,MAAgB;AAAA,EACrB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAAyB,SAAgF;AACjH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,UAAM,oCAAqC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACvF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,QAAyB,SAAuD;AAC3F,WAAO,KAAK,KAAK,QAA4B,QAAQA,WAAU;AAAA,MAC7D,UAAM,4BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,IAAY,SAAsD;AAC1E,WAAO,KAAK,KAAK,QAA2B,OAAO,GAAGA,SAAQ,IAAI,EAAE,IAAI;AAAA,MACtE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhCO,IAAM,iBAAN,MAAqB;AAAA,EACV;AAAA,EACA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,WAAO,+BAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AACvC,SAAK,YAAY,IAAI,UAAU,IAAI;AAAA,EACrC;AACF;;;ADVA,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/edit-image.ts"],"sourcesContent":["export { SeedreamClient } from './client';\nexport * 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 { EditImage } from './resources/edit-image';\n\n/**\n * Seedream image generation and editing API client.\n *\n * Three model families with different field requirements:\n * - **4.5**: requires `aspect_ratio` and `output_quality`\n * - **5-lite**: same required fields as 4.5, faster generation\n * - **V4**: uses `output_resolution` instead; supports `seed` and batch `output_count`\n *\n * @example\n * ```typescript\n * const client = new SeedreamClient({ apiKey: 'your-api-key' });\n *\n * // Seedream 4.5\n * const result = await client.textToImage.run({\n *   model: 'seedream-4.5-text-to-image',\n *   prompt: 'A beautiful product render',\n *   aspect_ratio: '16:9',\n *   output_quality: 'high',\n * });\n *\n * // Seedream V4 with batch output\n * const batch = await client.textToImage.run({\n *   model: 'seedream-v4-text-to-image',\n *   prompt: 'Minimalist logo design',\n *   output_count: 4,\n * });\n * ```\n */\nexport class SeedreamClient extends BaseClient {\n  /** Text-to-image generation across Seedream model versions. */\n  public readonly textToImage: TextToImage;\n  /** Edit source images according to a text prompt. */\n  public readonly editImage: EditImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n    this.editImage = new EditImage(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/seedream/text_to_image';\n\n/**\n * Generates images from text prompts across Seedream model versions.\n * Field requirements vary by model family: 4.5/5-lite require `aspect_ratio`\n * and `output_quality`; V4 uses `output_resolution` and supports `seed`/`output_count`.\n */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Create a text to image task 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 response.\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.\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  \"edit-image\": {\n    \"models\": [\n      \"seedream-4.5-edit\",\n      \"seedream-5-lite-edit\",\n      \"seedream-v4-edit\"\n    ],\n    \"fields_by_model\": {\n      \"seedream-4.5-edit\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      },\n      \"seedream-5-lite-edit\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      },\n      \"seedream-v4-edit\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"3:2\",\n            \"2:3\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"output_count\": {\n          \"enum\": [\n            1,\n            2,\n            3,\n            4,\n            5,\n            6\n          ],\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\",\n            \"4k\"\n          ]\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      }\n    }\n  },\n  \"text-to-image\": {\n    \"models\": [\n      \"seedream-4.5-text-to-image\",\n      \"seedream-5-lite-text-to-image\",\n      \"seedream-v4-text-to-image\"\n    ],\n    \"fields_by_model\": {\n      \"seedream-4.5-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedream-5-lite-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedream-v4-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"3:2\",\n            \"2:3\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"output_count\": {\n          \"enum\": [\n            1,\n            2,\n            3,\n            4,\n            5,\n            6\n          ],\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\",\n            \"4k\"\n          ]\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 {\n  CompletedEditImageResponse,\n  EditImageParams,\n  EditImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedream/edit_image';\n\n/**\n * Modifies source images according to a text prompt.\n * V4 models accept up to 10 source images; 4.5 and 5-lite accept up to 14.\n */\nexport class EditImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Create an edit image task and wait until complete.\n   * @param params Edit image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed edit image response.\n   */\n  async run(params: EditImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<EditImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedEditImageResponse;\n  }\n\n  /**\n   * Create an edit image task; returns immediately with a task id.\n   * @param params Edit image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result.\n   */\n  async create(params: EditImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    const body = compactParams(params);\n    validateParams(contract['edit-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 edit image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current edit image task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<EditImageResponse> {\n    return this.http.request<EditImageResponse>('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,236 @@
 // 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 = {
+  "edit-image": {
+    "models": [
+      "seedream-4.5-edit",
+      "seedream-5-lite-edit",
+      "seedream-v4-edit"
+    ],
+    "fields_by_model": {
+      "seedream-4.5-edit": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      },
+      "seedream-5-lite-edit": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      },
+      "seedream-v4-edit": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "3:2",
+            "2:3",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "output_count": {
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k",
+            "4k"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_image_urls": {
+          "required": true
+        }
+      }
+    }
+  },
+  "text-to-image": {
+    "models": [
+      "seedream-4.5-text-to-image",
+      "seedream-5-lite-text-to-image",
+      "seedream-v4-text-to-image"
+    ],
+    "fields_by_model": {
+      "seedream-4.5-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedream-5-lite-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "2:3",
+            "3:2",
+            "21:9"
+          ],
+          "required": true
+        },
+        "output_count": {
+          "type": "integer"
+        },
+        "output_quality": {
+          "enum": [
+            "basic",
+            "high"
+          ],
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedream-v4-text-to-image": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "3:2",
+            "2:3",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "output_count": {
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "1k",
+            "2k",
+            "4k"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-image.ts
 var ENDPOINT = "/api/v1/seedream/text_to_image";
 var TextToImage = class {
   constructor(http) {
     this.http = http;
   }
   http;
+  /**
+   * Create a text to image task and wait until complete.
+   * @param params Text to image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text to image response.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete(() => this.get(id, options), {
@@ -18,12 +239,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.
+   */
   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 task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -32,7 +267,7 @@ var TextToImage = class {
 };
 
 // src/resources/edit-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/seedream/edit_image";
 var EditImage = class {
@@ -40,6 +275,12 @@ var EditImage = class {
     this.http = http;
   }
   http;
+  /**
+   * Create an edit image task and wait until complete.
+   * @param params Edit image parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed edit image response.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete2(() => this.get(id, options), {
@@ -48,12 +289,26 @@ var EditImage = class {
     });
     return response;
   }
+  /**
+   * Create an edit image task; returns immediately with a task id.
+   * @param params Edit image parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result.
+   */
   async create(params, options) {
+    const body = compactParams2(params);
+    validateParams2(contract["edit-image"], body);
     return this.http.request("POST", ENDPOINT2, {
-      body: compactParams2(params),
+      body,
       ...options
     });
   }
+  /**
+   * Fetch the current status of an edit image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current edit image task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT2}/${id}`, {
       ...options
@@ -62,13 +317,15 @@ var EditImage = class {
 };
 
 // src/client.ts
-var SeedreamClient = class {
+var SeedreamClient = class extends BaseClient {
+  /** Text-to-image generation across Seedream model versions. */
   textToImage;
+  /** Edit source images according to a text prompt. */
   editImage;
   constructor(options = {}) {
-    const http = createHttpClient(options);
-    this.textToImage = new TextToImage(http);
-    this.editImage = new EditImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
+    this.editImage = new EditImage(this.http);
   }
 };
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/resources/text-to-image.ts","../src/resources/edit-image.ts","../src/index.ts"],"sourcesContent":["import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\nimport { EditImage } from './resources/edit-image';\n\nexport class SeedreamClient {\n  public readonly textToImage: TextToImage;\n  public readonly editImage: EditImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n    this.editImage = new EditImage(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/seedream/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  CompletedEditImageResponse,\n  EditImageParams,\n  EditImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedream/edit_image';\n\nexport class EditImage {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: EditImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<EditImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedEditImageResponse;\n  }\n\n  async create(params: EditImageParams, 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<EditImageResponse> {\n    return this.http.request<EditImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { SeedreamClient } from './client';\nexport * 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,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,YAAN,MAAgB;AAAA,EACrB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAAyB,SAAgF;AACjH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,MAAMD,mBAAqC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACvF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,QAAyB,SAAuD;AAC3F,WAAO,KAAK,KAAK,QAA4B,QAAQC,WAAU;AAAA,MAC7D,MAAMF,eAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,IAAY,SAAsD;AAC1E,WAAO,KAAK,KAAK,QAA2B,OAAO,GAAGE,SAAQ,IAAI,EAAE,IAAI;AAAA,MACtE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AFhCO,IAAM,iBAAN,MAAqB;AAAA,EACV;AAAA,EACA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO,iBAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AACvC,SAAK,YAAY,IAAI,UAAU,IAAI;AAAA,EACrC;AACF;;;AGVA;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/edit-image.ts","../src/index.ts"],"sourcesContent":["import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\nimport { EditImage } from './resources/edit-image';\n\n/**\n * Seedream image generation and editing API client.\n *\n * Three model families with different field requirements:\n * - **4.5**: requires `aspect_ratio` and `output_quality`\n * - **5-lite**: same required fields as 4.5, faster generation\n * - **V4**: uses `output_resolution` instead; supports `seed` and batch `output_count`\n *\n * @example\n * ```typescript\n * const client = new SeedreamClient({ apiKey: 'your-api-key' });\n *\n * // Seedream 4.5\n * const result = await client.textToImage.run({\n *   model: 'seedream-4.5-text-to-image',\n *   prompt: 'A beautiful product render',\n *   aspect_ratio: '16:9',\n *   output_quality: 'high',\n * });\n *\n * // Seedream V4 with batch output\n * const batch = await client.textToImage.run({\n *   model: 'seedream-v4-text-to-image',\n *   prompt: 'Minimalist logo design',\n *   output_count: 4,\n * });\n * ```\n */\nexport class SeedreamClient extends BaseClient {\n  /** Text-to-image generation across Seedream model versions. */\n  public readonly textToImage: TextToImage;\n  /** Edit source images according to a text prompt. */\n  public readonly editImage: EditImage;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToImage = new TextToImage(this.http);\n    this.editImage = new EditImage(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/seedream/text_to_image';\n\n/**\n * Generates images from text prompts across Seedream model versions.\n * Field requirements vary by model family: 4.5/5-lite require `aspect_ratio`\n * and `output_quality`; V4 uses `output_resolution` and supports `seed`/`output_count`.\n */\nexport class TextToImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Create a text to image task 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 response.\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.\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  \"edit-image\": {\n    \"models\": [\n      \"seedream-4.5-edit\",\n      \"seedream-5-lite-edit\",\n      \"seedream-v4-edit\"\n    ],\n    \"fields_by_model\": {\n      \"seedream-4.5-edit\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      },\n      \"seedream-5-lite-edit\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      },\n      \"seedream-v4-edit\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"3:2\",\n            \"2:3\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"output_count\": {\n          \"enum\": [\n            1,\n            2,\n            3,\n            4,\n            5,\n            6\n          ],\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\",\n            \"4k\"\n          ]\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        },\n        \"source_image_urls\": {\n          \"required\": true\n        }\n      }\n    }\n  },\n  \"text-to-image\": {\n    \"models\": [\n      \"seedream-4.5-text-to-image\",\n      \"seedream-5-lite-text-to-image\",\n      \"seedream-v4-text-to-image\"\n    ],\n    \"fields_by_model\": {\n      \"seedream-4.5-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedream-5-lite-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"2:3\",\n            \"3:2\",\n            \"21:9\"\n          ],\n          \"required\": true\n        },\n        \"output_count\": {\n          \"type\": \"integer\"\n        },\n        \"output_quality\": {\n          \"enum\": [\n            \"basic\",\n            \"high\"\n          ],\n          \"required\": true\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedream-v4-text-to-image\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"3:2\",\n            \"2:3\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"output_count\": {\n          \"enum\": [\n            1,\n            2,\n            3,\n            4,\n            5,\n            6\n          ],\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"1k\",\n            \"2k\",\n            \"4k\"\n          ]\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 {\n  CompletedEditImageResponse,\n  EditImageParams,\n  EditImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedream/edit_image';\n\n/**\n * Modifies source images according to a text prompt.\n * V4 models accept up to 10 source images; 4.5 and 5-lite accept up to 14.\n */\nexport class EditImage {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Create an edit image task and wait until complete.\n   * @param params Edit image parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed edit image response.\n   */\n  async run(params: EditImageParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditImageResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<EditImageResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedEditImageResponse;\n  }\n\n  /**\n   * Create an edit image task; returns immediately with a task id.\n   * @param params Edit image parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result.\n   */\n  async create(params: EditImageParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    const body = compactParams(params);\n    validateParams(contract['edit-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 edit image task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current edit image task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<EditImageResponse> {\n    return this.http.request<EditImageResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { SeedreamClient } from './client';\nexport * 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/seedream",
-  "version": "0.2.6",
-  "description": "RunAPI Seedream SDK for JavaScript, Ruby, and Go",
+  "runapi": {
+    "slug": "seedream"
+  },
+  "version": "0.2.8",
+  "description": "RunAPI Seedream SDK for text-to-image and edit-image workflows in JavaScript, Python, Ruby, Go, Java, and PHP",
   "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.11"
   },
   "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",
+    "seedream-api"
   ],
   "author": "RunAPI",
   "license": "Apache-2.0",
@@ -56,5 +67,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/runapi-ai/seedream-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runapi-ai/seedream-sdk/issues"
   }
 }

package/skills/seedream/README.md

@@ -80,9 +80,11 @@ const url = result.images[0].url;
 
 ## 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 seedream 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/seedream/SKILL.md

@@ -25,14 +25,24 @@ metadata:
 
 Generate and edit images with Seedream through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
 
-## Routing decision
+## Critical: Integration Runtime
 
-- One-off generation, editing, or transformation for the user → use the **CLI path** with the `runapi` binary.
-- Building an app, backend, worker, library, or production codebase → use the **SDK integration path**.
+- Integration work (app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production codebase) uses the **SDK integration path** for the target language.
+- One-off generation, editing, transformation, manual smoke tests, debugging, or user-requested CLI runs use the **CLI path** with the `runapi` binary. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill.
+- Never shell out to the `runapi` CLI as the production runtime integration layer.
+
+## SDK integration path
+
+When integrating Seedream 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/seedream`
+- PHP: `runapi-ai/seedream`
+- Ruby: `runapi-seedream`
+- Go: `github.com/runapi-ai/seedream-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:
 
@@ -81,13 +91,9 @@ Common request shapes:
 }
 ```
 
-## SDK integration path
-
-When integrating Seedream into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:
+## Generated file storage
 
-- JavaScript / TypeScript: `@runapi.ai/seedream`
-- Ruby: `runapi-seedream`
-- Go: `github.com/runapi-ai/seedream-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