@runapi.ai/seedance 0.2.1 → 0.2.6

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.
 

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, 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' | 'seedance-2-fast' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
-type SeedanceModel2 = 'seedance-2' | 'seedance-2-fast';
+type SeedanceModel = 'seedance-1.5-pro' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
+type SeedanceModel2 = 'seedance-2.0' | 'seedance-2.0-fast';
 type SeedanceModelV1 = 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
 type AspectRatio15Pro = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '21:9';
 type AspectRatio2 = AspectRatio15Pro | 'auto';
@@ -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,31 +43,31 @@ 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;
 }
 /**
- * seedance-2/2-fast text-to-video mode.
+ * seedance-2.0/2-fast text-to-video mode.
  * Pure text prompt, no image/reference inputs.
  */
 interface Generation2TextParams extends Generation2BaseParams {
 }
 /**
- * seedance-2/2-fast frame mode.
+ * seedance-2.0/2-fast frame mode.
  * Guide generation with first (required) and optional last frame images.
  * Mutually exclusive with reference mode.
  */
 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/2-fast reference mode.
+ * seedance-2.0/2-fast reference mode.
  * Guide generation with reference images, videos, or audio.
  * Mutually exclusive with frame 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 & {
@@ -171,7 +169,7 @@ declare class TextToVideo {
  * });
  *
  * const result = await client.textToVideo.run({
- *   model: 'seedance-2',
+ *   model: 'seedance-2.0',
  *   prompt: 'A cat walking through a garden',
  * });
  * ```

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { AsyncTaskStatus, HttpClient, RequestOptions, PollingOptions, 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' | 'seedance-2-fast' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
-type SeedanceModel2 = 'seedance-2' | 'seedance-2-fast';
+type SeedanceModel = 'seedance-1.5-pro' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
+type SeedanceModel2 = 'seedance-2.0' | 'seedance-2.0-fast';
 type SeedanceModelV1 = 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
 type AspectRatio15Pro = '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '21:9';
 type AspectRatio2 = AspectRatio15Pro | 'auto';
@@ -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,31 +43,31 @@ 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;
 }
 /**
- * seedance-2/2-fast text-to-video mode.
+ * seedance-2.0/2-fast text-to-video mode.
  * Pure text prompt, no image/reference inputs.
  */
 interface Generation2TextParams extends Generation2BaseParams {
 }
 /**
- * seedance-2/2-fast frame mode.
+ * seedance-2.0/2-fast frame mode.
  * Guide generation with first (required) and optional last frame images.
  * Mutually exclusive with reference mode.
  */
 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/2-fast reference mode.
+ * seedance-2.0/2-fast reference mode.
  * Guide generation with reference images, videos, or audio.
  * Mutually exclusive with frame 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 & {
@@ -171,7 +169,7 @@ declare class TextToVideo {
  * });
  *
  * const result = await client.textToVideo.run({
- *   model: 'seedance-2',
+ *   model: 'seedance-2.0',
  *   prompt: 'A cat walking through a garden',
  * });
  * ```

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',\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 { 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"]}

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',\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 { 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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/seedance",
-  "version": "0.2.1",
+  "version": "0.2.6",
   "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.1"
+    "@runapi.ai/core": "^0.2.5"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/skills/seedance/README.md

@@ -1,4 +1,25 @@
-# Seedance API Skill for RunAPI
+<p align="center">
+  <a href="https://github.com/runapi-ai/seedance">
+    <h3 align="center">Seedance API Skill for RunAPI</h3>
+  </a>
+</p>
+
+<p align="center">
+  Install this agent skill, inspect Seedance fields, then run jobs through the RunAPI CLI.
+</p>
+
+<p align="center">
+  <a href="https://runapi.ai/models/seedance"><strong>Model Reference</strong></a> · <a href="https://github.com/runapi-ai/cli"><strong>CLI</strong></a> · <a href="https://github.com/runapi-ai/seedance-sdk"><strong>SDK</strong></a>
+</p>
+
+<div align="center">
+
+[![skills.sh](https://www.skills.sh/b/runapi-ai/seedance)](https://www.skills.sh/runapi-ai/seedance/seedance)
+[![ClawHub](https://img.shields.io/badge/ClawHub-runapi--seedance-111827)](https://clawhub.ai/runapi-ai/runapi-seedance)
+[![License](https://img.shields.io/github/license/runapi-ai/seedance)](https://github.com/runapi-ai/seedance/blob/main/LICENSE)
+
+</div>
+<br/>
 
 Generate video with Seedance 1.5 Pro, 2.0, and 2.0 Fast text-to-video and image-to-video. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate Seedance through RunAPI.
 
@@ -10,7 +31,18 @@ The canonical agent file is `skills/seedance/SKILL.md`.
 npx skills add runapi-ai/seedance -g
 ```
 
-Or manually: clone this repo and copy `skills/seedance/` into your agent's skills directory.
+Or paste this prompt to your AI agent:
+
+```text
+Install the seedance skill for me:
+
+1. Clone https://github.com/runapi-ai/seedance
+2. Copy the skills/seedance/ directory into your
+   user-level skills directory (e.g. ~/.claude/skills/
+   for Claude Code, ~/.codex/skills/ for Codex).
+3. Verify that SKILL.md is present.
+4. Confirm the install path when done.
+```
 
 ## Quick example
 

package/skills/seedance/SKILL.md

@@ -1,211 +1,81 @@
 ---
 name: seedance
-description: Generate videos (Seedance 1.5 Pro, Seedance 2 / 2-fast text-to-video, image-to-video, frame mode, reference mode) through RunAPI.ai using the @runapi.ai/seedance Node/TypeScript SDK. Use when the user asks to add Seedance video generation, or writes against @runapi.ai/seedance. Triggers on "seedance", "即梦视频", "video generation", "生成视频", "@runapi.ai/seedance".
-documentation: https://runapi.ai/models/seedance
-provider_page: https://runapi.ai/providers/bytedance
-catalog: https://runapi.ai/models
+description: Generate and edit video with Seedance through RunAPI. Use when the user asks an agent to create, edit, or transform video with Seedance. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
+documentation: https://runapi.ai/models/seedance.md
+provider_page: https://runapi.ai/providers/bytedance.md
+catalog: https://runapi.ai/models.md
+metadata:
+  openclaw:
+    homepage: https://runapi.ai/models/seedance
+    requires:
+      bins:
+      - runapi
+    install:
+    - kind: brew
+      formula: runapi-ai/tap/runapi
+      bins:
+      - runapi
+    envVars:
+    - name: RUNAPI_API_KEY
+      required: false
+      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.
 ---
-# @runapi.ai/seedance — RunAPI.ai Seedance video generation
 
-Build Node / TypeScript integrations that generate Seedance video through RunAPI.ai.
+# Seedance on RunAPI
 
-## Setup
+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.
 
-Requires **Node 18+** (global `fetch`).
+## Routing decision
 
-```bash
-npm install @runapi.ai/seedance
-```
+- 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**.
 
-Set your API key in the environment:
+## CLI path
 
-```dotenv
-# .env
-RUNAPI_API_KEY=runapi_xxx   # get one at https://runapi.ai/settings/api_keys
-```
+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.
 
-```ts
-import { SeedanceClient } from '@runapi.ai/seedance';
+Inspect the available commands and request fields with CLI help:
 
-// The SDK reads RUNAPI_API_KEY from the environment automatically.
-const client = new SeedanceClient();
+```shell
+runapi seedance --help
+runapi seedance text-to-video --help
 ```
 
-Pass `{ apiKey }` explicitly if you manage secrets differently. `baseUrl` defaults to `https://runapi.ai`; override only for local development.
-
-## Core recipe — text to video
+Run a one-off task (synchronous — polls until the task completes):
 
-```ts
-const result = await client.textToVideo.run({
-  model: 'seedance-2',
-  prompt: 'A drone shot over mountains at sunset',
-  aspect_ratio: '16:9',
-  duration: 8,
-});
-
-const url = result.videos[0].url;
+```shell
+runapi seedance text-to-video --input-file request.json
 ```
 
-`run()` creates the task, auto-polls, and resolves only when the task completes — `videos[0].url` is guaranteed on the resolved value. On failure it throws `TaskFailedError`; on polling timeout it throws `TaskTimeoutError`. Use `run()` for scripts and short-lived processes. For request handlers, split it:
+Submit asynchronously and poll separately:
 
-```ts
-const { id } = await client.textToVideo.create({ model: 'seedance-2', prompt: '...' });
-// return 202 immediately; fetch later:
-const status = await client.textToVideo.get(id);
-if (status.status === 'completed') { /* ... */ }
+```shell
+runapi seedance text-to-video --async --input-file request.json
+runapi wait <task-id> --service seedance --action text-to-video
 ```
 
-Do not hold a web worker open waiting on `run()`. Split + webhook is the production pattern.
-
-`run()` polls every 2 s for up to 15 min by default. Tune when needed:
-
-```ts
-await client.textToVideo.run(params, { maxWaitMs: 30 * 60_000, pollIntervalMs: 5_000 });
-```
-
-If `TaskTimeoutError` fires, the task is still running server-side — resume with `textToVideo.get(id)` or finish via webhook.
-
-## Image-to-video (seedance-1.5-pro)
-
-```ts
-await client.textToVideo.run({
-  model: 'seedance-1.5-pro',
-  prompt: 'The flower blooms and petals scatter',
-  aspect_ratio: '16:9',
-  input_urls: ['https://cdn.example.com/flower.jpg'],
-  resolution: '1080p',
-  duration: 8,
-  lock_camera: true, // lock camera movement
-});
-```
-
-## Frame mode (seedance-2 / 2-fast)
-
-Guide with first (required) and optional last frame. **Mutually exclusive with reference mode.**
-
-```ts
-await client.textToVideo.run({
-  model: 'seedance-2',
-  prompt: 'A sunrise over the ocean',
-  first_frame_url: 'https://cdn.example.com/start.jpg',
-  last_frame_url: 'https://cdn.example.com/end.jpg',
-});
-```
-
-## Reference mode (seedance-2 / 2-fast)
-
-Guide with reference images, videos, or audio. **Mutually exclusive with frame mode.**
-
-```ts
-await client.textToVideo.run({
-  model: 'seedance-2',
-  prompt: 'A person dancing in the same style',
-  reference_video_urls: ['https://cdn.example.com/dance.mp4'],
-  reference_audio_urls: ['https://cdn.example.com/beat.mp3'],
-});
-```
-
-## Models
-
-| `model` | Modes | Notes |
-|---|---|---|
-| `seedance-1.5-pro` | text-to-video, image-to-video (`input_urls`), `lock_camera` | `aspect_ratio` required. `resolution`: `480p` / `720p` / `1080p`. `duration`: 4 / 8 / 12. |
-| `seedance-2` | text / frame / reference | `resolution`: `480p` / `720p` / `1080p`. `duration`: integer 4–15. |
-| `seedance-2-fast` | text / frame / reference | Faster, cheaper variant of `seedance-2`. `resolution`: `480p` / `720p`. |
-| `seedance-v1-lite` | text-to-video, image-to-video (auto-detected via `input_urls`) | `aspect_ratio` required in text mode (`…, 9:21`). `resolution`: `480p` / `720p` / `1080p`. `duration`: `"5"` or `"10"`. Image mode supports `last_frame_url`. Extras: `seed`, `enable_safety_checker`, `lock_camera`. |
-| `seedance-v1-pro` | text-to-video, image-to-video (auto-detected via `input_urls`) | Same as v1-lite but `aspect_ratio` set is `…, 21:9`. No `last_frame_url`. |
-| `seedance-v1-pro-fast` | image-to-video only | `input_urls` required. `resolution`: `720p` / `1080p`. `duration`: `"5"` or `"10"`. Narrow param set — no `aspect_ratio` / `lock_camera` / `seed` / `enable_safety_checker`. |
-
-Exact credit costs per model are shown at https://runapi.ai/pricing and in the dashboard — do not hardcode prices in application code.
-
-## Callbacks (webhooks)
-
-Pass `callback_url` on `create()` (or any `run()` call) and RunAPI will POST the final payload to you:
-
-```ts
-await client.textToVideo.create({
-  model: 'seedance-2',
-  prompt: '...',
-  callback_url: 'https://your.app/webhooks/runapi/seedance',
-});
-```
-
-Payload shape:
-
-```ts
-{ id: string; status: 'completed' | 'failed'; videos?: { url: string }[]; last_frame_url?: string; error?: string }
-```
-
-**Always verify the signature before trusting the body.** RunAPI signs every callback with your account's Callback Secret (rotate at `/accounts/callback_secret`). Headers:
-
-- `X-Callback-Id` — UUID, store to make handler idempotent
-- `X-Callback-Timestamp` — unix seconds, reject if `|now - ts| > 300`
-- `X-Callback-Signature` — base64 HMAC-SHA256 over `` `${id}.${ts}.${rawBody}` `` using the base64-decoded secret
-
-```ts
-import crypto from 'node:crypto';
-
-function verify(raw: string, id: string, ts: string, sig: string, secret: string) {
-  const key = Buffer.from(secret, 'base64');
-  const mac = crypto.createHmac('sha256', key)
-    .update(`${id}.${ts}.${raw}`)
-    .digest('base64');
-  return crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(sig));
-}
-```
-
-Reply `2xx` within 10s; any non-2xx triggers retries.
-
-## Errors
-
-All errors are re-exported from `@runapi.ai/core`. Always `instanceof` — never string-match messages.
-
-| Error | Status | Action |
-|---|---|---|
-| `AuthenticationError` | 401 | abort; surface "reconnect your API key" |
-| `InsufficientCreditsError` | 402 | prompt user to top up at runapi.ai/billing |
-| `ValidationError` | 400 / 422 | fix params; do not retry |
-| `RateLimitError` | 429 | sleep `err.retryAfterMs`, then retry |
-| `ServiceUnavailableError` | 503 / 455 | retry with backoff; transient service issue |
-| `TaskFailedError` | — | show `err.details` to user; do not auto-retry |
-| `TaskTimeoutError` | — | re-poll with `textToVideo.get(id)` |
-
-```ts
-import { InsufficientCreditsError, TaskFailedError } from '@runapi.ai/seedance';
-
-try {
-  await client.textToVideo.run({ model: 'seedance-2', prompt: '...' });
-} catch (err) {
-  if (err instanceof InsufficientCreditsError) { /* surface top-up CTA */ }
-  else if (err instanceof TaskFailedError)       { /* show err.details */ }
-  else throw err;
-}
-```
+Available commands: `text-to-video`.
 
-## Gotchas
+## SDK integration path
 
-- `model` is required on every call.
-- For `seedance-1.5-pro`, `aspect_ratio` is required and `resolution`/`duration` use a different set of values than the 2.x models.
-- For `seedance-2` / `seedance-2-fast`, **frame mode and reference mode are mutually exclusive** — do not send both `first_frame_url` and `reference_*_urls` in the same request.
-- `aspect_ratio: 'auto'` is 2.x-only (useful with frame mode to inherit dimensions from the reference frame).
-- `reference_audio_urls` requires at least one `reference_image_urls` or `reference_video_urls` to be set.
-- `last_frame_url` is optional in the response and may be absent.
-- `callback_url` must be reachable from the public internet. `localhost` / `127.0.0.1` URLs will never fire — use a tunnel (cloudflared, ngrok, tailscale funnel) when developing locally.
+When integrating Seedance into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:
 
-## Dig deeper
+- JavaScript / TypeScript: `@runapi.ai/seedance`
+- Ruby: `runapi-seedance`
+- Go: `github.com/runapi-ai/seedance-sdk/go`
 
-Package README (full API surface, all params): `node_modules/@runapi.ai/seedance/README.md`. Types: `@runapi.ai/seedance/dist/types.d.ts`. Product docs: https://runapi.ai/docs.
+## References
 
-## RunAPI public routing
+- Model overview, pricing, and rate limits: https://runapi.ai/models/seedance.md
+- Provider comparison: https://runapi.ai/providers/bytedance.md
+- Full model catalog: https://runapi.ai/models.md
 
-seedance api public links use the API-379 catalog route map. The main seedance api page is https://runapi.ai/models/seedance. SDK docs live at https://runapi.ai/docs#sdk-seedance and product docs live at https://runapi.ai/docs#seedance.
+## Variants
 
-Pricing, rate limits, and commercial usage for seedance api should point to the most specific variant page:
-- [v1 lite](https://runapi.ai/models/seedance/v1-lite)
-- [v1 pro](https://runapi.ai/models/seedance/v1-pro)
-- [v1 pro fast](https://runapi.ai/models/seedance/v1-pro-fast)
-- [1.5 pro](https://runapi.ai/models/seedance/1.5-pro)
-- [2.0](https://runapi.ai/models/seedance/2.0)
-- [2.0 fast](https://runapi.ai/models/seedance/2.0-fast)
+- [v1 lite](https://runapi.ai/models/seedance/v1-lite.md)
+- [v1 pro](https://runapi.ai/models/seedance/v1-pro.md)
+- [v1 pro fast](https://runapi.ai/models/seedance/v1-pro-fast.md)
+- [1.5 pro](https://runapi.ai/models/seedance/1.5-pro.md)
+- [2.0](https://runapi.ai/models/seedance/2.0.md)
+- [2.0 fast](https://runapi.ai/models/seedance/2.0-fast.md)
 
-Compare Seedance with other Bytedance models at https://runapi.ai/providers/bytedance. Browse every RunAPI model and skill at https://runapi.ai/models. SDK repository: https://github.com/runapi-ai/seedance-sdk. Skill repository: https://github.com/runapi-ai/seedance.