@runapi.ai/seedance 0.2.6 → 0.2.8

package/README.md

@@ -1,8 +1,8 @@
-# Seedance API JavaScript SDK for RunAPI
+# Seedance 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 editing, and animation flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+The Seedance JavaScript SDK is the language-specific package for Seedance on RunAPI. Use this package for video generation, animation, and video editing workflows when your application needs 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.
+This 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.
 
 ## Install
 
@@ -16,17 +16,19 @@ npm install @runapi.ai/seedance
 import { SeedanceClient } from '@runapi.ai/seedance';
 
 const client = new SeedanceClient();
-const task = await client.generations.create({
+const task = await client.textToVideo.create({
   // Pass the Seedance JSON request body from https://runapi.ai/docs#seedance.
 });
-const status = await client.generations.get(task.id);
+const status = await client.textToVideo.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.
+Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building video applications. The available resources are `textToVideo`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 

package/dist/index.d.mts

@@ -1,8 +1,9 @@
-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';
-type SeedanceModel2 = 'seedance-2.0' | 'seedance-2.0-fast';
+type SeedanceModel = 'seedance-1.5-pro' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-2-mini' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
+type SeedanceModel2 = 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-2-mini';
+type SeedanceModel2WithSafetyChecker = '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';
@@ -13,74 +14,98 @@ type Resolution2 = '480p' | '720p' | '1080p';
 type ResolutionV1 = '480p' | '720p' | '1080p';
 type ResolutionV1ProFast = '720p' | '1080p';
 type DurationV1 = 5 | 10;
+type Duration15Pro = number;
 interface GenerationCommonParams {
     /** Text description of desired video content */
     prompt: string;
     /** URL for completion callback */
     callback_url?: string;
-    /** Generate audio track for the video */
-    generate_audio?: boolean;
+}
+interface SafetyCheckerParams {
     /** Content safety check toggle */
     enable_safety_checker?: boolean;
 }
+interface AudioGenerationParams {
+    /** Generate audio track for the video */
+    generate_audio?: boolean;
+}
 /**
  * seedance-1.5-pro generation parameters.
  * Supports text-to-video and image-to-video with camera lock.
  */
-interface Generation15ProParams extends GenerationCommonParams {
+interface Generation15ProParams extends GenerationCommonParams, AudioGenerationParams, SafetyCheckerParams {
     model: 'seedance-1.5-pro';
     /** Required for seedance-1.5-pro */
     aspect_ratio: AspectRatio15Pro;
     output_resolution?: Resolution15Pro;
-    /** Fixed values: 4, 8, or 12 seconds */
-    duration_seconds: 4 | 8 | 12;
+    /** Integer 4-12 seconds */
+    duration_seconds: Duration15Pro;
     /** Up to 2 source image URLs for image-to-video */
     source_image_urls?: string[];
     /** Lock camera movement */
     lock_camera?: boolean;
 }
 /** Common fields for all 2.x modes */
-interface Generation2BaseParams extends GenerationCommonParams {
-    model: SeedanceModel2;
+interface Generation2BaseFields extends GenerationCommonParams, AudioGenerationParams {
     aspect_ratio?: AspectRatio2;
     output_resolution?: Resolution2;
     /** Integer 4-15 */
     duration_seconds?: number;
-    /** Enable web search for prompt enrichment. */
+}
+type Generation2ModelFields = ({
+    model: SeedanceModel2WithSafetyChecker;
+} & SafetyCheckerParams) | {
+    model: 'seedance-2-mini';
+};
+interface Generation2TextFields extends Generation2BaseFields {
+    /** Enable web search for prompt enrichment in pure text-to-video mode. */
     web_search?: boolean;
+    first_frame_image_url?: never;
+    last_frame_image_url?: never;
+    reference_image_urls?: never;
+    reference_video_urls?: never;
+    reference_audio_urls?: never;
 }
 /**
- * seedance-2.0/2-fast text-to-video mode.
+ * seedance-2.x text-to-video mode.
  * Pure text prompt, no image/reference inputs.
  */
-interface Generation2TextParams extends Generation2BaseParams {
-}
-/**
- * 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 {
+type Generation2TextParams = Generation2TextFields & Generation2ModelFields;
+interface Generation2FrameFields extends Generation2BaseFields {
     /** First frame image URL (required for frame mode) */
     first_frame_image_url: string;
     /** Last frame image URL */
     last_frame_image_url?: string;
+    web_search?: never;
+    reference_image_urls?: never;
+    reference_video_urls?: never;
+    reference_audio_urls?: never;
 }
 /**
- * seedance-2.0/2-fast reference mode.
- * Guide generation with reference images, videos, or audio.
- * Mutually exclusive with frame mode.
+ * seedance-2.x frame mode.
+ * Guide generation with first (required) and optional last frame images.
+ * Mutually exclusive with reference mode.
  */
-interface Generation2ReferenceParams extends Generation2BaseParams {
+type Generation2FrameParams = Generation2FrameFields & Generation2ModelFields;
+interface Generation2ReferenceFields extends Generation2BaseFields {
     /** Reference image URLs (max 9) */
     reference_image_urls?: string[];
-    /** Reference video URLs (max 3, total duration ≤ 15s) */
+    /** Reference video URLs (max 3, total duration <= 15s) */
     reference_video_urls?: string[];
     /** Reference audio URLs (max 3, requires image or video) */
     reference_audio_urls?: string[];
+    first_frame_image_url?: never;
+    last_frame_image_url?: never;
+    web_search?: never;
 }
+/**
+ * seedance-2.x reference mode.
+ * Guide generation with reference images, videos, or audio.
+ * Mutually exclusive with frame mode.
+ */
+type Generation2ReferenceParams = Generation2ReferenceFields & Generation2ModelFields;
 /** Common fields for v1-lite and v1-pro (not v1-pro-fast). */
-interface GenerationV1SharedParams extends GenerationCommonParams {
+interface GenerationV1SharedParams extends GenerationCommonParams, SafetyCheckerParams {
     /** `5` or `10`. Required. */
     duration_seconds: DurationV1;
     output_resolution?: ResolutionV1;
@@ -117,7 +142,7 @@ interface GenerationV1ProParams extends GenerationV1SharedParams {
  * seedance-v1-pro-fast image-to-video only. Smaller parameter surface —
  * no `aspect_ratio`, `lock_camera`, or `seed`.
  */
-interface GenerationV1ProFastParams extends GenerationCommonParams {
+interface GenerationV1ProFastParams extends GenerationCommonParams, SafetyCheckerParams {
     model: 'seedance-v1-pro-fast';
     /** Required first frame image URL. */
     first_frame_image_url: string;
@@ -150,11 +175,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,10 +218,10 @@ declare class TextToVideo {
  * });
  * ```
  */
-declare class SeedanceClient {
+declare class SeedanceClient extends BaseClient {
     /** Video generation operations. */
     readonly textToVideo: TextToVideo;
     constructor(options?: ClientOptions);
 }
 
-export { type AspectRatio15Pro, type AspectRatio2, type AspectRatioV1Lite, type AspectRatioV1Pro, type CompletedTextToVideoResponse, type DurationV1, type Generation15ProParams, type Generation2FrameParams, type Generation2ReferenceParams, type Generation2TextParams, type GenerationV1LiteParams, type GenerationV1ProFastParams, type GenerationV1ProParams, type Resolution15Pro, type Resolution2, type ResolutionV1, type ResolutionV1ProFast, SeedanceClient, type SeedanceModel, type SeedanceModel2, type SeedanceModelV1, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type VideoMetadata };
+export { type AspectRatio15Pro, type AspectRatio2, type AspectRatioV1Lite, type AspectRatioV1Pro, type CompletedTextToVideoResponse, type Duration15Pro, type DurationV1, type Generation15ProParams, type Generation2FrameParams, type Generation2ReferenceParams, type Generation2TextParams, type GenerationV1LiteParams, type GenerationV1ProFastParams, type GenerationV1ProParams, type Resolution15Pro, type Resolution2, type ResolutionV1, type ResolutionV1ProFast, SeedanceClient, type SeedanceModel, type SeedanceModel2, type SeedanceModel2WithSafetyChecker, type SeedanceModelV1, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type VideoMetadata };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-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';
-type SeedanceModel2 = 'seedance-2.0' | 'seedance-2.0-fast';
+type SeedanceModel = 'seedance-1.5-pro' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-2-mini' | 'seedance-v1-lite' | 'seedance-v1-pro' | 'seedance-v1-pro-fast';
+type SeedanceModel2 = 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-2-mini';
+type SeedanceModel2WithSafetyChecker = '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';
@@ -13,74 +14,98 @@ type Resolution2 = '480p' | '720p' | '1080p';
 type ResolutionV1 = '480p' | '720p' | '1080p';
 type ResolutionV1ProFast = '720p' | '1080p';
 type DurationV1 = 5 | 10;
+type Duration15Pro = number;
 interface GenerationCommonParams {
     /** Text description of desired video content */
     prompt: string;
     /** URL for completion callback */
     callback_url?: string;
-    /** Generate audio track for the video */
-    generate_audio?: boolean;
+}
+interface SafetyCheckerParams {
     /** Content safety check toggle */
     enable_safety_checker?: boolean;
 }
+interface AudioGenerationParams {
+    /** Generate audio track for the video */
+    generate_audio?: boolean;
+}
 /**
  * seedance-1.5-pro generation parameters.
  * Supports text-to-video and image-to-video with camera lock.
  */
-interface Generation15ProParams extends GenerationCommonParams {
+interface Generation15ProParams extends GenerationCommonParams, AudioGenerationParams, SafetyCheckerParams {
     model: 'seedance-1.5-pro';
     /** Required for seedance-1.5-pro */
     aspect_ratio: AspectRatio15Pro;
     output_resolution?: Resolution15Pro;
-    /** Fixed values: 4, 8, or 12 seconds */
-    duration_seconds: 4 | 8 | 12;
+    /** Integer 4-12 seconds */
+    duration_seconds: Duration15Pro;
     /** Up to 2 source image URLs for image-to-video */
     source_image_urls?: string[];
     /** Lock camera movement */
     lock_camera?: boolean;
 }
 /** Common fields for all 2.x modes */
-interface Generation2BaseParams extends GenerationCommonParams {
-    model: SeedanceModel2;
+interface Generation2BaseFields extends GenerationCommonParams, AudioGenerationParams {
     aspect_ratio?: AspectRatio2;
     output_resolution?: Resolution2;
     /** Integer 4-15 */
     duration_seconds?: number;
-    /** Enable web search for prompt enrichment. */
+}
+type Generation2ModelFields = ({
+    model: SeedanceModel2WithSafetyChecker;
+} & SafetyCheckerParams) | {
+    model: 'seedance-2-mini';
+};
+interface Generation2TextFields extends Generation2BaseFields {
+    /** Enable web search for prompt enrichment in pure text-to-video mode. */
     web_search?: boolean;
+    first_frame_image_url?: never;
+    last_frame_image_url?: never;
+    reference_image_urls?: never;
+    reference_video_urls?: never;
+    reference_audio_urls?: never;
 }
 /**
- * seedance-2.0/2-fast text-to-video mode.
+ * seedance-2.x text-to-video mode.
  * Pure text prompt, no image/reference inputs.
  */
-interface Generation2TextParams extends Generation2BaseParams {
-}
-/**
- * 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 {
+type Generation2TextParams = Generation2TextFields & Generation2ModelFields;
+interface Generation2FrameFields extends Generation2BaseFields {
     /** First frame image URL (required for frame mode) */
     first_frame_image_url: string;
     /** Last frame image URL */
     last_frame_image_url?: string;
+    web_search?: never;
+    reference_image_urls?: never;
+    reference_video_urls?: never;
+    reference_audio_urls?: never;
 }
 /**
- * seedance-2.0/2-fast reference mode.
- * Guide generation with reference images, videos, or audio.
- * Mutually exclusive with frame mode.
+ * seedance-2.x frame mode.
+ * Guide generation with first (required) and optional last frame images.
+ * Mutually exclusive with reference mode.
  */
-interface Generation2ReferenceParams extends Generation2BaseParams {
+type Generation2FrameParams = Generation2FrameFields & Generation2ModelFields;
+interface Generation2ReferenceFields extends Generation2BaseFields {
     /** Reference image URLs (max 9) */
     reference_image_urls?: string[];
-    /** Reference video URLs (max 3, total duration ≤ 15s) */
+    /** Reference video URLs (max 3, total duration <= 15s) */
     reference_video_urls?: string[];
     /** Reference audio URLs (max 3, requires image or video) */
     reference_audio_urls?: string[];
+    first_frame_image_url?: never;
+    last_frame_image_url?: never;
+    web_search?: never;
 }
+/**
+ * seedance-2.x reference mode.
+ * Guide generation with reference images, videos, or audio.
+ * Mutually exclusive with frame mode.
+ */
+type Generation2ReferenceParams = Generation2ReferenceFields & Generation2ModelFields;
 /** Common fields for v1-lite and v1-pro (not v1-pro-fast). */
-interface GenerationV1SharedParams extends GenerationCommonParams {
+interface GenerationV1SharedParams extends GenerationCommonParams, SafetyCheckerParams {
     /** `5` or `10`. Required. */
     duration_seconds: DurationV1;
     output_resolution?: ResolutionV1;
@@ -117,7 +142,7 @@ interface GenerationV1ProParams extends GenerationV1SharedParams {
  * seedance-v1-pro-fast image-to-video only. Smaller parameter surface —
  * no `aspect_ratio`, `lock_camera`, or `seed`.
  */
-interface GenerationV1ProFastParams extends GenerationCommonParams {
+interface GenerationV1ProFastParams extends GenerationCommonParams, SafetyCheckerParams {
     model: 'seedance-v1-pro-fast';
     /** Required first frame image URL. */
     first_frame_image_url: string;
@@ -150,11 +175,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,10 +218,10 @@ declare class TextToVideo {
  * });
  * ```
  */
-declare class SeedanceClient {
+declare class SeedanceClient extends BaseClient {
     /** Video generation operations. */
     readonly textToVideo: TextToVideo;
     constructor(options?: ClientOptions);
 }
 
-export { type AspectRatio15Pro, type AspectRatio2, type AspectRatioV1Lite, type AspectRatioV1Pro, type CompletedTextToVideoResponse, type DurationV1, type Generation15ProParams, type Generation2FrameParams, type Generation2ReferenceParams, type Generation2TextParams, type GenerationV1LiteParams, type GenerationV1ProFastParams, type GenerationV1ProParams, type Resolution15Pro, type Resolution2, type ResolutionV1, type ResolutionV1ProFast, SeedanceClient, type SeedanceModel, type SeedanceModel2, type SeedanceModelV1, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type VideoMetadata };
+export { type AspectRatio15Pro, type AspectRatio2, type AspectRatioV1Lite, type AspectRatioV1Pro, type CompletedTextToVideoResponse, type Duration15Pro, type DurationV1, type Generation15ProParams, type Generation2FrameParams, type Generation2ReferenceParams, type Generation2TextParams, type GenerationV1LiteParams, type GenerationV1ProFastParams, type GenerationV1ProParams, type Resolution15Pro, type Resolution2, type ResolutionV1, type ResolutionV1ProFast, SeedanceClient, type SeedanceModel, type SeedanceModel2, type SeedanceModel2WithSafetyChecker, type SeedanceModelV1, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type VideoMetadata };

package/dist/index.js

@@ -41,12 +41,214 @@ var import_core2 = require("@runapi.ai/core");
 // src/resources/text-to-video.ts
 var import_core = require("@runapi.ai/core");
 var import_internal = require("@runapi.ai/core/internal");
+
+// src/contract_gen.ts
+var contract = {
+  "text-to-video": {
+    "models": [
+      "seedance-1.5-pro",
+      "seedance-2-mini",
+      "seedance-2.0",
+      "seedance-2.0-fast",
+      "seedance-v1-lite",
+      "seedance-v1-pro",
+      "seedance-v1-pro-fast"
+    ],
+    "fields_by_model": {
+      "seedance-1.5-pro": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "duration_seconds": {
+          "required": true,
+          "min": 4,
+          "max": 12,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        }
+      },
+      "seedance-2-mini": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9",
+            "auto"
+          ]
+        },
+        "duration_seconds": {
+          "min": 4,
+          "max": 15,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p"
+          ]
+        }
+      },
+      "seedance-2.0": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9",
+            "auto"
+          ]
+        },
+        "duration_seconds": {
+          "min": 4,
+          "max": 15,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        }
+      },
+      "seedance-2.0-fast": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9",
+            "auto"
+          ]
+        },
+        "duration_seconds": {
+          "min": 4,
+          "max": 15,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p"
+          ]
+        }
+      },
+      "seedance-v1-lite": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "9:21"
+          ]
+        },
+        "duration_seconds": {
+          "enum": [
+            5,
+            10
+          ],
+          "required": true,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedance-v1-pro": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "duration_seconds": {
+          "enum": [
+            5,
+            10
+          ],
+          "required": true,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedance-v1-pro-fast": {
+        "duration_seconds": {
+          "enum": [
+            5,
+            10
+          ],
+          "required": true,
+          "type": "integer"
+        },
+        "first_frame_image_url": {
+          "required": true
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-video.ts
 var ENDPOINT = "/api/v1/seedance/text_to_video";
 var TextToVideo = class {
   constructor(http) {
     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 +257,26 @@ 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) {
+    const body = (0, import_core.compactParams)(params);
+    (0, import_core.validateParams)(contract["text-to-video"], body);
     return this.http.request("POST", ENDPOINT, {
-      body: (0, import_core.compactParams)(params),
+      body,
       ...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 +285,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","../src/contract_gen.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, ActionSchema } from '@runapi.ai/core';\nimport { compactParams, validateParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport { contract } from '../contract_gen';\nimport type {\n  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    const body = compactParams(params);\n    validateParams(contract['text-to-video'] as ActionSchema, body as Record<string, unknown>);\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body,\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text to 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 const contract = {\n  \"text-to-video\": {\n    \"models\": [\n      \"seedance-1.5-pro\",\n      \"seedance-2-mini\",\n      \"seedance-2.0\",\n      \"seedance-2.0-fast\",\n      \"seedance-v1-lite\",\n      \"seedance-v1-pro\",\n      \"seedance-v1-pro-fast\"\n    ],\n    \"fields_by_model\": {\n      \"seedance-1.5-pro\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"required\": true,\n          \"min\": 4,\n          \"max\": 12,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        }\n      },\n      \"seedance-2-mini\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"min\": 4,\n          \"max\": 15,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\"\n          ]\n        }\n      },\n      \"seedance-2.0\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"min\": 4,\n          \"max\": 15,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        }\n      },\n      \"seedance-2.0-fast\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"min\": 4,\n          \"max\": 15,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\"\n          ]\n        }\n      },\n      \"seedance-v1-lite\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"9:21\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"enum\": [\n            5,\n            10\n          ],\n          \"required\": true,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedance-v1-pro\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"enum\": [\n            5,\n            10\n          ],\n          \"required\": true,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedance-v1-pro-fast\": {\n        \"duration_seconds\": {\n          \"enum\": [\n            5,\n            10\n          ],\n          \"required\": true,\n          \"type\": \"integer\"\n        },\n        \"first_frame_image_url\": {\n          \"required\": true\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"720p\",\n            \"1080p\"\n          ]\n        }\n      }\n    }\n  }\n} as const;\n"],"mappings":"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","names":["import_core","import_core"]}

package/dist/index.mjs

@@ -1,15 +1,217 @@
 // 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";
+import { compactParams, validateParams } from "@runapi.ai/core";
 import { pollUntilComplete } from "@runapi.ai/core/internal";
+
+// src/contract_gen.ts
+var contract = {
+  "text-to-video": {
+    "models": [
+      "seedance-1.5-pro",
+      "seedance-2-mini",
+      "seedance-2.0",
+      "seedance-2.0-fast",
+      "seedance-v1-lite",
+      "seedance-v1-pro",
+      "seedance-v1-pro-fast"
+    ],
+    "fields_by_model": {
+      "seedance-1.5-pro": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "duration_seconds": {
+          "required": true,
+          "min": 4,
+          "max": 12,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        }
+      },
+      "seedance-2-mini": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9",
+            "auto"
+          ]
+        },
+        "duration_seconds": {
+          "min": 4,
+          "max": 15,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p"
+          ]
+        }
+      },
+      "seedance-2.0": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9",
+            "auto"
+          ]
+        },
+        "duration_seconds": {
+          "min": 4,
+          "max": 15,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        }
+      },
+      "seedance-2.0-fast": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9",
+            "auto"
+          ]
+        },
+        "duration_seconds": {
+          "min": 4,
+          "max": 15,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p"
+          ]
+        }
+      },
+      "seedance-v1-lite": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "9:21"
+          ]
+        },
+        "duration_seconds": {
+          "enum": [
+            5,
+            10
+          ],
+          "required": true,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedance-v1-pro": {
+        "aspect_ratio": {
+          "enum": [
+            "1:1",
+            "4:3",
+            "3:4",
+            "16:9",
+            "9:16",
+            "21:9"
+          ]
+        },
+        "duration_seconds": {
+          "enum": [
+            5,
+            10
+          ],
+          "required": true,
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "480p",
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "seedance-v1-pro-fast": {
+        "duration_seconds": {
+          "enum": [
+            5,
+            10
+          ],
+          "required": true,
+          "type": "integer"
+        },
+        "first_frame_image_url": {
+          "required": true
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        }
+      }
+    }
+  }
+};
+
+// src/resources/text-to-video.ts
 var ENDPOINT = "/api/v1/seedance/text_to_video";
 var TextToVideo = class {
   constructor(http) {
     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 +220,26 @@ 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) {
+    const body = compactParams(params);
+    validateParams(contract["text-to-video"], body);
     return this.http.request("POST", ENDPOINT, {
-      body: compactParams(params),
+      body,
       ...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 +248,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/contract_gen.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, ActionSchema } from '@runapi.ai/core';\nimport { compactParams, validateParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport { contract } from '../contract_gen';\nimport type {\n  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    const body = compactParams(params);\n    validateParams(contract['text-to-video'] as ActionSchema, body as Record<string, unknown>);\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body,\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text to 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 const contract = {\n  \"text-to-video\": {\n    \"models\": [\n      \"seedance-1.5-pro\",\n      \"seedance-2-mini\",\n      \"seedance-2.0\",\n      \"seedance-2.0-fast\",\n      \"seedance-v1-lite\",\n      \"seedance-v1-pro\",\n      \"seedance-v1-pro-fast\"\n    ],\n    \"fields_by_model\": {\n      \"seedance-1.5-pro\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"required\": true,\n          \"min\": 4,\n          \"max\": 12,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        }\n      },\n      \"seedance-2-mini\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"min\": 4,\n          \"max\": 15,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\"\n          ]\n        }\n      },\n      \"seedance-2.0\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"min\": 4,\n          \"max\": 15,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        }\n      },\n      \"seedance-2.0-fast\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\",\n            \"auto\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"min\": 4,\n          \"max\": 15,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\"\n          ]\n        }\n      },\n      \"seedance-v1-lite\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"9:21\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"enum\": [\n            5,\n            10\n          ],\n          \"required\": true,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedance-v1-pro\": {\n        \"aspect_ratio\": {\n          \"enum\": [\n            \"1:1\",\n            \"4:3\",\n            \"3:4\",\n            \"16:9\",\n            \"9:16\",\n            \"21:9\"\n          ]\n        },\n        \"duration_seconds\": {\n          \"enum\": [\n            5,\n            10\n          ],\n          \"required\": true,\n          \"type\": \"integer\"\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"480p\",\n            \"720p\",\n            \"1080p\"\n          ]\n        },\n        \"seed\": {\n          \"type\": \"integer\"\n        }\n      },\n      \"seedance-v1-pro-fast\": {\n        \"duration_seconds\": {\n          \"enum\": [\n            5,\n            10\n          ],\n          \"required\": true,\n          \"type\": \"integer\"\n        },\n        \"first_frame_image_url\": {\n          \"required\": true\n        },\n        \"output_resolution\": {\n          \"enum\": [\n            \"720p\",\n            \"1080p\"\n          ]\n        }\n      }\n    }\n  }\n} as const;\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":"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","names":[]}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@runapi.ai/seedance",
-  "version": "0.2.6",
-  "description": "RunAPI Seedance SDK for JavaScript, Ruby, and Go",
+  "runapi": {
+    "slug": "seedance"
+  },
+  "version": "0.2.8",
+  "description": "RunAPI Seedance SDK for text-to-video workflows in JavaScript, Python, Ruby, Go, Java, and PHP",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -28,7 +31,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.5"
+    "@runapi.ai/core": "^0.2.9"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -49,8 +52,16 @@
     "api",
     "sdk",
     "typescript",
+    "python",
     "ruby",
-    "golang"
+    "golang",
+    "java",
+    "maven",
+    "gradle",
+    "video-generation",
+    "text-to-video",
+    "video-api",
+    "seedance-api"
   ],
   "author": "RunAPI",
   "license": "Apache-2.0",
@@ -58,5 +69,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/runapi-ai/seedance-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runapi-ai/seedance-sdk/issues"
   }
 }

package/skills/seedance/README.md

@@ -21,7 +21,7 @@
 </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.
+Generate video with Seedance 1.5 Pro, 2.0, 2.0 Fast, and 2.0 Mini text-to-video and image-to-video. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate Seedance through RunAPI.
 
 The canonical agent file is `skills/seedance/SKILL.md`.
 
@@ -76,12 +76,15 @@ const url = result.videos[0].url;
 - [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)
+- [2.0 mini](https://runapi.ai/models/seedance/2-mini)
 
 ## 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.
+- For pricing, rate-limit, and commercial-usage answers, link to the variant page rather than the repository README.
 
 ## License
 

package/skills/seedance/SKILL.md

@@ -25,14 +25,24 @@ 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`
+- PHP: `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 +66,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
 
@@ -78,4 +84,4 @@ When integrating Seedance into an app, backend, worker, or library — not for o
 - [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)
-
+- [2.0 mini](https://runapi.ai/models/seedance/2-mini.md)