@runapi.ai/seedance 0.2.4 → 0.2.7

package/README.md

@@ -1,6 +1,6 @@
 # Seedance API JavaScript SDK for RunAPI
 
-The seedance api JavaScript SDK is the language-specific package for Seedance on RunAPI. Use this seedance api package for text-to-video, image-to-video, video-to-video, animation, and edit flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+The seedance api JavaScript SDK is the language-specific package for Seedance on RunAPI. Use this seedance api package for text-to-video, image-to-video, video editing, and animation flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
 
 This seedance api README is the JavaScript package guide inside the public `seedance-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/seedance; for API reference, use https://runapi.ai/docs#seedance; for SDK docs, use https://runapi.ai/docs#sdk-seedance.
 
@@ -24,6 +24,8 @@ const status = await client.generations.get(task.id);
 
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## Language notes
 
 Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building video applications. The available resources include generations. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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 SeedanceModel = 'seedance-1.5-pro' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
@@ -12,7 +12,7 @@ type Resolution15Pro = '480p' | '720p' | '1080p';
 type Resolution2 = '480p' | '720p' | '1080p';
 type ResolutionV1 = '480p' | '720p' | '1080p';
 type ResolutionV1ProFast = '720p' | '1080p';
-type DurationV1 = '5' | '10';
+type DurationV1 = 5 | 10;
 interface GenerationCommonParams {
     /** Text description of desired video content */
     prompt: string;
@@ -20,8 +20,8 @@ interface GenerationCommonParams {
     callback_url?: string;
     /** Generate audio track for the video */
     generate_audio?: boolean;
-    /** Enable NSFW content check */
-    nsfw_checker?: boolean;
+    /** Content safety check toggle */
+    enable_safety_checker?: boolean;
 }
 /**
  * seedance-1.5-pro generation parameters.
@@ -31,11 +31,11 @@ interface Generation15ProParams extends GenerationCommonParams {
     model: 'seedance-1.5-pro';
     /** Required for seedance-1.5-pro */
     aspect_ratio: AspectRatio15Pro;
-    resolution?: Resolution15Pro;
+    output_resolution?: Resolution15Pro;
     /** Fixed values: 4, 8, or 12 seconds */
-    duration?: 4 | 8 | 12;
-    /** Up to 2 image URLs for image-to-video */
-    input_urls?: string[];
+    duration_seconds: 4 | 8 | 12;
+    /** Up to 2 source image URLs for image-to-video */
+    source_image_urls?: string[];
     /** Lock camera movement */
     lock_camera?: boolean;
 }
@@ -43,9 +43,9 @@ interface Generation15ProParams extends GenerationCommonParams {
 interface Generation2BaseParams extends GenerationCommonParams {
     model: SeedanceModel2;
     aspect_ratio?: AspectRatio2;
-    resolution?: Resolution2;
+    output_resolution?: Resolution2;
     /** Integer 4-15 */
-    duration?: number;
+    duration_seconds?: number;
     /** Enable web search for prompt enrichment. */
     web_search?: boolean;
 }
@@ -62,9 +62,9 @@ interface Generation2TextParams extends Generation2BaseParams {
  */
 interface Generation2FrameParams extends Generation2BaseParams {
     /** First frame image URL (required for frame mode) */
-    first_frame_url: string;
+    first_frame_image_url: string;
     /** Last frame image URL */
-    last_frame_url?: string;
+    last_frame_image_url?: string;
 }
 /**
  * seedance-2.0/2-fast reference mode.
@@ -81,50 +81,48 @@ interface Generation2ReferenceParams extends Generation2BaseParams {
 }
 /** Common fields for v1-lite and v1-pro (not v1-pro-fast). */
 interface GenerationV1SharedParams extends GenerationCommonParams {
-    /** `'5'` or `'10'`. Required. */
-    duration: DurationV1;
-    resolution?: ResolutionV1;
+    /** `5` or `10`. Required. */
+    duration_seconds: DurationV1;
+    output_resolution?: ResolutionV1;
     /** Lock camera movement */
     lock_camera?: boolean;
     /** Random seed; `-1` for random. Integer in [-1, 2147483647]. */
     seed?: number;
-    /** Safety checker toggle */
-    enable_safety_checker?: boolean;
 }
 /**
  * seedance-v1-lite text-to-video or image-to-video. Mode is auto-detected by
- * `input_urls` presence. `last_frame_url` is only valid in image-to-video mode.
+ * `first_frame_image_url` presence. `last_frame_image_url` is only valid in image-to-video mode.
  */
 interface GenerationV1LiteParams extends GenerationV1SharedParams {
     model: 'seedance-v1-lite';
-    /** Required in text-to-video mode. Omit when `input_urls` is set. */
+    /** Required in text-to-video mode. Omit when `first_frame_image_url` is set. */
     aspect_ratio?: AspectRatioV1Lite;
-    /** Up to 1 image URL. Triggers image-to-video mode when set. */
-    input_urls?: string[];
+    /** First frame image URL. Triggers image-to-video mode when set. */
+    first_frame_image_url?: string;
     /** Ending frame image URL; image-to-video mode only. */
-    last_frame_url?: string;
+    last_frame_image_url?: string;
 }
 /**
  * seedance-v1-pro text-to-video or image-to-video. Mode is auto-detected by
- * `input_urls` presence.
+ * `first_frame_image_url` presence.
  */
 interface GenerationV1ProParams extends GenerationV1SharedParams {
     model: 'seedance-v1-pro';
-    /** Required in text-to-video mode. Omit when `input_urls` is set. */
+    /** Required in text-to-video mode. Omit when `first_frame_image_url` is set. */
     aspect_ratio?: AspectRatioV1Pro;
-    /** Up to 1 image URL. Triggers image-to-video mode when set. */
-    input_urls?: string[];
+    /** First frame image URL. Triggers image-to-video mode when set. */
+    first_frame_image_url?: string;
 }
 /**
  * seedance-v1-pro-fast image-to-video only. Smaller parameter surface —
- * no `aspect_ratio`, `lock_camera`, `seed`, or `enable_safety_checker`.
+ * no `aspect_ratio`, `lock_camera`, or `seed`.
  */
 interface GenerationV1ProFastParams extends GenerationCommonParams {
     model: 'seedance-v1-pro-fast';
-    /** Required — at least one image URL. */
-    input_urls: [string] | [string, ...string[]];
-    resolution?: ResolutionV1ProFast;
-    duration: DurationV1;
+    /** Required first frame image URL. */
+    first_frame_image_url: string;
+    output_resolution?: ResolutionV1ProFast;
+    duration_seconds: DurationV1;
 }
 /** Discriminated union of all generation parameter variants */
 type TextToVideoParams = Generation15ProParams | Generation2TextParams | Generation2FrameParams | Generation2ReferenceParams | GenerationV1LiteParams | GenerationV1ProParams | GenerationV1ProFastParams;
@@ -138,13 +136,13 @@ interface TextToVideoResponse {
     id: string;
     status: AsyncTaskStatus;
     videos?: VideoMetadata[];
-    last_frame_url?: string;
+    last_frame_image_url?: string;
     error?: string;
     [key: string]: unknown;
 }
 /**
  * Resolved response returned by the `run()` method after polling sees
- * `status: 'completed'`. Narrows `videos` to non-optional; `last_frame_url`
+ * `status: 'completed'`. Narrows `videos` to non-optional; `last_frame_image_url`
  * stays optional because it may be absent.
  */
 type CompletedTextToVideoResponse = TextToVideoResponse & {
@@ -152,11 +150,30 @@ type CompletedTextToVideoResponse = TextToVideoResponse & {
     videos: VideoMetadata[];
 };
 
+/** Generate video from text prompts, optionally conditioned on reference images, frame images, reference videos, or audio. */
 declare class TextToVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create a text to video task and wait until complete.
+     * @param params Text to video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text to video response.
+     */
     run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse>;
+    /**
+     * Create a text to video task; returns immediately with a task id.
+     * @param params Text to video parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result.
+     */
     create(params: TextToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of a text to video task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current text to video task status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToVideoResponse>;
 }
 
@@ -176,7 +193,7 @@ declare class TextToVideo {
  * });
  * ```
  */
-declare class SeedanceClient {
+declare class SeedanceClient extends BaseClient {
     /** Video generation operations. */
     readonly textToVideo: TextToVideo;
     constructor(options?: ClientOptions);

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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 SeedanceModel = 'seedance-1.5-pro' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
@@ -12,7 +12,7 @@ type Resolution15Pro = '480p' | '720p' | '1080p';
 type Resolution2 = '480p' | '720p' | '1080p';
 type ResolutionV1 = '480p' | '720p' | '1080p';
 type ResolutionV1ProFast = '720p' | '1080p';
-type DurationV1 = '5' | '10';
+type DurationV1 = 5 | 10;
 interface GenerationCommonParams {
     /** Text description of desired video content */
     prompt: string;
@@ -20,8 +20,8 @@ interface GenerationCommonParams {
     callback_url?: string;
     /** Generate audio track for the video */
     generate_audio?: boolean;
-    /** Enable NSFW content check */
-    nsfw_checker?: boolean;
+    /** Content safety check toggle */
+    enable_safety_checker?: boolean;
 }
 /**
  * seedance-1.5-pro generation parameters.
@@ -31,11 +31,11 @@ interface Generation15ProParams extends GenerationCommonParams {
     model: 'seedance-1.5-pro';
     /** Required for seedance-1.5-pro */
     aspect_ratio: AspectRatio15Pro;
-    resolution?: Resolution15Pro;
+    output_resolution?: Resolution15Pro;
     /** Fixed values: 4, 8, or 12 seconds */
-    duration?: 4 | 8 | 12;
-    /** Up to 2 image URLs for image-to-video */
-    input_urls?: string[];
+    duration_seconds: 4 | 8 | 12;
+    /** Up to 2 source image URLs for image-to-video */
+    source_image_urls?: string[];
     /** Lock camera movement */
     lock_camera?: boolean;
 }
@@ -43,9 +43,9 @@ interface Generation15ProParams extends GenerationCommonParams {
 interface Generation2BaseParams extends GenerationCommonParams {
     model: SeedanceModel2;
     aspect_ratio?: AspectRatio2;
-    resolution?: Resolution2;
+    output_resolution?: Resolution2;
     /** Integer 4-15 */
-    duration?: number;
+    duration_seconds?: number;
     /** Enable web search for prompt enrichment. */
     web_search?: boolean;
 }
@@ -62,9 +62,9 @@ interface Generation2TextParams extends Generation2BaseParams {
  */
 interface Generation2FrameParams extends Generation2BaseParams {
     /** First frame image URL (required for frame mode) */
-    first_frame_url: string;
+    first_frame_image_url: string;
     /** Last frame image URL */
-    last_frame_url?: string;
+    last_frame_image_url?: string;
 }
 /**
  * seedance-2.0/2-fast reference mode.
@@ -81,50 +81,48 @@ interface Generation2ReferenceParams extends Generation2BaseParams {
 }
 /** Common fields for v1-lite and v1-pro (not v1-pro-fast). */
 interface GenerationV1SharedParams extends GenerationCommonParams {
-    /** `'5'` or `'10'`. Required. */
-    duration: DurationV1;
-    resolution?: ResolutionV1;
+    /** `5` or `10`. Required. */
+    duration_seconds: DurationV1;
+    output_resolution?: ResolutionV1;
     /** Lock camera movement */
     lock_camera?: boolean;
     /** Random seed; `-1` for random. Integer in [-1, 2147483647]. */
     seed?: number;
-    /** Safety checker toggle */
-    enable_safety_checker?: boolean;
 }
 /**
  * seedance-v1-lite text-to-video or image-to-video. Mode is auto-detected by
- * `input_urls` presence. `last_frame_url` is only valid in image-to-video mode.
+ * `first_frame_image_url` presence. `last_frame_image_url` is only valid in image-to-video mode.
  */
 interface GenerationV1LiteParams extends GenerationV1SharedParams {
     model: 'seedance-v1-lite';
-    /** Required in text-to-video mode. Omit when `input_urls` is set. */
+    /** Required in text-to-video mode. Omit when `first_frame_image_url` is set. */
     aspect_ratio?: AspectRatioV1Lite;
-    /** Up to 1 image URL. Triggers image-to-video mode when set. */
-    input_urls?: string[];
+    /** First frame image URL. Triggers image-to-video mode when set. */
+    first_frame_image_url?: string;
     /** Ending frame image URL; image-to-video mode only. */
-    last_frame_url?: string;
+    last_frame_image_url?: string;
 }
 /**
  * seedance-v1-pro text-to-video or image-to-video. Mode is auto-detected by
- * `input_urls` presence.
+ * `first_frame_image_url` presence.
  */
 interface GenerationV1ProParams extends GenerationV1SharedParams {
     model: 'seedance-v1-pro';
-    /** Required in text-to-video mode. Omit when `input_urls` is set. */
+    /** Required in text-to-video mode. Omit when `first_frame_image_url` is set. */
     aspect_ratio?: AspectRatioV1Pro;
-    /** Up to 1 image URL. Triggers image-to-video mode when set. */
-    input_urls?: string[];
+    /** First frame image URL. Triggers image-to-video mode when set. */
+    first_frame_image_url?: string;
 }
 /**
  * seedance-v1-pro-fast image-to-video only. Smaller parameter surface —
- * no `aspect_ratio`, `lock_camera`, `seed`, or `enable_safety_checker`.
+ * no `aspect_ratio`, `lock_camera`, or `seed`.
  */
 interface GenerationV1ProFastParams extends GenerationCommonParams {
     model: 'seedance-v1-pro-fast';
-    /** Required — at least one image URL. */
-    input_urls: [string] | [string, ...string[]];
-    resolution?: ResolutionV1ProFast;
-    duration: DurationV1;
+    /** Required first frame image URL. */
+    first_frame_image_url: string;
+    output_resolution?: ResolutionV1ProFast;
+    duration_seconds: DurationV1;
 }
 /** Discriminated union of all generation parameter variants */
 type TextToVideoParams = Generation15ProParams | Generation2TextParams | Generation2FrameParams | Generation2ReferenceParams | GenerationV1LiteParams | GenerationV1ProParams | GenerationV1ProFastParams;
@@ -138,13 +136,13 @@ interface TextToVideoResponse {
     id: string;
     status: AsyncTaskStatus;
     videos?: VideoMetadata[];
-    last_frame_url?: string;
+    last_frame_image_url?: string;
     error?: string;
     [key: string]: unknown;
 }
 /**
  * Resolved response returned by the `run()` method after polling sees
- * `status: 'completed'`. Narrows `videos` to non-optional; `last_frame_url`
+ * `status: 'completed'`. Narrows `videos` to non-optional; `last_frame_image_url`
  * stays optional because it may be absent.
  */
 type CompletedTextToVideoResponse = TextToVideoResponse & {
@@ -152,11 +150,30 @@ type CompletedTextToVideoResponse = TextToVideoResponse & {
     videos: VideoMetadata[];
 };
 
+/** Generate video from text prompts, optionally conditioned on reference images, frame images, reference videos, or audio. */
 declare class TextToVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create a text to video task and wait until complete.
+     * @param params Text to video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text to video response.
+     */
     run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse>;
+    /**
+     * Create a text to video task; returns immediately with a task id.
+     * @param params Text to video parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result.
+     */
     create(params: TextToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of a text to video task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current text to video task status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToVideoResponse>;
 }
 
@@ -176,7 +193,7 @@ declare class TextToVideo {
  * });
  * ```
  */
-declare class SeedanceClient {
+declare class SeedanceClient extends BaseClient {
     /** Video generation operations. */
     readonly textToVideo: TextToVideo;
     constructor(options?: ClientOptions);

package/dist/index.js

@@ -47,6 +47,12 @@ var TextToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Create a text to video task and wait until complete.
+   * @param params Text to video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text to video 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 TextToVideo = class {
     });
     return response;
   }
+  /**
+   * Create a text to video task; returns immediately with a task id.
+   * @param params Text to video 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 video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text to video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -69,12 +87,12 @@ var TextToVideo = class {
 };
 
 // src/client.ts
-var SeedanceClient = class {
+var SeedanceClient = class extends import_core2.BaseClient {
   /** Video generation operations. */
   textToVideo;
   constructor(options = {}) {
-    const http = (0, import_core2.createHttpClient)(options);
-    this.textToVideo = new TextToVideo(http);
+    super(options);
+    this.textToVideo = new TextToVideo(this.http);
   }
 };
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-video.ts"],"sourcesContent":["export { SeedanceClient } 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 { TextToVideo } from './resources/text-to-video';\n\n/**\n * Seedance video API client.\n *\n * @example\n * ```typescript\n * const client = new SeedanceClient({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToVideo.run({\n *   model: 'seedance-2.0',\n *   prompt: 'A cat walking through a garden',\n * });\n * ```\n */\nexport class SeedanceClient {\n  /** Video generation operations. */\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToVideo = new TextToVideo(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  CompletedTextToVideoResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedance/text_to_video';\n\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToVideoResponse;\n  }\n\n  async create(params: TextToVideoParams, 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<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('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;;;ADjBO,IAAM,iBAAN,MAAqB;AAAA;AAAA,EAEV;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,WAAO,+BAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;ADxBA,IAAAC,eAYO;","names":["import_core","import_core"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/text-to-video.ts"],"sourcesContent":["export { SeedanceClient } 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 { TextToVideo } from './resources/text-to-video';\n\n/**\n * Seedance video API client.\n *\n * @example\n * ```typescript\n * const client = new SeedanceClient({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToVideo.run({\n *   model: 'seedance-2.0',\n *   prompt: 'A cat walking through a garden',\n * });\n * ```\n */\nexport class SeedanceClient extends BaseClient {\n  /** Video generation operations. */\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToVideo = new TextToVideo(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  CompletedTextToVideoResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedance/text_to_video';\n\n/** Generate video from text prompts, optionally conditioned on reference images, frame images, reference videos, or audio. */\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Create a text to video task and wait until complete.\n   * @param params Text to video parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed text to video response.\n   */\n  async run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToVideoResponse;\n  }\n\n  /**\n   * Create a text to video task; returns immediately with a task id.\n   * @param params Text to video parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result.\n   */\n  async create(params: TextToVideoParams, 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 video task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text to video task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('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;AAGV,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;;;ADpCO,IAAM,iBAAN,cAA6B,wBAAW;AAAA;AAAA,EAE7B;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAAA,EAC9C;AACF;;;ADxBA,IAAAC,eAYO;","names":["import_core","import_core"]}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/client.ts
-import { createHttpClient } from "@runapi.ai/core";
+import { BaseClient } from "@runapi.ai/core";
 
 // src/resources/text-to-video.ts
 import { compactParams } from "@runapi.ai/core";
@@ -10,6 +10,12 @@ var TextToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Create a text to video task and wait until complete.
+   * @param params Text to video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text to video 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 TextToVideo = class {
     });
     return response;
   }
+  /**
+   * Create a text to video task; returns immediately with a task id.
+   * @param params Text to video 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 video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text to video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, {
       ...options
@@ -32,12 +50,12 @@ var TextToVideo = class {
 };
 
 // src/client.ts
-var SeedanceClient = class {
+var SeedanceClient = class extends BaseClient {
   /** Video generation operations. */
   textToVideo;
   constructor(options = {}) {
-    const http = createHttpClient(options);
-    this.textToVideo = new TextToVideo(http);
+    super(options);
+    this.textToVideo = new TextToVideo(this.http);
   }
 };
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/resources/text-to-video.ts","../src/index.ts"],"sourcesContent":["import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToVideo } from './resources/text-to-video';\n\n/**\n * Seedance video API client.\n *\n * @example\n * ```typescript\n * const client = new SeedanceClient({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToVideo.run({\n *   model: 'seedance-2.0',\n *   prompt: 'A cat walking through a garden',\n * });\n * ```\n */\nexport class SeedanceClient {\n  /** Video generation operations. */\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.textToVideo = new TextToVideo(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  CompletedTextToVideoResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedance/text_to_video';\n\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToVideoResponse;\n  }\n\n  async create(params: TextToVideoParams, 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<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { SeedanceClient } 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;;;ADjBO,IAAM,iBAAN,MAAqB;AAAA;AAAA,EAEV;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO,iBAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;AExBA;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-video.ts","../src/index.ts"],"sourcesContent":["import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { TextToVideo } from './resources/text-to-video';\n\n/**\n * Seedance video API client.\n *\n * @example\n * ```typescript\n * const client = new SeedanceClient({\n *   apiKey: 'your-api-key',\n *   baseUrl: 'https://runapi.ai',\n * });\n *\n * const result = await client.textToVideo.run({\n *   model: 'seedance-2.0',\n *   prompt: 'A cat walking through a garden',\n * });\n * ```\n */\nexport class SeedanceClient extends BaseClient {\n  /** Video generation operations. */\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.textToVideo = new TextToVideo(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  CompletedTextToVideoResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/seedance/text_to_video';\n\n/** Generate video from text prompts, optionally conditioned on reference images, frame images, reference videos, or audio. */\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Create a text to video task and wait until complete.\n   * @param params Text to video parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed text to video response.\n   */\n  async run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToVideoResponse;\n  }\n\n  /**\n   * Create a text to video task; returns immediately with a task id.\n   * @param params Text to video parameters.\n   * @param options Per-request overrides.\n   * @returns The task creation result.\n   */\n  async create(params: TextToVideoParams, 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 video task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text to video task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { SeedanceClient } 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;AAGV,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;;;ADpCO,IAAM,iBAAN,cAA6B,WAAW;AAAA;AAAA,EAE7B;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAAA,EAC9C;AACF;;;AExBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/seedance",
-  "version": "0.2.4",
+  "version": "0.2.7",
   "description": "RunAPI Seedance SDK for JavaScript, Ruby, and Go",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -25,12 +25,10 @@
     "build": "tsup",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "test:text2video": "dotenv -e manual-tests/.env -- tsx manual-tests/test-text-to-video.ts",
-    "test:manual": "pnpm run test:text2video"
+    "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/seedance/README.md

@@ -79,6 +79,8 @@ const url = result.videos[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 seedance api pricing, rate-limit, and commercial-usage answers, link to the variant page rather than the repository README.

package/skills/seedance/SKILL.md

@@ -25,16 +25,25 @@ metadata:
 
 Generate and edit video with Seedance 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 Seedance 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/seedance`
+- Ruby: `runapi-seedance`
+- Go: `github.com/runapi-ai/seedance-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 seedance --help
@@ -54,15 +63,11 @@ runapi seedance text-to-video --async --input-file request.json
 runapi wait <task-id> --service seedance --action text-to-video
 ```
 
-Available actions: `text-to-video`.
-
-## SDK integration path
+Available commands: `text-to-video`.
 
-When integrating Seedance into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:
+## Generated file storage
 
-- JavaScript / TypeScript: `@runapi.ai/seedance`
-- Ruby: `runapi-seedance`
-- Go: `github.com/runapi-ai/seedance-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