@runapi.ai/happyhorse 0.2.4 → 0.2.6

package/README.md

@@ -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, reference-to-video, and edit-video workflows that need JSON request bodies, task status lookup, and consistent RunAPI errors in JavaScript.
+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.
 
 ## Install
 
@@ -15,15 +15,18 @@ import { HappyHorseClient } from '@runapi.ai/happyhorse';
 
 const client = new HappyHorseClient();
 const video = await client.textToVideo.run({
-  model: 'happyhorse-text-to-video',
-  prompt: 'A tiny paper horse gallops through a miniature cardboard city at night.',
-  resolution: '1080p',
+  model: 'happyhorse-character',
+  prompt: 'Character1 walks through a miniature cardboard city at night.',
+  reference_image_urls: ['https://cdn.runapi.ai/public/samples/reference-1.jpg'],
+  output_resolution: '1080p',
   aspect_ratio: '16:9',
-  duration: 5,
+  duration_seconds: 5,
 });
 ```
 
-For image-to-video, call `client.imageToVideo.run` with `model: 'happyhorse-image-to-video'` and exactly one `image_urls` entry. For reference-to-video, call `client.referenceToVideo.run` with `model: 'happyhorse-reference-to-video'` and 1-9 `reference_image` entries. For edit-video, call `client.editVideo.run` with `model: 'happyhorse-video-edit'`, one `video_url`, and optional `reference_image` entries.
+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
 
@@ -31,8 +34,8 @@ For image-to-video, call `client.imageToVideo.run` with `model: 'happyhorse-imag
 - SDK docs: https://runapi.ai/docs#sdk-happyhorse
 - Product docs: https://runapi.ai/docs#happyhorse
 - Image-to-video pricing and rate limits: https://runapi.ai/models/happyhorse/image-to-video
-- Reference-to-video pricing and rate limits: https://runapi.ai/models/happyhorse/reference-to-video
-- Edit-video pricing and rate limits: https://runapi.ai/models/happyhorse/video-edit
+- Character pricing and rate limits: https://runapi.ai/models/happyhorse/character
+- Edit-video pricing and rate limits: https://runapi.ai/models/happyhorse/edit-video
 - Pricing and rate limits: https://runapi.ai/models/happyhorse/text-to-video
 - Provider comparison: https://runapi.ai/providers/alibaba
 - Full catalog: https://runapi.ai/models

package/dist/index.d.mts

@@ -1,55 +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';
 
-type HappyHorseTextToVideoModel = 'happyhorse-text-to-video';
+/**
+ * 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 HappyHorseReferenceToVideoModel = 'happyhorse-reference-to-video';
-type HappyHorseEditVideoModel = 'happyhorse-video-edit';
-type HappyHorseResolution = '720p' | '1080p';
+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';
-type HappyHorseAudioSetting = 'auto' | 'origin';
+/** 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;
-    resolution?: HappyHorseResolution;
+    /** 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?: number;
+    /** 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;
-    image_urls: string[];
+    /** Source image URL used as the video's opening frame. */
+    first_frame_image_url: string;
+    /** Optional motion description prompt. */
     prompt?: string;
-    resolution?: HappyHorseResolution;
-    duration?: number;
-    seed?: number;
-    callback_url?: string;
-}
-interface ReferenceToVideoParams {
-    model: HappyHorseReferenceToVideoModel;
-    prompt: string;
-    reference_image: string[];
-    resolution?: HappyHorseResolution;
-    aspect_ratio?: HappyHorseAspectRatio;
-    duration?: number;
+    /** 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;
-    video_url: string;
-    reference_image?: string[];
-    resolution?: HappyHorseResolution;
+    /** 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;
 }
@@ -69,55 +100,114 @@ type CompletedImageToVideoResponse = ImageToVideoResponse & {
     status: 'completed';
     videos: Video[];
 };
-type ReferenceToVideoResponse = TextToVideoResponse;
-type CompletedReferenceToVideoResponse = ReferenceToVideoResponse & {
-    status: 'completed';
-    videos: Video[];
-};
 type EditVideoResponse = TextToVideoResponse;
 type CompletedEditVideoResponse = EditVideoResponse & {
     status: 'completed';
     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>;
 }
 
-declare class ReferenceToVideo {
-    private readonly http;
-    constructor(http: HttpClient);
-    run(params: ReferenceToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedReferenceToVideoResponse>;
-    create(params: ReferenceToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
-    get(id: string, options?: RequestOptions): Promise<ReferenceToVideoResponse>;
-}
-
+/** 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;
-    readonly referenceToVideo: ReferenceToVideo;
+    /** Transform an existing video with a text prompt and optional reference images. */
     readonly editVideo: EditVideo;
     constructor(options?: ClientOptions);
 }
 
-export { type CompletedEditVideoResponse, type CompletedImageToVideoResponse, type CompletedReferenceToVideoResponse, type CompletedTextToVideoResponse, type EditVideoParams, type EditVideoResponse, type HappyHorseAspectRatio, type HappyHorseAudioSetting, HappyHorseClient, type HappyHorseEditVideoModel, type HappyHorseImageToVideoModel, type HappyHorseReferenceToVideoModel, type HappyHorseResolution, type HappyHorseTextToVideoModel, type ImageToVideoParams, type ImageToVideoResponse, type ReferenceToVideoParams, type ReferenceToVideoResponse, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type Video };
+export { type CompletedEditVideoResponse, type CompletedImageToVideoResponse, type CompletedTextToVideoResponse, type EditVideoParams, type EditVideoResponse, type HappyHorseAspectRatio, type HappyHorseAudioSetting, HappyHorseClient, type HappyHorseEditVideoModel, type HappyHorseImageToVideoModel, type HappyHorseOutputResolution, type HappyHorseTextToVideoModel, type ImageToVideoParams, type ImageToVideoResponse, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type Video };

package/dist/index.d.ts

@@ -1,55 +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';
 
-type HappyHorseTextToVideoModel = 'happyhorse-text-to-video';
+/**
+ * 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 HappyHorseReferenceToVideoModel = 'happyhorse-reference-to-video';
-type HappyHorseEditVideoModel = 'happyhorse-video-edit';
-type HappyHorseResolution = '720p' | '1080p';
+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';
-type HappyHorseAudioSetting = 'auto' | 'origin';
+/** 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;
-    resolution?: HappyHorseResolution;
+    /** 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?: number;
+    /** 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;
-    image_urls: string[];
+    /** Source image URL used as the video's opening frame. */
+    first_frame_image_url: string;
+    /** Optional motion description prompt. */
     prompt?: string;
-    resolution?: HappyHorseResolution;
-    duration?: number;
-    seed?: number;
-    callback_url?: string;
-}
-interface ReferenceToVideoParams {
-    model: HappyHorseReferenceToVideoModel;
-    prompt: string;
-    reference_image: string[];
-    resolution?: HappyHorseResolution;
-    aspect_ratio?: HappyHorseAspectRatio;
-    duration?: number;
+    /** 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;
-    video_url: string;
-    reference_image?: string[];
-    resolution?: HappyHorseResolution;
+    /** 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;
 }
@@ -69,55 +100,114 @@ type CompletedImageToVideoResponse = ImageToVideoResponse & {
     status: 'completed';
     videos: Video[];
 };
-type ReferenceToVideoResponse = TextToVideoResponse;
-type CompletedReferenceToVideoResponse = ReferenceToVideoResponse & {
-    status: 'completed';
-    videos: Video[];
-};
 type EditVideoResponse = TextToVideoResponse;
 type CompletedEditVideoResponse = EditVideoResponse & {
     status: 'completed';
     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>;
 }
 
-declare class ReferenceToVideo {
-    private readonly http;
-    constructor(http: HttpClient);
-    run(params: ReferenceToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedReferenceToVideoResponse>;
-    create(params: ReferenceToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse>;
-    get(id: string, options?: RequestOptions): Promise<ReferenceToVideoResponse>;
-}
-
+/** 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;
-    readonly referenceToVideo: ReferenceToVideo;
+    /** Transform an existing video with a text prompt and optional reference images. */
     readonly editVideo: EditVideo;
     constructor(options?: ClientOptions);
 }
 
-export { type CompletedEditVideoResponse, type CompletedImageToVideoResponse, type CompletedReferenceToVideoResponse, type CompletedTextToVideoResponse, type EditVideoParams, type EditVideoResponse, type HappyHorseAspectRatio, type HappyHorseAudioSetting, HappyHorseClient, type HappyHorseEditVideoModel, type HappyHorseImageToVideoModel, type HappyHorseReferenceToVideoModel, type HappyHorseResolution, type HappyHorseTextToVideoModel, type ImageToVideoParams, type ImageToVideoResponse, type ReferenceToVideoParams, type ReferenceToVideoResponse, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type Video };
+export { type CompletedEditVideoResponse, type CompletedImageToVideoResponse, type CompletedTextToVideoResponse, type EditVideoParams, type EditVideoResponse, type HappyHorseAspectRatio, type HappyHorseAudioSetting, HappyHorseClient, type HappyHorseEditVideoModel, type HappyHorseImageToVideoModel, type HappyHorseOutputResolution, type HappyHorseTextToVideoModel, type ImageToVideoParams, type ImageToVideoResponse, type TaskCreateResponse, type TextToVideoParams, type TextToVideoResponse, type Video };

package/dist/index.js

@@ -20,23 +20,23 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  AuthenticationError: () => import_core6.AuthenticationError,
+  AuthenticationError: () => import_core5.AuthenticationError,
   HappyHorseClient: () => HappyHorseClient,
-  InsufficientCreditsError: () => import_core6.InsufficientCreditsError,
-  NetworkError: () => import_core6.NetworkError,
-  NotFoundError: () => import_core6.NotFoundError,
-  RateLimitError: () => import_core6.RateLimitError,
-  RunApiError: () => import_core6.RunApiError,
-  ServiceUnavailableError: () => import_core6.ServiceUnavailableError,
-  TaskFailedError: () => import_core6.TaskFailedError,
-  TaskTimeoutError: () => import_core6.TaskTimeoutError,
-  TimeoutError: () => import_core6.TimeoutError,
-  ValidationError: () => import_core6.ValidationError
+  InsufficientCreditsError: () => import_core5.InsufficientCreditsError,
+  NetworkError: () => import_core5.NetworkError,
+  NotFoundError: () => import_core5.NotFoundError,
+  RateLimitError: () => import_core5.RateLimitError,
+  RunApiError: () => import_core5.RunApiError,
+  ServiceUnavailableError: () => import_core5.ServiceUnavailableError,
+  TaskFailedError: () => import_core5.TaskFailedError,
+  TaskTimeoutError: () => import_core5.TaskTimeoutError,
+  TimeoutError: () => import_core5.TimeoutError,
+  ValidationError: () => import_core5.ValidationError
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var import_core5 = require("@runapi.ai/core");
+var import_core4 = require("@runapi.ai/core");
 
 // src/resources/edit-video.ts
 var import_core = require("@runapi.ai/core");
@@ -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,26 +107,44 @@ 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 ?? {});
   }
 };
 
-// src/resources/reference-to-video.ts
+// src/resources/text-to-video.ts
 var import_core3 = require("@runapi.ai/core");
 var import_internal3 = require("@runapi.ai/core/internal");
-var ENDPOINT3 = "/api/v1/happyhorse/reference_to_video";
-var ReferenceToVideo = class {
+var ENDPOINT3 = "/api/v1/happyhorse/text_to_video";
+var TextToVideo = class {
   constructor(http) {
     this.http = http;
   }
   http;
+  /**
+   * Create a text-to-video task and wait until complete.
+   * @param params Text-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed 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,62 +153,47 @@ var ReferenceToVideo = 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/resources/text-to-video.ts
-var import_core4 = require("@runapi.ai/core");
-var import_internal4 = require("@runapi.ai/core/internal");
-var ENDPOINT4 = "/api/v1/happyhorse/text_to_video";
-var TextToVideo = class {
-  constructor(http) {
-    this.http = http;
-  }
-  http;
-  async run(params, options) {
-    const { id } = await this.create(params, options);
-    const response = await (0, import_internal4.pollUntilComplete)(() => this.get(id, options), {
-      maxWaitMs: options?.maxWaitMs,
-      pollIntervalMs: options?.pollIntervalMs
-    });
-    return response;
-  }
-  async create(params, options) {
-    return this.http.request("POST", ENDPOINT4, {
-      body: (0, import_core4.compactParams)(params),
-      ...options
-    });
-  }
-  async get(id, options) {
-    return this.http.request("GET", `${ENDPOINT4}/${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;
-  referenceToVideo;
+  /** Transform an existing video with a text prompt and optional reference images. */
   editVideo;
   constructor(options = {}) {
-    const http = (0, import_core5.createHttpClient)(options);
-    this.textToVideo = new TextToVideo(http);
-    this.imageToVideo = new ImageToVideo(http);
-    this.referenceToVideo = new ReferenceToVideo(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);
   }
 };
 
 // src/index.ts
-var import_core6 = require("@runapi.ai/core");
+var import_core5 = require("@runapi.ai/core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,

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/reference-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 { ReferenceToVideo } from './resources/reference-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 referenceToVideo: ReferenceToVideo;\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.referenceToVideo = new ReferenceToVideo(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  CompletedReferenceToVideoResponse,\n  ReferenceToVideoParams,\n  ReferenceToVideoResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/reference_to_video';\n\nexport class ReferenceToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: ReferenceToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedReferenceToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<ReferenceToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedReferenceToVideoResponse;\n  }\n\n  async create(params: ReferenceToVideoParams, 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<ReferenceToVideoResponse> {\n    return this.http.request<ReferenceToVideoResponse>('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","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,26 +70,44 @@ 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 ?? {});
   }
 };
 
-// src/resources/reference-to-video.ts
+// src/resources/text-to-video.ts
 import { compactParams as compactParams3 } from "@runapi.ai/core";
 import { pollUntilComplete as pollUntilComplete3 } from "@runapi.ai/core/internal";
-var ENDPOINT3 = "/api/v1/happyhorse/reference_to_video";
-var ReferenceToVideo = class {
+var ENDPOINT3 = "/api/v1/happyhorse/text_to_video";
+var TextToVideo = class {
   constructor(http) {
     this.http = http;
   }
   http;
+  /**
+   * Create a text-to-video task and wait until complete.
+   * @param params Text-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed task with videos.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete3(() => this.get(id, options), {
@@ -74,57 +116,42 @@ var ReferenceToVideo = 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/resources/text-to-video.ts
-import { compactParams as compactParams4 } from "@runapi.ai/core";
-import { pollUntilComplete as pollUntilComplete4 } from "@runapi.ai/core/internal";
-var ENDPOINT4 = "/api/v1/happyhorse/text_to_video";
-var TextToVideo = class {
-  constructor(http) {
-    this.http = http;
-  }
-  http;
-  async run(params, options) {
-    const { id } = await this.create(params, options);
-    const response = await pollUntilComplete4(() => this.get(id, options), {
-      maxWaitMs: options?.maxWaitMs,
-      pollIntervalMs: options?.pollIntervalMs
-    });
-    return response;
-  }
-  async create(params, options) {
-    return this.http.request("POST", ENDPOINT4, {
-      body: compactParams4(params),
-      ...options
-    });
-  }
-  async get(id, options) {
-    return this.http.request("GET", `${ENDPOINT4}/${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;
-  referenceToVideo;
+  /** 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.referenceToVideo = new ReferenceToVideo(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/reference-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 { ReferenceToVideo } from './resources/reference-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 referenceToVideo: ReferenceToVideo;\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.referenceToVideo = new ReferenceToVideo(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  CompletedReferenceToVideoResponse,\n  ReferenceToVideoParams,\n  ReferenceToVideoResponse,\n  TaskCreateResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/happyhorse/reference_to_video';\n\nexport class ReferenceToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: ReferenceToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedReferenceToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<ReferenceToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedReferenceToVideoResponse;\n  }\n\n  async create(params: ReferenceToVideoParams, 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<ReferenceToVideoResponse> {\n    return this.http.request<ReferenceToVideoResponse>('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","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.4",
+  "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.4"
+    "@runapi.ai/core": "^0.2.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/skills/happyhorse/README.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  Install this agent skill, inspect HappyHorse fields, then run text, image, reference-to-video, or edit-video jobs through the RunAPI CLI.
+  Install this agent skill, inspect HappyHorse fields, then run text, image, or edit-video jobs through the RunAPI CLI.
 </p>
 
 <p align="center">
@@ -21,7 +21,7 @@
 </div>
 <br/>
 
-Generate text, image, reference-to-video, or edit-video clips with HappyHorse in 720p or 1080p. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate HappyHorse through RunAPI.
+Generate text, image, or edit-video clips with HappyHorse in 720p or 1080p. Text-to-video can also use ordered reference images through the character model. This skill helps Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents integrate HappyHorse through RunAPI.
 
 The canonical agent file is `skills/happyhorse/SKILL.md`.
 
@@ -51,22 +51,23 @@ import { HappyHorseClient } from '@runapi.ai/happyhorse';
 
 const client = new HappyHorseClient();
 const result = await client.textToVideo.run({
-  model: 'happyhorse-text-to-video',
-  prompt: 'A tiny paper horse gallops through a miniature cardboard city at night.',
-  resolution: '1080p',
+  model: 'happyhorse-character',
+  prompt: 'Character1 walks through a miniature cardboard city at night.',
+  reference_image_urls: ['https://cdn.runapi.ai/public/samples/reference-1.jpg'],
+  output_resolution: '1080p',
   aspect_ratio: '16:9',
-  duration: 5,
+  duration_seconds: 5,
 });
 ```
 
-Image-to-video tasks use `client.imageToVideo` with `model: 'happyhorse-image-to-video'` and exactly one `image_urls` entry. Reference-to-video tasks use `client.referenceToVideo` with `model: 'happyhorse-reference-to-video'` and 1-9 `reference_image` entries. Edit-video tasks use `client.editVideo` with `model: 'happyhorse-video-edit'`, one `video_url`, and optional `reference_image` entries.
+Image-to-video tasks use `client.imageToVideo` with `model: 'happyhorse-image-to-video'` and `first_frame_image_url`. Character-guided text-to-video tasks use `client.textToVideo` with `model: 'happyhorse-character'` and 1-9 `reference_image_urls` entries. Edit-video tasks use `client.editVideo` with `model: 'happyhorse-edit-video'`, one `source_video_url`, and optional `reference_image_urls`.
 
 ## Variants
 
 - `happyhorse-text-to-video`: create 3-15 second videos from a text prompt with 720p or 1080p output.
+- `happyhorse-character`: create 3-15 second text-to-video clips guided by 1-9 ordered reference images.
 - `happyhorse-image-to-video`: animate one first-frame image into a 3-15 second video with 720p or 1080p output.
-- `happyhorse-reference-to-video`: create 3-15 second videos from a prompt and 1-9 ordered reference images.
-- `happyhorse-video-edit`: edit one 3-60 second source video using a prompt and up to 5 reference images.
+- `happyhorse-edit-video`: edit one 3-60 second source video using a prompt and up to 5 reference images.
 
 ## Routing
 
@@ -75,14 +76,16 @@ Image-to-video tasks use `client.imageToVideo` with `model: 'happyhorse-image-to
 - SDK docs: https://runapi.ai/docs#sdk-happyhorse
 - SDK repository: https://github.com/runapi-ai/happyhorse-sdk
 - Image-to-video pricing and rate limits: https://runapi.ai/models/happyhorse/image-to-video
-- Reference-to-video pricing and rate limits: https://runapi.ai/models/happyhorse/reference-to-video
-- Edit-video pricing and rate limits: https://runapi.ai/models/happyhorse/video-edit
+- Character pricing and rate limits: https://runapi.ai/models/happyhorse/character
+- Edit-video pricing and rate limits: https://runapi.ai/models/happyhorse/edit-video
 - Pricing and rate limits: https://runapi.ai/models/happyhorse/text-to-video
 - Provider comparison: https://runapi.ai/providers/alibaba
 - Browse all RunAPI models and skills: https://runapi.ai/models
 
 ## 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

@@ -1,6 +1,6 @@
 ---
 name: happyhorse
-description: Generate text, image, reference-to-video, or edit-video clips with HappyHorse through RunAPI. Use when the user asks an agent to create video from text, a first-frame image, reference images, or an edited source video with HappyHorse. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
+description: Generate text, image, or edit-video clips with HappyHorse through RunAPI. Use when the user asks an agent to create video from text, a first-frame image, ordered reference images, or an edited source video with HappyHorse. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
 documentation: https://runapi.ai/models/happyhorse.md
 provider_page: https://runapi.ai/providers/alibaba.md
 catalog: https://runapi.ai/models.md
@@ -18,21 +18,30 @@ metadata:
     envVars:
     - name: RUNAPI_API_KEY
       required: false
-      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.
+      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive only.
 ---
 
 # HappyHorse on RunAPI
 
-Generate text, image, reference-to-video, or edit-video clips with HappyHorse through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
+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, reference-to-video, 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:
 
@@ -40,7 +49,6 @@ Inspect the available commands and request fields with CLI help:
 runapi happyhorse --help
 runapi happyhorse text-to-video --help
 runapi happyhorse image-to-video --help
-runapi happyhorse reference-to-video --help
 runapi happyhorse edit-video --help
 ```
 
@@ -49,7 +57,6 @@ Run a one-off task:
 ```shell
 runapi happyhorse text-to-video --input-file request.json
 runapi happyhorse image-to-video --input-file request.json
-runapi happyhorse reference-to-video --input-file request.json
 runapi happyhorse edit-video --input-file request.json
 ```
 
@@ -60,31 +67,27 @@ runapi happyhorse text-to-video --async --input-file request.json
 runapi wait <task-id> --service happyhorse --action text-to-video
 ```
 
-For image-to-video, reference-to-video, and edit-video, use the same async pattern with `--action image-to-video`, `--action reference-to-video`, or `--action edit-video`.
+For image-to-video and edit-video, use the same async pattern with `--action image-to-video` or `--action edit-video`.
 
-Available commands: `text-to-video`, `image-to-video`, `reference-to-video`, `edit-video`.
+Available commands: `text-to-video`, `image-to-video`, `edit-video`.
 
 ## Variants
 
 - `happyhorse-text-to-video`: create 3-15 second videos from a text prompt with 720p or 1080p output.
+- `happyhorse-character`: create 3-15 second text-to-video clips guided by 1-9 ordered reference images.
 - `happyhorse-image-to-video`: animate one first-frame image into a 3-15 second video with 720p or 1080p output.
-- `happyhorse-reference-to-video`: create 3-15 second videos from a prompt and 1-9 ordered reference images.
-- `happyhorse-video-edit`: edit one 3-60 second source video using a prompt and up to 5 reference images.
-
-## SDK integration path
+- `happyhorse-edit-video`: edit one 3-60 second source video using a prompt and up to 5 reference images.
 
-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
 
 - Model overview, pricing, and rate limits: https://runapi.ai/models/happyhorse.md
 - Text-to-video variant: https://runapi.ai/models/happyhorse/text-to-video.md
+- Character variant: https://runapi.ai/models/happyhorse/character.md
 - Image-to-video variant: https://runapi.ai/models/happyhorse/image-to-video.md
-- Reference-to-video variant: https://runapi.ai/models/happyhorse/reference-to-video.md
-- Edit-video variant: https://runapi.ai/models/happyhorse/video-edit.md
+- Edit-video variant: https://runapi.ai/models/happyhorse/edit-video.md
 - Provider comparison: https://runapi.ai/providers/alibaba.md
 - Full model catalog: https://runapi.ai/models.md