@runapi.ai/seedance 0.2.6 → 0.2.7

package/README.md

@@ -24,6 +24,8 @@ const status = await client.generations.get(task.id);
 
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## Language notes
 
 Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building 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';
@@ -150,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>;
 }
 
@@ -174,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';
@@ -150,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>;
 }
 
@@ -174,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.6",
+  "version": "0.2.7",
   "description": "RunAPI Seedance 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.5"
+    "@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,14 +25,23 @@ 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 commands and request fields with CLI help:
 
@@ -56,13 +65,9 @@ runapi wait <task-id> --service seedance --action text-to-video
 
 Available commands: `text-to-video`.
 
-## SDK integration path
-
-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