npm - @runapi.ai/happyhorse - Versions diffs - 0.2.5 → 0.2.7 - Mend

@runapi.ai/happyhorse 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +3 -1
package/dist/index.d.mts +116 -2
package/dist/index.d.ts +116 -2
package/dist/index.js +185 -8
package/dist/index.js.map +1 -1
package/dist/index.mjs +189 -12
package/dist/index.mjs.map +1 -1
package/package.json +18 -4
package/skills/happyhorse/README.md +3 -1
package/skills/happyhorse/SKILL.md +15 -10

package/README.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # HappyHorse API JavaScript SDK for RunAPI
-The happyhorse ai api JavaScript SDK is the language-specific package for HappyHorse on RunAPI. Use this package for text, image, and edit-video workflows that need JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+The HappyHorse JavaScript SDK is the language-specific package for HappyHorse 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.
 ## Install
@@ -26,6 +26,8 @@ const video = await client.textToVideo.run({
 For image-to-video, call `client.imageToVideo.run` with `model: 'happyhorse-image-to-video'` and exactly one `image_urls` entry. For character-guided text-to-video, call `client.textToVideo.run` with `model: 'happyhorse-character'` and 1-9 `reference_image_urls` entries. For edit-video, call `client.editVideo.run` with `model: 'happyhorse-edit-video'`, one `video_url`, and optional `reference_image` entries.
+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.
 ## Links
 - Model page: https://runapi.ai/models/happyhorse

package/dist/index.d.mts CHANGED Viewed

@@ -1,45 +1,86 @@
-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';
+/**
+ * Text-to-video model variants. happyhorse-character requires 1-9 reference_image_urls
+ * for character-consistent generation; happyhorse-text-to-video is the standard model.
+ */
 type HappyHorseTextToVideoModel = 'happyhorse-text-to-video' | 'happyhorse-character';
 type HappyHorseImageToVideoModel = 'happyhorse-image-to-video';
 type HappyHorseEditVideoModel = 'happyhorse-edit-video';
+/** Output resolution. Defaults to 1080p. */
 type HappyHorseOutputResolution = '720p' | '1080p';
+/** Aspect ratio. Defaults to 16:9. */
 type HappyHorseAspectRatio = '16:9' | '9:16' | '1:1' | '4:3' | '3:4';
+/** Audio handling for video editing. "auto" lets the model decide; "original" preserves the source video's audio. */
 type HappyHorseAudioSetting = 'auto' | 'original';
+/**
+ * Parameters for text-to-video generation. When using happyhorse-character,
+ * reference_image_urls (1-9 images) is required for character consistency.
+ */
 interface TextToVideoParams {
     model: HappyHorseTextToVideoModel;
+    /** Video description prompt. Up to 5000 non-Chinese characters or 2500 Chinese characters. */
     prompt: string;
+    /** Character reference images for happyhorse-character (1-9 URLs). Not supported on happyhorse-text-to-video. */
     reference_image_urls?: string[];
+    /** Output resolution. Defaults to 1080p. */
     output_resolution?: HappyHorseOutputResolution;
+    /** Aspect ratio. Defaults to 16:9. */
     aspect_ratio?: HappyHorseAspectRatio;
+    /** Duration in seconds (3-15). Defaults to 5. */
     duration_seconds?: number;
+    /** Reproducibility seed (0-2147483647). */
     seed?: number;
+    /** URL for completion callback notifications. */
     callback_url?: string;
 }
+/**
+ * Parameters for image-to-video animation. The first-frame image is animated
+ * into video, optionally guided by a text prompt.
+ */
 interface ImageToVideoParams {
     model: HappyHorseImageToVideoModel;
+    /** Source image URL used as the video's opening frame. */
     first_frame_image_url: string;
+    /** Optional motion description prompt. */
     prompt?: string;
+    /** Output resolution. Defaults to 1080p. */
     output_resolution?: HappyHorseOutputResolution;
+    /** Duration in seconds (3-15). Defaults to 5. */
     duration_seconds?: number;
+    /** Reproducibility seed (0-2147483647). */
     seed?: number;
+    /** URL for completion callback notifications. */
     callback_url?: string;
 }
+/**
+ * Parameters for video editing. Transforms the source video according to the prompt.
+ * Source video must be 3-60 seconds, MP4 or MOV format. Use audio_setting to control
+ * whether the original audio is preserved.
+ */
 interface EditVideoParams {
     model: HappyHorseEditVideoModel;
+    /** Editing instruction prompt describing the desired transformation. */
     prompt: string;
+    /** Source video URL to transform (3-60s, MP4/MOV). */
     source_video_url: string;
+    /** Optional reference images to guide the edit (up to 5 URLs). */
     reference_image_urls?: string[];
+    /** Output resolution. Defaults to 1080p. */
     output_resolution?: HappyHorseOutputResolution;
+    /** Audio handling: "auto" lets the model decide, "original" preserves the source audio. */
     audio_setting?: HappyHorseAudioSetting;
+    /** Reproducibility seed (0-2147483647). */
     seed?: number;
+    /** URL for completion callback notifications. */
     callback_url?: string;
 }
 interface TaskCreateResponse {
     id: string;
     status?: AsyncTaskStatus;
 }
+/** A generated video file with a download URL. */
 interface Video {
     url: string;
 }
@@ -65,33 +106,106 @@ type CompletedEditVideoResponse = EditVideoResponse & {
     videos: Video[];
 };
+/** Transform an existing video with a text prompt and optional reference images. Use audio_setting to control whether original audio is preserved. */
 declare class EditVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create an edit-video task and wait until complete.
+     * @param params Edit-video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed task with videos.
+     */
     run(params: EditVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditVideoResponse>;
+    /**
+     * Create an edit-video task; returns immediately with a task id.
+     * @param params Edit-video parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
     create(params: EditVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an edit-video task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current edit-video task status.
+     */
     get(id: string, options?: RequestOptions): Promise<EditVideoResponse>;
 }
+/** Animate a still first-frame image into video, guided by an optional text prompt. */
 declare class ImageToVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create an image-to-video task and wait until complete.
+     * @param params Image-to-video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed task with videos.
+     */
     run(params: ImageToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedImageToVideoResponse>;
+    /**
+     * Create an image-to-video task; returns immediately with a task id.
+     * @param params Image-to-video parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
     create(params: ImageToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an image-to-video task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current image-to-video task status.
+     */
     get(id: string, options?: RequestOptions): Promise<ImageToVideoResponse>;
 }
+/** Generate video from a text prompt, with optional character consistency via happyhorse-character. */
 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 task with videos.
+     */
     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 with id.
+     */
     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>;
 }
-declare class HappyHorseClient {
+/**
+ * HappyHorse video generation and editing API client.
+ *
+ * @example
+ * ```typescript
+ * const client = new HappyHorseClient({ apiKey: 'your-api-key' });
+ *
+ * const result = await client.textToVideo.run({
+ *   model: 'happyhorse-text-to-video',
+ *   prompt: 'A horse galloping across a sunset beach',
+ * });
+ * ```
+ */
+declare class HappyHorseClient extends BaseClient {
+    /** Generate video from a text prompt, with optional character consistency via happyhorse-character. */
     readonly textToVideo: TextToVideo;
+    /** Animate a still first-frame image into video, guided by an optional text prompt. */
     readonly imageToVideo: ImageToVideo;
+    /** Transform an existing video with a text prompt and optional reference images. */
     readonly editVideo: EditVideo;
     constructor(options?: ClientOptions);
 }

package/dist/index.d.ts CHANGED Viewed

@@ -1,45 +1,86 @@
-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';
+/**
+ * Text-to-video model variants. happyhorse-character requires 1-9 reference_image_urls
+ * for character-consistent generation; happyhorse-text-to-video is the standard model.
+ */
 type HappyHorseTextToVideoModel = 'happyhorse-text-to-video' | 'happyhorse-character';
 type HappyHorseImageToVideoModel = 'happyhorse-image-to-video';
 type HappyHorseEditVideoModel = 'happyhorse-edit-video';
+/** Output resolution. Defaults to 1080p. */
 type HappyHorseOutputResolution = '720p' | '1080p';
+/** Aspect ratio. Defaults to 16:9. */
 type HappyHorseAspectRatio = '16:9' | '9:16' | '1:1' | '4:3' | '3:4';
+/** Audio handling for video editing. "auto" lets the model decide; "original" preserves the source video's audio. */
 type HappyHorseAudioSetting = 'auto' | 'original';
+/**
+ * Parameters for text-to-video generation. When using happyhorse-character,
+ * reference_image_urls (1-9 images) is required for character consistency.
+ */
 interface TextToVideoParams {
     model: HappyHorseTextToVideoModel;
+    /** Video description prompt. Up to 5000 non-Chinese characters or 2500 Chinese characters. */
     prompt: string;
+    /** Character reference images for happyhorse-character (1-9 URLs). Not supported on happyhorse-text-to-video. */
     reference_image_urls?: string[];
+    /** Output resolution. Defaults to 1080p. */
     output_resolution?: HappyHorseOutputResolution;
+    /** Aspect ratio. Defaults to 16:9. */
     aspect_ratio?: HappyHorseAspectRatio;
+    /** Duration in seconds (3-15). Defaults to 5. */
     duration_seconds?: number;
+    /** Reproducibility seed (0-2147483647). */
     seed?: number;
+    /** URL for completion callback notifications. */
     callback_url?: string;
 }
+/**
+ * Parameters for image-to-video animation. The first-frame image is animated
+ * into video, optionally guided by a text prompt.
+ */
 interface ImageToVideoParams {
     model: HappyHorseImageToVideoModel;
+    /** Source image URL used as the video's opening frame. */
     first_frame_image_url: string;
+    /** Optional motion description prompt. */
     prompt?: string;
+    /** Output resolution. Defaults to 1080p. */
     output_resolution?: HappyHorseOutputResolution;
+    /** Duration in seconds (3-15). Defaults to 5. */
     duration_seconds?: number;
+    /** Reproducibility seed (0-2147483647). */
     seed?: number;
+    /** URL for completion callback notifications. */
     callback_url?: string;
 }
+/**
+ * Parameters for video editing. Transforms the source video according to the prompt.
+ * Source video must be 3-60 seconds, MP4 or MOV format. Use audio_setting to control
+ * whether the original audio is preserved.
+ */
 interface EditVideoParams {
     model: HappyHorseEditVideoModel;
+    /** Editing instruction prompt describing the desired transformation. */
     prompt: string;
+    /** Source video URL to transform (3-60s, MP4/MOV). */
     source_video_url: string;
+    /** Optional reference images to guide the edit (up to 5 URLs). */
     reference_image_urls?: string[];
+    /** Output resolution. Defaults to 1080p. */
     output_resolution?: HappyHorseOutputResolution;
+    /** Audio handling: "auto" lets the model decide, "original" preserves the source audio. */
     audio_setting?: HappyHorseAudioSetting;
+    /** Reproducibility seed (0-2147483647). */
     seed?: number;
+    /** URL for completion callback notifications. */
     callback_url?: string;
 }
 interface TaskCreateResponse {
     id: string;
     status?: AsyncTaskStatus;
 }
+/** A generated video file with a download URL. */
 interface Video {
     url: string;
 }
@@ -65,33 +106,106 @@ type CompletedEditVideoResponse = EditVideoResponse & {
     videos: Video[];
 };
+/** Transform an existing video with a text prompt and optional reference images. Use audio_setting to control whether original audio is preserved. */
 declare class EditVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create an edit-video task and wait until complete.
+     * @param params Edit-video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed task with videos.
+     */
     run(params: EditVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditVideoResponse>;
+    /**
+     * Create an edit-video task; returns immediately with a task id.
+     * @param params Edit-video parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
     create(params: EditVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an edit-video task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current edit-video task status.
+     */
     get(id: string, options?: RequestOptions): Promise<EditVideoResponse>;
 }
+/** Animate a still first-frame image into video, guided by an optional text prompt. */
 declare class ImageToVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Create an image-to-video task and wait until complete.
+     * @param params Image-to-video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed task with videos.
+     */
     run(params: ImageToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedImageToVideoResponse>;
+    /**
+     * Create an image-to-video task; returns immediately with a task id.
+     * @param params Image-to-video parameters.
+     * @param options Per-request overrides.
+     * @returns The task creation result with id.
+     */
     create(params: ImageToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
+    /**
+     * Fetch the current status of an image-to-video task.
+     * @param id The task id.
+     * @param options Per-request overrides.
+     * @returns The current image-to-video task status.
+     */
     get(id: string, options?: RequestOptions): Promise<ImageToVideoResponse>;
 }
+/** Generate video from a text prompt, with optional character consistency via happyhorse-character. */
 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 task with videos.
+     */
     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 with id.
+     */
     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>;
 }
-declare class HappyHorseClient {
+/**
+ * HappyHorse video generation and editing API client.
+ *
+ * @example
+ * ```typescript
+ * const client = new HappyHorseClient({ apiKey: 'your-api-key' });
+ *
+ * const result = await client.textToVideo.run({
+ *   model: 'happyhorse-text-to-video',
+ *   prompt: 'A horse galloping across a sunset beach',
+ * });
+ * ```
+ */
+declare class HappyHorseClient extends BaseClient {
+    /** Generate video from a text prompt, with optional character consistency via happyhorse-character. */
     readonly textToVideo: TextToVideo;
+    /** Animate a still first-frame image into video, guided by an optional text prompt. */
     readonly imageToVideo: ImageToVideo;
+    /** Transform an existing video with a text prompt and optional reference images. */
     readonly editVideo: EditVideo;
     constructor(options?: ClientOptions);
 }

package/dist/index.js CHANGED Viewed

@@ -41,12 +41,132 @@ var import_core4 = require("@runapi.ai/core");
 // src/resources/edit-video.ts
 var import_core = require("@runapi.ai/core");
 var import_internal = require("@runapi.ai/core/internal");
+// src/contract_gen.ts
+var contract = {
+  "edit-video": {
+    "models": [
+      "happyhorse-edit-video"
+    ],
+    "fields_by_model": {
+      "happyhorse-edit-video": {
+        "audio_setting": {
+          "enum": [
+            "auto",
+            "original"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_video_url": {
+          "required": true
+        }
+      }
+    }
+  },
+  "image-to-video": {
+    "models": [
+      "happyhorse-image-to-video"
+    ],
+    "fields_by_model": {
+      "happyhorse-image-to-video": {
+        "duration_seconds": {
+          "type": "integer"
+        },
+        "first_frame_image_url": {
+          "required": true
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  },
+  "text-to-video": {
+    "models": [
+      "happyhorse-character",
+      "happyhorse-text-to-video"
+    ],
+    "fields_by_model": {
+      "happyhorse-character": {
+        "aspect_ratio": {
+          "enum": [
+            "16:9",
+            "9:16",
+            "1:1",
+            "4:3",
+            "3:4"
+          ]
+        },
+        "duration_seconds": {
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "reference_image_urls": {
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "happyhorse-text-to-video": {
+        "aspect_ratio": {
+          "enum": [
+            "16:9",
+            "9:16",
+            "1:1",
+            "4:3",
+            "3:4"
+          ]
+        },
+        "duration_seconds": {
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  }
+};
+// src/resources/edit-video.ts
 var ENDPOINT = "/api/v1/happyhorse/edit_video";
 var EditVideo = class {
   constructor(http) {
     this.http = http;
   }
   http;
+  /**
+   * Create an edit-video task and wait until complete.
+   * @param params Edit-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed task with videos.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await (0, import_internal.pollUntilComplete)(() => this.get(id, options), {
@@ -55,12 +175,26 @@ var EditVideo = class {
     });
     return response;
   }
+  /**
+   * Create an edit-video task; returns immediately with a task id.
+   * @param params Edit-video parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
+    const body = (0, import_core.compactParams)(params);
+    (0, import_core.validateParams)(contract["edit-video"], body);
     return this.http.request("POST", ENDPOINT, {
-      body: (0, import_core.compactParams)(params),
+      body,
       ...options
     });
   }
+  /**
+   * Fetch the current status of an edit-video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current edit-video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, options ?? {});
   }
@@ -75,6 +209,12 @@ var ImageToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Create an image-to-video task and wait until complete.
+   * @param params Image-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed task with videos.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await (0, import_internal2.pollUntilComplete)(() => this.get(id, options), {
@@ -83,12 +223,26 @@ var ImageToVideo = class {
     });
     return response;
   }
+  /**
+   * Create an image-to-video task; returns immediately with a task id.
+   * @param params Image-to-video parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
+    const body = (0, import_core2.compactParams)(params);
+    (0, import_core2.validateParams)(contract["image-to-video"], body);
     return this.http.request("POST", ENDPOINT2, {
-      body: (0, import_core2.compactParams)(params),
+      body,
       ...options
     });
   }
+  /**
+   * Fetch the current status of an image-to-video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current image-to-video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT2}/${id}`, options ?? {});
   }
@@ -103,6 +257,12 @@ var TextToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Create a text-to-video task and wait until complete.
+   * @param params Text-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed task with videos.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await (0, import_internal3.pollUntilComplete)(() => this.get(id, options), {
@@ -111,27 +271,44 @@ 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 with id.
+   */
   async create(params, options) {
+    const body = (0, import_core3.compactParams)(params);
+    (0, import_core3.validateParams)(contract["text-to-video"], body);
     return this.http.request("POST", ENDPOINT3, {
-      body: (0, import_core3.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", `${ENDPOINT3}/${id}`, options ?? {});
   }
 };
 // src/client.ts
-var HappyHorseClient = class {
+var HappyHorseClient = class extends import_core4.BaseClient {
+  /** Generate video from a text prompt, with optional character consistency via happyhorse-character. */
   textToVideo;
+  /** Animate a still first-frame image into video, guided by an optional text prompt. */
   imageToVideo;
+  /** Transform an existing video with a text prompt and optional reference images. */
   editVideo;
   constructor(options = {}) {
-    const http = (0, import_core4.createHttpClient)(options);
-    this.textToVideo = new TextToVideo(http);
-    this.imageToVideo = new ImageToVideo(http);
-    this.editVideo = new EditVideo(http);
+    super(options);
+    this.textToVideo = new TextToVideo(this.http);
+    this.imageToVideo = new ImageToVideo(this.http);
+    this.editVideo = new EditVideo(this.http);
   }
 };

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/edit-video.ts","../src/resources/image-to-video.ts","../src/resources/text-to-video.ts"],"sourcesContent":["export { HappyHorseClient } 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 { EditVideo } from './resources/edit-video';\nimport { ImageToVideo } from './resources/image-to-video';\nimport { TextToVideo } from './resources/text-to-video';\n\nexport class HappyHorseClient {\n public readonly textToVideo: TextToVideo;\n public readonly imageToVideo: ImageToVideo;\n public readonly editVideo: EditVideo;\n\n constructor(options: ClientOptions = {}) {\n const http = createHttpClient(options);\n this.textToVideo = new TextToVideo(http);\n this.imageToVideo = new ImageToVideo(http);\n this.editVideo = new EditVideo(http);\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n CompletedEditVideoResponse,\n EditVideoParams,\n EditVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/edit_video';\n\nexport class EditVideo {\n constructor(private readonly http: HttpClient) {}\n\n async run(params: EditVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<EditVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedEditVideoResponse;\n }\n\n async create(params: EditVideoParams, 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<EditVideoResponse> {\n return this.http.request<EditVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n CompletedImageToVideoResponse,\n ImageToVideoParams,\n ImageToVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/image_to_video';\n\nexport class ImageToVideo {\n constructor(private readonly http: HttpClient) {}\n\n async run(params: ImageToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedImageToVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<ImageToVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedImageToVideoResponse;\n }\n\n async create(params: ImageToVideoParams, 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<ImageToVideoResponse> {\n return this.http.request<ImageToVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n CompletedTextToVideoResponse,\n TaskCreateResponse,\n TextToVideoParams,\n TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/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}`, options ?? {});\n }\n}\n"],"mappings":"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","names":["import_core","import_core","import_internal","ENDPOINT","import_core","import_internal","ENDPOINT","import_core"]}
1	+ {"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/edit-video.ts","../src/contract_gen.ts","../src/resources/image-to-video.ts","../src/resources/text-to-video.ts"],"sourcesContent":["export { HappyHorseClient } 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 { EditVideo } from './resources/edit-video';\nimport { ImageToVideo } from './resources/image-to-video';\nimport { TextToVideo } from './resources/text-to-video';\n\n/*\n HappyHorse video generation and editing API client.\n \n @example\n * ```typescript\n * const client = new HappyHorseClient({ apiKey: 'your-api-key' });\n \n const result = await client.textToVideo.run({\n * model: 'happyhorse-text-to-video',\n * prompt: 'A horse galloping across a sunset beach',\n * });\n * ```\n /\nexport class HappyHorseClient extends BaseClient {\n /* Generate video from a text prompt, with optional character consistency via happyhorse-character. /\n public readonly textToVideo: TextToVideo;\n /* Animate a still first-frame image into video, guided by an optional text prompt. /\n public readonly imageToVideo: ImageToVideo;\n /* Transform an existing video with a text prompt and optional reference images. /\n public readonly editVideo: EditVideo;\n\n constructor(options: ClientOptions = {}) {\n super(options);\n this.textToVideo = new TextToVideo(this.http);\n this.imageToVideo = new ImageToVideo(this.http);\n this.editVideo = new EditVideo(this.http);\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions, 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 CompletedEditVideoResponse,\n EditVideoParams,\n EditVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/edit_video';\n\n/* Transform an existing video with a text prompt and optional reference images. Use audio_setting to control whether original audio is preserved. /\nexport class EditVideo {\n constructor(private readonly http: HttpClient) {}\n\n /\n Create an edit-video task and wait until complete.\n * @param params Edit-video parameters.\n * @param options Per-request and polling overrides.\n * @returns The completed task with videos.\n /\n async run(params: EditVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<EditVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedEditVideoResponse;\n }\n\n /\n Create an edit-video task; returns immediately with a task id.\n * @param params Edit-video parameters.\n * @param options Per-request overrides.\n * @returns The task creation result with id.\n /\n async create(params: EditVideoParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n const body = compactParams(params);\n validateParams(contract['edit-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 an edit-video task.\n * @param id The task id.\n * @param options Per-request overrides.\n * @returns The current edit-video task status.\n /\n async get(id: string, options?: RequestOptions): Promise<EditVideoResponse> {\n return this.http.request<EditVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","export const contract = {\n \"edit-video\": {\n \"models\": [\n \"happyhorse-edit-video\"\n ],\n \"fields_by_model\": {\n \"happyhorse-edit-video\": {\n \"audio_setting\": {\n \"enum\": [\n \"auto\",\n \"original\"\n ]\n },\n \"output_resolution\": {\n \"enum\": [\n \"720p\",\n \"1080p\"\n ]\n },\n \"seed\": {\n \"type\": \"integer\"\n },\n \"source_video_url\": {\n \"required\": true\n }\n }\n }\n },\n \"image-to-video\": {\n \"models\": [\n \"happyhorse-image-to-video\"\n ],\n \"fields_by_model\": {\n \"happyhorse-image-to-video\": {\n \"duration_seconds\": {\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 \"seed\": {\n \"type\": \"integer\"\n }\n }\n }\n },\n \"text-to-video\": {\n \"models\": [\n \"happyhorse-character\",\n \"happyhorse-text-to-video\"\n ],\n \"fields_by_model\": {\n \"happyhorse-character\": {\n \"aspect_ratio\": {\n \"enum\": [\n \"16:9\",\n \"9:16\",\n \"1:1\",\n \"4:3\",\n \"3:4\"\n ]\n },\n \"duration_seconds\": {\n \"type\": \"integer\"\n },\n \"output_resolution\": {\n \"enum\": [\n \"720p\",\n \"1080p\"\n ]\n },\n \"reference_image_urls\": {\n \"required\": true\n },\n \"seed\": {\n \"type\": \"integer\"\n }\n },\n \"happyhorse-text-to-video\": {\n \"aspect_ratio\": {\n \"enum\": [\n \"16:9\",\n \"9:16\",\n \"1:1\",\n \"4:3\",\n \"3:4\"\n ]\n },\n \"duration_seconds\": {\n \"type\": \"integer\"\n },\n \"output_resolution\": {\n \"enum\": [\n \"720p\",\n \"1080p\"\n ]\n },\n \"seed\": {\n \"type\": \"integer\"\n }\n }\n }\n }\n} as const;\n","import type { HttpClient, PollingOptions, RequestOptions, 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 CompletedImageToVideoResponse,\n ImageToVideoParams,\n ImageToVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/image_to_video';\n\n/* Animate a still first-frame image into video, guided by an optional text prompt. /\nexport class ImageToVideo {\n constructor(private readonly http: HttpClient) {}\n\n /\n Create an image-to-video task and wait until complete.\n * @param params Image-to-video parameters.\n * @param options Per-request and polling overrides.\n * @returns The completed task with videos.\n /\n async run(params: ImageToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedImageToVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<ImageToVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedImageToVideoResponse;\n }\n\n /\n Create an image-to-video task; returns immediately with a task id.\n * @param params Image-to-video parameters.\n * @param options Per-request overrides.\n * @returns The task creation result with id.\n /\n async create(params: ImageToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n const body = compactParams(params);\n validateParams(contract['image-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 an image-to-video task.\n * @param id The task id.\n * @param options Per-request overrides.\n * @returns The current image-to-video task status.\n /\n async get(id: string, options?: RequestOptions): Promise<ImageToVideoResponse> {\n return this.http.request<ImageToVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions, 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 TaskCreateResponse,\n TextToVideoParams,\n TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/text_to_video';\n\n/* Generate video from a text prompt, with optional character consistency via happyhorse-character. /\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 task with videos.\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 with id.\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}`, options ?? {});\n }\n}\n"],"mappings":"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","names":["import_core","import_core","import_internal","ENDPOINT","import_core","import_internal","ENDPOINT","import_core"]}

package/dist/index.mjs CHANGED Viewed

@@ -1,15 +1,135 @@
 // src/client.ts
-import { createHttpClient } from "@runapi.ai/core";
+import { BaseClient } from "@runapi.ai/core";
 // src/resources/edit-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 = {
+  "edit-video": {
+    "models": [
+      "happyhorse-edit-video"
+    ],
+    "fields_by_model": {
+      "happyhorse-edit-video": {
+        "audio_setting": {
+          "enum": [
+            "auto",
+            "original"
+          ]
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        },
+        "source_video_url": {
+          "required": true
+        }
+      }
+    }
+  },
+  "image-to-video": {
+    "models": [
+      "happyhorse-image-to-video"
+    ],
+    "fields_by_model": {
+      "happyhorse-image-to-video": {
+        "duration_seconds": {
+          "type": "integer"
+        },
+        "first_frame_image_url": {
+          "required": true
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  },
+  "text-to-video": {
+    "models": [
+      "happyhorse-character",
+      "happyhorse-text-to-video"
+    ],
+    "fields_by_model": {
+      "happyhorse-character": {
+        "aspect_ratio": {
+          "enum": [
+            "16:9",
+            "9:16",
+            "1:1",
+            "4:3",
+            "3:4"
+          ]
+        },
+        "duration_seconds": {
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "reference_image_urls": {
+          "required": true
+        },
+        "seed": {
+          "type": "integer"
+        }
+      },
+      "happyhorse-text-to-video": {
+        "aspect_ratio": {
+          "enum": [
+            "16:9",
+            "9:16",
+            "1:1",
+            "4:3",
+            "3:4"
+          ]
+        },
+        "duration_seconds": {
+          "type": "integer"
+        },
+        "output_resolution": {
+          "enum": [
+            "720p",
+            "1080p"
+          ]
+        },
+        "seed": {
+          "type": "integer"
+        }
+      }
+    }
+  }
+};
+// src/resources/edit-video.ts
 var ENDPOINT = "/api/v1/happyhorse/edit_video";
 var EditVideo = class {
   constructor(http) {
     this.http = http;
   }
   http;
+  /**
+   * Create an edit-video task and wait until complete.
+   * @param params Edit-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed task with videos.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete(() => this.get(id, options), {
@@ -18,19 +138,33 @@ var EditVideo = class {
     });
     return response;
   }
+  /**
+   * Create an edit-video task; returns immediately with a task id.
+   * @param params Edit-video parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
+    const body = compactParams(params);
+    validateParams(contract["edit-video"], body);
     return this.http.request("POST", ENDPOINT, {
-      body: compactParams(params),
+      body,
       ...options
     });
   }
+  /**
+   * Fetch the current status of an edit-video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current edit-video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT}/${id}`, options ?? {});
   }
 };
 // src/resources/image-to-video.ts
-import { compactParams as compactParams2 } from "@runapi.ai/core";
+import { compactParams as compactParams2, validateParams as validateParams2 } from "@runapi.ai/core";
 import { pollUntilComplete as pollUntilComplete2 } from "@runapi.ai/core/internal";
 var ENDPOINT2 = "/api/v1/happyhorse/image_to_video";
 var ImageToVideo = class {
@@ -38,6 +172,12 @@ var ImageToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Create an image-to-video task and wait until complete.
+   * @param params Image-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed task with videos.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete2(() => this.get(id, options), {
@@ -46,19 +186,33 @@ var ImageToVideo = class {
     });
     return response;
   }
+  /**
+   * Create an image-to-video task; returns immediately with a task id.
+   * @param params Image-to-video parameters.
+   * @param options Per-request overrides.
+   * @returns The task creation result with id.
+   */
   async create(params, options) {
+    const body = compactParams2(params);
+    validateParams2(contract["image-to-video"], body);
     return this.http.request("POST", ENDPOINT2, {
-      body: compactParams2(params),
+      body,
       ...options
     });
   }
+  /**
+   * Fetch the current status of an image-to-video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current image-to-video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT2}/${id}`, options ?? {});
   }
 };
 // src/resources/text-to-video.ts
-import { compactParams as compactParams3 } from "@runapi.ai/core";
+import { compactParams as compactParams3, validateParams as validateParams3 } from "@runapi.ai/core";
 import { pollUntilComplete as pollUntilComplete3 } from "@runapi.ai/core/internal";
 var ENDPOINT3 = "/api/v1/happyhorse/text_to_video";
 var TextToVideo = class {
@@ -66,6 +220,12 @@ var TextToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Create a text-to-video task and wait until complete.
+   * @param params Text-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed task with videos.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete3(() => this.get(id, options), {
@@ -74,27 +234,44 @@ 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 with id.
+   */
   async create(params, options) {
+    const body = compactParams3(params);
+    validateParams3(contract["text-to-video"], body);
     return this.http.request("POST", ENDPOINT3, {
-      body: compactParams3(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", `${ENDPOINT3}/${id}`, options ?? {});
   }
 };
 // src/client.ts
-var HappyHorseClient = class {
+var HappyHorseClient = class extends BaseClient {
+  /** Generate video from a text prompt, with optional character consistency via happyhorse-character. */
   textToVideo;
+  /** Animate a still first-frame image into video, guided by an optional text prompt. */
   imageToVideo;
+  /** Transform an existing video with a text prompt and optional reference images. */
   editVideo;
   constructor(options = {}) {
-    const http = createHttpClient(options);
-    this.textToVideo = new TextToVideo(http);
-    this.imageToVideo = new ImageToVideo(http);
-    this.editVideo = new EditVideo(http);
+    super(options);
+    this.textToVideo = new TextToVideo(this.http);
+    this.imageToVideo = new ImageToVideo(this.http);
+    this.editVideo = new EditVideo(this.http);
   }
 };

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/client.ts","../src/resources/edit-video.ts","../src/resources/image-to-video.ts","../src/resources/text-to-video.ts","../src/index.ts"],"sourcesContent":["import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { EditVideo } from './resources/edit-video';\nimport { ImageToVideo } from './resources/image-to-video';\nimport { TextToVideo } from './resources/text-to-video';\n\nexport class HappyHorseClient {\n public readonly textToVideo: TextToVideo;\n public readonly imageToVideo: ImageToVideo;\n public readonly editVideo: EditVideo;\n\n constructor(options: ClientOptions = {}) {\n const http = createHttpClient(options);\n this.textToVideo = new TextToVideo(http);\n this.imageToVideo = new ImageToVideo(http);\n this.editVideo = new EditVideo(http);\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n CompletedEditVideoResponse,\n EditVideoParams,\n EditVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/edit_video';\n\nexport class EditVideo {\n constructor(private readonly http: HttpClient) {}\n\n async run(params: EditVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<EditVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedEditVideoResponse;\n }\n\n async create(params: EditVideoParams, 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<EditVideoResponse> {\n return this.http.request<EditVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n CompletedImageToVideoResponse,\n ImageToVideoParams,\n ImageToVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/image_to_video';\n\nexport class ImageToVideo {\n constructor(private readonly http: HttpClient) {}\n\n async run(params: ImageToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedImageToVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<ImageToVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedImageToVideoResponse;\n }\n\n async create(params: ImageToVideoParams, 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<ImageToVideoResponse> {\n return this.http.request<ImageToVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n CompletedTextToVideoResponse,\n TaskCreateResponse,\n TextToVideoParams,\n TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/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}`, options ?? {});\n }\n}\n","export { HappyHorseClient } 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":["compactParams","pollUntilComplete","ENDPOINT","compactParams","pollUntilComplete","ENDPOINT"]}
1	+ {"version":3,"sources":["../src/client.ts","../src/resources/edit-video.ts","../src/contract_gen.ts","../src/resources/image-to-video.ts","../src/resources/text-to-video.ts","../src/index.ts"],"sourcesContent":["import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { EditVideo } from './resources/edit-video';\nimport { ImageToVideo } from './resources/image-to-video';\nimport { TextToVideo } from './resources/text-to-video';\n\n/*\n HappyHorse video generation and editing API client.\n \n @example\n * ```typescript\n * const client = new HappyHorseClient({ apiKey: 'your-api-key' });\n \n const result = await client.textToVideo.run({\n * model: 'happyhorse-text-to-video',\n * prompt: 'A horse galloping across a sunset beach',\n * });\n * ```\n /\nexport class HappyHorseClient extends BaseClient {\n /* Generate video from a text prompt, with optional character consistency via happyhorse-character. /\n public readonly textToVideo: TextToVideo;\n /* Animate a still first-frame image into video, guided by an optional text prompt. /\n public readonly imageToVideo: ImageToVideo;\n /* Transform an existing video with a text prompt and optional reference images. /\n public readonly editVideo: EditVideo;\n\n constructor(options: ClientOptions = {}) {\n super(options);\n this.textToVideo = new TextToVideo(this.http);\n this.imageToVideo = new ImageToVideo(this.http);\n this.editVideo = new EditVideo(this.http);\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions, 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 CompletedEditVideoResponse,\n EditVideoParams,\n EditVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/edit_video';\n\n/* Transform an existing video with a text prompt and optional reference images. Use audio_setting to control whether original audio is preserved. /\nexport class EditVideo {\n constructor(private readonly http: HttpClient) {}\n\n /\n Create an edit-video task and wait until complete.\n * @param params Edit-video parameters.\n * @param options Per-request and polling overrides.\n * @returns The completed task with videos.\n /\n async run(params: EditVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedEditVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<EditVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedEditVideoResponse;\n }\n\n /\n Create an edit-video task; returns immediately with a task id.\n * @param params Edit-video parameters.\n * @param options Per-request overrides.\n * @returns The task creation result with id.\n /\n async create(params: EditVideoParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n const body = compactParams(params);\n validateParams(contract['edit-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 an edit-video task.\n * @param id The task id.\n * @param options Per-request overrides.\n * @returns The current edit-video task status.\n /\n async get(id: string, options?: RequestOptions): Promise<EditVideoResponse> {\n return this.http.request<EditVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","export const contract = {\n \"edit-video\": {\n \"models\": [\n \"happyhorse-edit-video\"\n ],\n \"fields_by_model\": {\n \"happyhorse-edit-video\": {\n \"audio_setting\": {\n \"enum\": [\n \"auto\",\n \"original\"\n ]\n },\n \"output_resolution\": {\n \"enum\": [\n \"720p\",\n \"1080p\"\n ]\n },\n \"seed\": {\n \"type\": \"integer\"\n },\n \"source_video_url\": {\n \"required\": true\n }\n }\n }\n },\n \"image-to-video\": {\n \"models\": [\n \"happyhorse-image-to-video\"\n ],\n \"fields_by_model\": {\n \"happyhorse-image-to-video\": {\n \"duration_seconds\": {\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 \"seed\": {\n \"type\": \"integer\"\n }\n }\n }\n },\n \"text-to-video\": {\n \"models\": [\n \"happyhorse-character\",\n \"happyhorse-text-to-video\"\n ],\n \"fields_by_model\": {\n \"happyhorse-character\": {\n \"aspect_ratio\": {\n \"enum\": [\n \"16:9\",\n \"9:16\",\n \"1:1\",\n \"4:3\",\n \"3:4\"\n ]\n },\n \"duration_seconds\": {\n \"type\": \"integer\"\n },\n \"output_resolution\": {\n \"enum\": [\n \"720p\",\n \"1080p\"\n ]\n },\n \"reference_image_urls\": {\n \"required\": true\n },\n \"seed\": {\n \"type\": \"integer\"\n }\n },\n \"happyhorse-text-to-video\": {\n \"aspect_ratio\": {\n \"enum\": [\n \"16:9\",\n \"9:16\",\n \"1:1\",\n \"4:3\",\n \"3:4\"\n ]\n },\n \"duration_seconds\": {\n \"type\": \"integer\"\n },\n \"output_resolution\": {\n \"enum\": [\n \"720p\",\n \"1080p\"\n ]\n },\n \"seed\": {\n \"type\": \"integer\"\n }\n }\n }\n }\n} as const;\n","import type { HttpClient, PollingOptions, RequestOptions, 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 CompletedImageToVideoResponse,\n ImageToVideoParams,\n ImageToVideoResponse,\n TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/image_to_video';\n\n/* Animate a still first-frame image into video, guided by an optional text prompt. /\nexport class ImageToVideo {\n constructor(private readonly http: HttpClient) {}\n\n /\n Create an image-to-video task and wait until complete.\n * @param params Image-to-video parameters.\n * @param options Per-request and polling overrides.\n * @returns The completed task with videos.\n /\n async run(params: ImageToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedImageToVideoResponse> {\n const { id } = await this.create(params, options);\n const response = await pollUntilComplete<ImageToVideoResponse>(() => this.get(id, options), {\n maxWaitMs: options?.maxWaitMs,\n pollIntervalMs: options?.pollIntervalMs,\n });\n return response as CompletedImageToVideoResponse;\n }\n\n /\n Create an image-to-video task; returns immediately with a task id.\n * @param params Image-to-video parameters.\n * @param options Per-request overrides.\n * @returns The task creation result with id.\n /\n async create(params: ImageToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n const body = compactParams(params);\n validateParams(contract['image-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 an image-to-video task.\n * @param id The task id.\n * @param options Per-request overrides.\n * @returns The current image-to-video task status.\n /\n async get(id: string, options?: RequestOptions): Promise<ImageToVideoResponse> {\n return this.http.request<ImageToVideoResponse>('GET', `${ENDPOINT}/${id}`, options ?? {});\n }\n}\n","import type { HttpClient, PollingOptions, RequestOptions, 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 TaskCreateResponse,\n TextToVideoParams,\n TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/text_to_video';\n\n/* Generate video from a text prompt, with optional character consistency via happyhorse-character. /\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 task with videos.\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 with id.\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}`, options ?? {});\n }\n}\n","export { HappyHorseClient } 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":["compactParams","validateParams","pollUntilComplete","ENDPOINT","pollUntilComplete","compactParams","validateParams","compactParams","validateParams","pollUntilComplete","ENDPOINT","pollUntilComplete","compactParams","validateParams"]}

package/package.json CHANGED Viewed

@@ -1,7 +1,10 @@
 {
   "name": "@runapi.ai/happyhorse",
-  "version": "0.2.5",
-  "description": "RunAPI HappyHorse SDK for JavaScript, Ruby, and Go",
+  "runapi": {
+    "slug": "happyhorse"
+  },
+  "version": "0.2.7",
+  "description": "RunAPI HappyHorse SDK for text-to-video, image-to-video, and edit-video workflows in JavaScript, Python, Ruby, Go, and Java",
   "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.7"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -47,8 +50,16 @@
     "api",
     "sdk",
     "typescript",
+    "python",
     "ruby",
-    "golang"
+    "golang",
+    "java",
+    "maven",
+    "gradle",
+    "video-generation",
+    "text-to-video",
+    "video-api",
+    "happyhorse-ai-api"
   ],
   "author": "RunAPI",
   "license": "Apache-2.0",
@@ -56,5 +67,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/runapi-ai/happyhorse-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runapi-ai/happyhorse-sdk/issues"
   }
 }

package/skills/happyhorse/README.md CHANGED Viewed

@@ -84,9 +84,11 @@ Image-to-video tasks use `client.imageToVideo` with `model: 'happyhorse-image-to
 ## 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 happyhorse ai 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/happyhorse/SKILL.md CHANGED Viewed

@@ -25,14 +25,23 @@ metadata:
 Generate text, image, or edit-video clips with HappyHorse through RunAPI. Text-to-video can also use ordered reference images through the character model. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
-## Routing decision
+## Critical: Integration Runtime
-- One-off text, image, or edit-video generation 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 HappyHorse 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/happyhorse`
+- Ruby: `runapi-happyhorse`
+- Go: `github.com/runapi-ai/happyhorse-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:
@@ -69,13 +78,9 @@ Available commands: `text-to-video`, `image-to-video`, `edit-video`.
 - `happyhorse-image-to-video`: animate one first-frame image into a 3-15 second video with 720p or 1080p output.
 - `happyhorse-edit-video`: edit one 3-60 second source video using a prompt and up to 5 reference images.
-## SDK integration path
-When integrating HappyHorse into an app, backend, worker, or library, use a RunAPI SDK package:
+## Generated file storage
-- JavaScript / TypeScript: `@runapi.ai/happyhorse`
-- Ruby: `runapi-happyhorse`
-- Go: `github.com/runapi-ai/happyhorse-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