@runapi.ai/happyhorse 0.2.5 → 0.2.6

package/README.md

@@ -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

@@ -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

@@ -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

@@ -47,6 +47,12 @@ var EditVideo = class {
     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 +61,24 @@ 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) {
     return this.http.request("POST", ENDPOINT, {
       body: (0, import_core.compactParams)(params),
       ...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 +93,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 +107,24 @@ 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) {
     return this.http.request("POST", ENDPOINT2, {
       body: (0, import_core2.compactParams)(params),
       ...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 +139,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 +153,42 @@ 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) {
     return this.http.request("POST", ENDPOINT3, {
       body: (0, import_core3.compactParams)(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text-to-video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text-to-video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${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

@@ -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"]}
+{"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 { 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 } 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\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\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","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\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\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 } 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\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text-to-video task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text-to-video task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, 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

@@ -1,5 +1,5 @@
 // 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";
@@ -10,6 +10,12 @@ var EditVideo = class {
     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,12 +24,24 @@ 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) {
     return this.http.request("POST", ENDPOINT, {
       body: compactParams(params),
       ...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 ?? {});
   }
@@ -38,6 +56,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,12 +70,24 @@ 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) {
     return this.http.request("POST", ENDPOINT2, {
       body: compactParams2(params),
       ...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 ?? {});
   }
@@ -66,6 +102,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 +116,42 @@ 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) {
     return this.http.request("POST", ENDPOINT3, {
       body: compactParams3(params),
       ...options
     });
   }
+  /**
+   * Fetch the current status of a text-to-video task.
+   * @param id The task id.
+   * @param options Per-request overrides.
+   * @returns The current text-to-video task status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${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

@@ -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"]}
+{"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 { 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 } 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\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\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","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\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\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 } 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\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    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  /**\n   * Fetch the current status of a text-to-video task.\n   * @param id The task id.\n   * @param options Per-request overrides.\n   * @returns The current text-to-video task status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/happyhorse",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "RunAPI HappyHorse SDK for JavaScript, Ruby, and Go",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -28,7 +28,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.5"
+    "@runapi.ai/core": "^0.2.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/skills/happyhorse/README.md

@@ -84,6 +84,8 @@ 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.

package/skills/happyhorse/SKILL.md

@@ -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