@runapi.ai/seedream 0.2.4 → 0.2.7

package/README.md

@@ -1,6 +1,6 @@
 # Seedream API 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-to-image, edit, and creative production flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+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.
 
 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.
 
@@ -16,25 +16,30 @@ npm install @runapi.ai/seedream
 import { SeedreamClient } from '@runapi.ai/seedream';
 
 const client = new SeedreamClient();
-const task = await client.generations.create({
-  // Pass the Seedream JSON request body from https://runapi.ai/docs#seedream.
+const task = await client.textToImage.create({
+  model: 'seedream-v4-text-to-image',
+  prompt: 'A precise product render of a glass teapot on white marble',
+  aspect_ratio: '16:9',
+  output_resolution: '2k',
+  output_count: 3,
 });
-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.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## Language notes
 
-Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building image applications. The available resources include generations. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+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.
 
 ## Links
 
 - Model page: https://runapi.ai/models/seedream
 - SDK docs: https://runapi.ai/docs#sdk-seedream
 - Product docs: https://runapi.ai/docs#seedream
-- Pricing and rate limits: https://runapi.ai/models/seedream/4.5-text-to-image
-- Provider comparison: https://runapi.ai/providers/bytedance
+- Pricing and rate limits: https://runapi.ai/models/seedream/v4-text-to-image
 - Full catalog: https://runapi.ai/models
 - Repository: https://github.com/runapi-ai/seedream-sdk
 

package/dist/index.d.mts

@@ -1,35 +1,77 @@
-import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, ClientOptions } from '@runapi.ai/core';
+import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, BaseClient, ClientOptions } from '@runapi.ai/core';
 export { AuthenticationError, InsufficientCreditsError, NetworkError, NotFoundError, RateLimitError, RunApiError, ServiceUnavailableError, TaskFailedError, TaskTimeoutError, TimeoutError, ValidationError } from '@runapi.ai/core';
 
-type SeedreamModel = 'seedream-4.5-text-to-image' | 'seedream-4.5-edit' | 'seedream-5-lite-text-to-image' | 'seedream-5-lite-image-to-image';
+/** 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';
-type Quality = 'basic' | 'high';
-interface GenerationBaseParams {
+/** 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;
-    quality: Quality;
+    output_quality: OutputQuality;
+    /** Toggle content safety filtering. */
+    enable_safety_checker?: boolean;
     callback_url?: string;
 }
-interface Generation45TextParams extends GenerationBaseParams {
+/**
+ * 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;
+}
+interface Generation45TextParams extends ImageGenerationBaseParams {
     model: 'seedream-4.5-text-to-image';
 }
-interface Generation45EditImageParams extends GenerationBaseParams {
+interface Generation45EditImageParams extends ImageGenerationBaseParams {
     model: 'seedream-4.5-edit';
-    image_urls: string[];
+    /** Source image URLs to edit (up to 14 for 4.5 models). */
+    source_image_urls: string[];
 }
-interface Generation5LiteTextParams extends GenerationBaseParams {
+interface Generation5LiteTextParams extends ImageGenerationBaseParams {
     model: 'seedream-5-lite-text-to-image';
-    nsfw_checker?: boolean;
 }
-interface Generation5LiteImageParams extends GenerationBaseParams {
-    model: 'seedream-5-lite-image-to-image';
-    image_urls: string[];
-    nsfw_checker?: boolean;
+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 {
+    model: 'seedream-v4-text-to-image';
+}
+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 | Generation45EditImageParams | Generation5LiteTextParams | Generation5LiteImageParams;
+type TextToImageParams = Generation45TextParams | Generation5LiteTextParams | GenerationV4TextParams;
+type EditImageParams = Generation45EditImageParams | Generation5LiteEditParams | GenerationV4EditParams;
 interface TaskCreateResponse {
     id: string;
 }
+/** A generated image with its CDN URL. */
 interface Image {
     url: string;
 }
@@ -40,6 +82,7 @@ interface TextToImageResponse {
     error?: string;
     [key: string]: unknown;
 }
+type EditImageResponse = TextToImageResponse;
 /**
  * Resolved response returned by the `run()` method after polling sees
  * `status: 'completed'`. Narrows the base response so `images` is
@@ -49,18 +92,106 @@ type CompletedTextToImageResponse = TextToImageResponse & {
     status: 'completed';
     images: Image[];
 };
+type CompletedEditImageResponse = EditImageResponse & {
+    status: 'completed';
+    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>;
 }
 
-declare class SeedreamClient {
+/**
+ * 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>;
+}
+
+/**
+ * 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);
 }
 
-export { type AspectRatio, type CompletedTextToImageResponse, type Generation45EditImageParams, type Generation45TextParams, type Generation5LiteImageParams, type Generation5LiteTextParams, type Image, type Quality, SeedreamClient, type SeedreamModel, type TaskCreateResponse, type TextToImageParams, type TextToImageResponse };
+export { type AspectRatio, type CompletedEditImageResponse, type CompletedTextToImageResponse, type EditImageModel, type EditImageParams, type EditImageResponse, type Generation45EditImageParams, type Generation45TextParams, type Generation5LiteEditParams, type Generation5LiteTextParams, type GenerationV4EditParams, type GenerationV4TextParams, type Image, type OutputQuality, SeedreamClient, type SeedreamModel, type TaskCreateResponse, type TextToImageModel, type TextToImageParams, type TextToImageResponse, type V4OutputResolution };

package/dist/index.d.ts

@@ -1,35 +1,77 @@
-import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, ClientOptions } from '@runapi.ai/core';
+import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, BaseClient, ClientOptions } from '@runapi.ai/core';
 export { AuthenticationError, InsufficientCreditsError, NetworkError, NotFoundError, RateLimitError, RunApiError, ServiceUnavailableError, TaskFailedError, TaskTimeoutError, TimeoutError, ValidationError } from '@runapi.ai/core';
 
-type SeedreamModel = 'seedream-4.5-text-to-image' | 'seedream-4.5-edit' | 'seedream-5-lite-text-to-image' | 'seedream-5-lite-image-to-image';
+/** 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';
-type Quality = 'basic' | 'high';
-interface GenerationBaseParams {
+/** 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;
-    quality: Quality;
+    output_quality: OutputQuality;
+    /** Toggle content safety filtering. */
+    enable_safety_checker?: boolean;
     callback_url?: string;
 }
-interface Generation45TextParams extends GenerationBaseParams {
+/**
+ * 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;
+}
+interface Generation45TextParams extends ImageGenerationBaseParams {
     model: 'seedream-4.5-text-to-image';
 }
-interface Generation45EditImageParams extends GenerationBaseParams {
+interface Generation45EditImageParams extends ImageGenerationBaseParams {
     model: 'seedream-4.5-edit';
-    image_urls: string[];
+    /** Source image URLs to edit (up to 14 for 4.5 models). */
+    source_image_urls: string[];
 }
-interface Generation5LiteTextParams extends GenerationBaseParams {
+interface Generation5LiteTextParams extends ImageGenerationBaseParams {
     model: 'seedream-5-lite-text-to-image';
-    nsfw_checker?: boolean;
 }
-interface Generation5LiteImageParams extends GenerationBaseParams {
-    model: 'seedream-5-lite-image-to-image';
-    image_urls: string[];
-    nsfw_checker?: boolean;
+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 {
+    model: 'seedream-v4-text-to-image';
+}
+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 | Generation45EditImageParams | Generation5LiteTextParams | Generation5LiteImageParams;
+type TextToImageParams = Generation45TextParams | Generation5LiteTextParams | GenerationV4TextParams;
+type EditImageParams = Generation45EditImageParams | Generation5LiteEditParams | GenerationV4EditParams;
 interface TaskCreateResponse {
     id: string;
 }
+/** A generated image with its CDN URL. */
 interface Image {
     url: string;
 }
@@ -40,6 +82,7 @@ interface TextToImageResponse {
     error?: string;
     [key: string]: unknown;
 }
+type EditImageResponse = TextToImageResponse;
 /**
  * Resolved response returned by the `run()` method after polling sees
  * `status: 'completed'`. Narrows the base response so `images` is
@@ -49,18 +92,106 @@ type CompletedTextToImageResponse = TextToImageResponse & {
     status: 'completed';
     images: Image[];
 };
+type CompletedEditImageResponse = EditImageResponse & {
+    status: 'completed';
+    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>;
 }
 
-declare class SeedreamClient {
+/**
+ * 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>;
+}
+
+/**
+ * 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);
 }
 
-export { type AspectRatio, type CompletedTextToImageResponse, type Generation45EditImageParams, type Generation45TextParams, type Generation5LiteImageParams, type Generation5LiteTextParams, type Image, type Quality, SeedreamClient, type SeedreamModel, type TaskCreateResponse, type TextToImageParams, type TextToImageResponse };
+export { type AspectRatio, type CompletedEditImageResponse, type CompletedTextToImageResponse, type EditImageModel, type EditImageParams, type EditImageResponse, type Generation45EditImageParams, type Generation45TextParams, type Generation5LiteEditParams, type Generation5LiteTextParams, type GenerationV4EditParams, type GenerationV4TextParams, type Image, type OutputQuality, SeedreamClient, type SeedreamModel, type TaskCreateResponse, type TextToImageModel, type TextToImageParams, type TextToImageResponse, type V4OutputResolution };

package/dist/index.js

@@ -20,23 +20,23 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  AuthenticationError: () => import_core3.AuthenticationError,
-  InsufficientCreditsError: () => import_core3.InsufficientCreditsError,
-  NetworkError: () => import_core3.NetworkError,
-  NotFoundError: () => import_core3.NotFoundError,
-  RateLimitError: () => import_core3.RateLimitError,
-  RunApiError: () => import_core3.RunApiError,
+  AuthenticationError: () => import_core4.AuthenticationError,
+  InsufficientCreditsError: () => import_core4.InsufficientCreditsError,
+  NetworkError: () => import_core4.NetworkError,
+  NotFoundError: () => import_core4.NotFoundError,
+  RateLimitError: () => import_core4.RateLimitError,
+  RunApiError: () => import_core4.RunApiError,
   SeedreamClient: () => SeedreamClient,
-  ServiceUnavailableError: () => import_core3.ServiceUnavailableError,
-  TaskFailedError: () => import_core3.TaskFailedError,
-  TaskTimeoutError: () => import_core3.TaskTimeoutError,
-  TimeoutError: () => import_core3.TimeoutError,
-  ValidationError: () => import_core3.ValidationError
+  ServiceUnavailableError: () => import_core4.ServiceUnavailableError,
+  TaskFailedError: () => import_core4.TaskFailedError,
+  TaskTimeoutError: () => import_core4.TaskTimeoutError,
+  TimeoutError: () => import_core4.TimeoutError,
+  ValidationError: () => import_core4.ValidationError
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var import_core2 = require("@runapi.ai/core");
+var import_core3 = require("@runapi.ai/core");
 
 // src/resources/text-to-image.ts
 var import_core = require("@runapi.ai/core");
@@ -47,6 +47,12 @@ var TextToImage = class {
     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 +61,24 @@ 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) {
     return this.http.request("POST", ENDPOINT, {
       body: (0, import_core.compactParams)(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text to image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text to image task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -68,17 +86,69 @@ var TextToImage = class {
   }
 };
 
+// src/resources/edit-image.ts
+var import_core2 = require("@runapi.ai/core");
+var import_internal2 = require("@runapi.ai/core/internal");
+var ENDPOINT2 = "/api/v1/seedream/edit_image";
+var EditImage = class {
+  constructor(http) {
+    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), {
+      maxWaitMs: options?.maxWaitMs,
+      pollIntervalMs: options?.pollIntervalMs
+    });
+    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) {
+    return this.http.request("POST", ENDPOINT2, {
+      body: (0, import_core2.compactParams)(params),
+      ...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
+    });
+  }
+};
+
 // 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_core2.createHttpClient)(options);
-    this.textToImage = new TextToImage(http);
+    super(options);
+    this.textToImage = new TextToImage(this.http);
+    this.editImage = new EditImage(this.http);
   }
 };
 
 // src/index.ts
-var import_core3 = require("@runapi.ai/core");
+var import_core4 = require("@runapi.ai/core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-image.ts"],"sourcesContent":["export { 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';\n\nexport class SeedreamClient {\n  public readonly textToImage: TextToImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToImageResponse,\n  TextToImageParams,\n  TextToImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/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"],"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;;;ADjCO,IAAM,iBAAN,MAAqB;AAAA,EACV;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,WAAO,+BAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;ADPA,IAAAC,eAYO;","names":["import_core","import_core"]}
+{"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 { 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 } 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\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    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 {\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\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":";;;;;;;;;;;;;;;;;;;;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;AAQlC,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,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;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;;;AC1DA,IAAAC,eAA8B;AAC9B,IAAAC,mBAAkC;AAQlC,IAAMC,YAAW;AAMV,IAAM,YAAN,MAAgB;AAAA,EACrB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAsD;AAC1E,WAAO,KAAK,KAAK,QAA2B,OAAO,GAAGA,SAAQ,IAAI,EAAE,IAAI;AAAA,MACtE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AF1BO,IAAM,iBAAN,cAA6B,wBAAW;AAAA;AAAA,EAE7B;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,YAAY,IAAI,UAAU,KAAK,IAAI;AAAA,EAC1C;AACF;;;ADxCA,IAAAC,eAYO;","names":["import_core","import_core","import_internal","ENDPOINT","import_core"]}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/client.ts
-import { createHttpClient } from "@runapi.ai/core";
+import { BaseClient } from "@runapi.ai/core";
 
 // src/resources/text-to-image.ts
 import { compactParams } from "@runapi.ai/core";
@@ -10,6 +10,12 @@ var TextToImage = class {
     this.http = http;
   }
   http;
+  /**
+   * 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 +24,24 @@ 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) {
     return this.http.request("POST", ENDPOINT, {
       body: compactParams(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text to image task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text to image task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -31,12 +49,64 @@ var TextToImage = class {
   }
 };
 
+// src/resources/edit-image.ts
+import { compactParams as compactParams2 } from "@runapi.ai/core";
+import { pollUntilComplete as pollUntilComplete2 } from "@runapi.ai/core/internal";
+var ENDPOINT2 = "/api/v1/seedream/edit_image";
+var EditImage = class {
+  constructor(http) {
+    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), {
+      maxWaitMs: options?.maxWaitMs,
+      pollIntervalMs: options?.pollIntervalMs
+    });
+    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) {
+    return this.http.request("POST", ENDPOINT2, {
+      body: compactParams2(params),
+      ...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
+    });
+  }
+};
+
 // 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);
+    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/index.ts"],"sourcesContent":["import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToImage } from './resources/text-to-image';\n\nexport class SeedreamClient {\n  public readonly textToImage: TextToImage;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToImage = new TextToImage(http);\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToImageResponse,\n  TextToImageParams,\n  TextToImageResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/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","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;;;ADjCO,IAAM,iBAAN,MAAqB;AAAA,EACV;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO,iBAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;AEPA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/resources/text-to-image.ts","../src/resources/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 } 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\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    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 {\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\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":";AAAA,SAAS,kBAAsC;;;ACC/C,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAQlC,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,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;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;;;AC1DA,SAAS,iBAAAA,sBAAqB;AAC9B,SAAS,qBAAAC,0BAAyB;AAQlC,IAAMC,YAAW;AAMV,IAAM,YAAN,MAAgB;AAAA,EACrB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAsD;AAC1E,WAAO,KAAK,KAAK,QAA2B,OAAO,GAAGE,SAAQ,IAAI,EAAE,IAAI;AAAA,MACtE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AF1BO,IAAM,iBAAN,cAA6B,WAAW;AAAA;AAAA,EAE7B;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,YAAY,IAAI,UAAU,KAAK,IAAI;AAAA,EAC1C;AACF;;;AGxCA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["compactParams","pollUntilComplete","ENDPOINT"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/seedream",
-  "version": "0.2.4",
+  "version": "0.2.7",
   "description": "RunAPI Seedream SDK for JavaScript, Ruby, and Go",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -28,7 +28,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.4"
+    "@runapi.ai/core": "^0.2.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/skills/seedream/README.md

@@ -21,7 +21,7 @@
 </div>
 <br/>
 
-Generate and edit images with Seedream 4.5 and 5-lite text-to-image, image-to-image, and image editing. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate Seedream through RunAPI.
+Generate and edit images with Seedream v4, 4.5, and 5-lite text-to-image and image editing. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate Seedream through RunAPI.
 
 The canonical agent file is `skills/seedream/SKILL.md`.
 
@@ -51,9 +51,11 @@ import { SeedreamClient } from '@runapi.ai/seedream';
 
 const client = new SeedreamClient();
 const result = await client.textToImage.run({
-  model: 'seedream-4.5-text-to-image',
-  prompt: 'A cinematic portrait of a traveler in the rain',
+  model: 'seedream-v4-text-to-image',
+  prompt: 'A precise product render of a glass teapot on white marble',
   aspect_ratio: '16:9',
+  output_resolution: '2k',
+  output_count: 3,
 });
 const url = result.images[0].url;
 ```
@@ -65,7 +67,6 @@ const url = result.images[0].url;
 - SDK docs: https://runapi.ai/docs#sdk-seedream
 - SDK repository: https://github.com/runapi-ai/seedream-sdk
 - Pricing and rate limits: https://runapi.ai/models/seedream/4.5-text-to-image
-- Provider comparison: https://runapi.ai/providers/bytedance
 - Browse all RunAPI models and skills: https://runapi.ai/models
 
 ## Variants
@@ -73,10 +74,14 @@ const url = result.images[0].url;
 - [4.5 text to image](https://runapi.ai/models/seedream/4.5-text-to-image)
 - [4.5 edit](https://runapi.ai/models/seedream/4.5-edit)
 - [5 lite text to image](https://runapi.ai/models/seedream/5-lite-text-to-image)
-- [5 lite image to image](https://runapi.ai/models/seedream/5-lite-image-to-image)
+- [5 lite edit](https://runapi.ai/models/seedream/5-lite-edit)
+- [v4 text to image](https://runapi.ai/models/seedream/v4-text-to-image)
+- [v4 edit](https://runapi.ai/models/seedream/v4-edit)
 
 ## 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.

package/skills/seedream/SKILL.md

@@ -25,49 +25,78 @@ 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`
+- 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 actions and request fields with CLI help:
+Inspect the available commands and request fields with CLI help:
 
 ```shell
 runapi seedream --help
 runapi seedream text-to-image --help
+runapi seedream edit-image --help
 ```
 
 Run a one-off task (synchronous — polls until the task completes):
 
 ```shell
 runapi seedream text-to-image --input-file request.json
+runapi seedream edit-image --input-file request.json
 ```
 
 Submit asynchronously and poll separately:
 
 ```shell
 runapi seedream text-to-image --async --input-file request.json
+runapi seedream edit-image --async --input-file request.json
 runapi wait <task-id> --service seedream --action text-to-image
 ```
 
-Available actions: `text-to-image`.
+Available commands: `text-to-image`, `edit-image`.
 
-## SDK integration path
+Common request shapes:
 
-When integrating Seedream into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:
+```json
+{
+  "model": "seedream-v4-text-to-image",
+  "prompt": "A precise product render of a glass teapot on white marble",
+  "aspect_ratio": "16:9",
+  "output_resolution": "2k",
+  "output_count": 3
+}
+```
 
-- JavaScript / TypeScript: `@runapi.ai/seedream`
-- Ruby: `runapi-seedream`
-- Go: `github.com/runapi-ai/seedream-sdk/go`
+```json
+{
+  "model": "seedream-v4-edit",
+  "prompt": "Place the logo on a blue outdoor cap",
+  "source_image_urls": ["https://cdn.runapi.ai/public/samples/image.jpg"],
+  "aspect_ratio": "1:1",
+  "output_resolution": "4k"
+}
+```
+
+## Generated file storage
+
+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
 
 - Model overview, pricing, and rate limits: https://runapi.ai/models/seedream.md
-- Provider comparison: https://runapi.ai/providers/bytedance.md
 - Full model catalog: https://runapi.ai/models.md
 
 ## Variants
@@ -75,5 +104,6 @@ When integrating Seedream into an app, backend, worker, or library — not for o
 - [4.5 text to image](https://runapi.ai/models/seedream/4.5-text-to-image.md)
 - [4.5 edit](https://runapi.ai/models/seedream/4.5-edit.md)
 - [5 lite text to image](https://runapi.ai/models/seedream/5-lite-text-to-image.md)
-- [5 lite image to image](https://runapi.ai/models/seedream/5-lite-image-to-image.md)
-
+- [5 lite edit](https://runapi.ai/models/seedream/5-lite-edit.md)
+- [v4 text to image](https://runapi.ai/models/seedream/v4-text-to-image.md)
+- [v4 edit](https://runapi.ai/models/seedream/v4-edit.md)