@runapi.ai/gemini-omni 0.2.6 → 0.2.7

package/README.md

@@ -32,6 +32,8 @@ const video = await client.textToVideo.run({
 });
 ```
 
+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/gemini-omni

package/dist/index.d.mts

@@ -1,108 +1,240 @@
-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, TimeoutError, ValidationError } from '@runapi.ai/core';
 
+/**
+ * One of 30 preset voice identities for audio creation.
+ * Each voice has a distinct pitch, cadence, and personality.
+ * Pass the chosen value to {@link CreateAudioParams.audio_id}.
+ */
 type GeminiOmniAudioVoice = 'achernar' | 'achird' | 'algenib' | 'algieba' | 'alnilam' | 'aoede' | 'autonoe' | 'callirrhoe' | 'charon' | 'despina' | 'enceladus' | 'erinome' | 'fenrir' | 'gacrux' | 'iapetus' | 'kore' | 'laomedeia' | 'leda' | 'orus' | 'puck' | 'pulcherrima' | 'rasalgethi' | 'sadachbia' | 'sadaltager' | 'schedar' | 'sulafat' | 'umbriel' | 'vindemiatrix' | 'zephyr' | 'zubenelgenubi';
+/**
+ * Parameters for registering a reusable voice preset.
+ * The returned audio ID can be attached to characters or text-to-video params
+ * to control narration voice.
+ */
 interface CreateAudioParams {
+    /** Preset voice identity. See {@link GeminiOmniAudioVoice} for the full list. */
     audio_id: GeminiOmniAudioVoice | string;
+    /** Display name for the voice preset, max 210 characters. */
     name: string;
+    /** Describes vocal characteristics (pitch, tone, accent), max 20 000 characters. */
     voice_description?: string;
+    /** Example dialogue line demonstrating the voice style, max 120 characters. */
     example_dialogue?: string;
 }
+/** A created voice preset with its server-assigned ID. */
 interface GeminiOmniAudio {
     id: string;
     name?: string;
     [key: string]: unknown;
 }
+/** Result of a synchronous create-audio call. */
 interface CreateAudioResponse {
     id: string;
+    /** The created voice preset; present on success. */
     audio?: GeminiOmniAudio;
     error?: string;
     [key: string]: unknown;
 }
+/**
+ * Parameters for building a reusable character from a reference image and description.
+ * The returned character ID can be passed to {@link TextToVideoParams.character_ids}
+ * for consistent identity across videos.
+ */
 interface CreateCharacterParams {
+    /** Appearance, identity, style, clothing, or personality description. */
     descriptions: string;
+    /** Character reference image URL, max 20 MB. */
     reference_image_url: string;
+    /** Audio IDs from create-audio to give the character a specific voice. */
     audio_ids?: string[];
+    /** Character display name, max 210 characters. */
     character_name?: string;
 }
+/** URL to a generated or reference image. */
 interface ImageMetadata {
     url: string;
     [key: string]: unknown;
 }
+/** A created character with its reference images. */
 interface GeminiOmniCharacter {
     id: string;
     name?: string;
+    /** Reference images associated with this character. */
     images?: ImageMetadata[];
     [key: string]: unknown;
 }
+/** Result of a synchronous create-character call. */
 interface CreateCharacterResponse {
     id: string;
+    /** The created character; present on success. */
     character?: GeminiOmniCharacter;
     error?: string;
     [key: string]: unknown;
 }
+/** Video duration in seconds. Longer durations consume more credits. */
 type GeminiOmniTextToVideoDuration = 4 | 6 | 8 | 10;
+/** Output aspect ratio -- landscape (16:9) or portrait (9:16). */
 type GeminiOmniTextToVideoAspectRatio = '16:9' | '9:16';
+/** Output resolution -- higher resolutions produce sharper video at higher cost. */
 type GeminiOmniTextToVideoResolution = '720p' | '1080p' | '4k';
+/**
+ * A trimmed segment of a source video for use in text-to-video generation.
+ * The trimmed segment (start to ends) must be within 10 seconds.
+ * Each clip consumes 2 reference units toward the 7-unit limit.
+ */
 interface GeminiOmniTextToVideoClip {
+    /** Public source video URL. */
     url: string;
+    /** Trim start time in seconds (>= 0). */
     start: number;
+    /** Trim end time in seconds (must be > start, within 10 s of start). */
     ends: number;
 }
+/**
+ * Parameters for multimodal video generation.
+ * Pre-create characters via `createCharacter` and audio voices via `createAudio`,
+ * then reference their IDs here.
+ *
+ * Reference units are shared: images (1 each) + video clips (2 each) + characters (1 each)
+ * must total 7 or fewer.
+ */
 interface TextToVideoParams {
+    /** Video generation prompt, max 20 000 characters. */
     prompt: string;
+    /** Output video duration in seconds. */
     duration_seconds: GeminiOmniTextToVideoDuration;
+    /** HTTPS callback URL for task completion notification. */
     callback_url?: string;
+    /** Reference image URLs, max 7. Each consumes 1 reference unit. */
     reference_image_urls?: string[];
+    /** Audio IDs from create-audio for narration voices, max 3. */
     audio_ids?: string[];
+    /** Source video clips for motion reference, max 1. Each consumes 2 reference units. */
     video_list?: GeminiOmniTextToVideoClip[];
+    /** Character IDs from create-character for consistent identity, max 3. Each consumes 1 reference unit. */
     character_ids?: string[];
     aspect_ratio?: GeminiOmniTextToVideoAspectRatio;
+    /** Defaults to 720p. */
     output_resolution?: GeminiOmniTextToVideoResolution;
+    /** Reproducibility seed in [0, 2 147 483 647]. */
     seed?: number;
 }
+/** Acknowledgement returned by `create()` before the task starts processing. */
 interface TaskCreateResponse {
     id: string;
     status?: AsyncTaskStatus;
 }
+/** URL to a generated video file. */
 interface VideoMetadata {
     url: string;
 }
+/** Async text-to-video task result with lifecycle status. */
 interface TextToVideoResponse {
     id: string;
     status: AsyncTaskStatus;
+    /** Generated video files; populated once the task completes. */
     videos?: VideoMetadata[];
     error?: string;
     [key: string]: unknown;
 }
+/** Narrowed response returned by `run()` once polling confirms completion. Videos are guaranteed present. */
 type CompletedTextToVideoResponse = TextToVideoResponse & {
     status: 'completed';
     videos: VideoMetadata[];
 };
 
+/**
+ * Registers a reusable voice preset from a built-in voice identity.
+ * This is a synchronous operation -- only `run()` is available (no create/get polling).
+ */
 declare class CreateAudio {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Register a reusable voice preset (synchronous).
+     * @param params Voice preset parameters.
+     * @param options Per-request overrides.
+     * @returns The created audio voice preset.
+     */
     run(params: CreateAudioParams, options?: RequestOptions): Promise<CreateAudioResponse>;
 }
 
+/**
+ * Builds a reusable character from a reference image and description.
+ * Attach audio IDs to give the character a specific voice.
+ * This is a synchronous operation -- only `run()` is available (no create/get polling).
+ */
 declare class CreateCharacter {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Build a reusable character (synchronous).
+     * @param params Character creation parameters.
+     * @param options Per-request overrides.
+     * @returns The created character.
+     */
     run(params: CreateCharacterParams, options?: RequestOptions): Promise<CreateCharacterResponse>;
 }
 
+/**
+ * Generates video from a prompt with optional characters, audio voices, reference images, and video clips.
+ * This is an async operation -- use `run()` for automatic polling or `create()`/`get()` for manual control.
+ */
 declare class TextToVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Generate a video and wait until complete.
+     * @param params Text-to-video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text-to-video result.
+     */
     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 status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToVideoResponse>;
 }
 
-declare class GeminiOmniClient {
+/**
+ * Gemini Omni multimodal generation client for voice presets, character creation,
+ * and text-to-video with optional characters, audio voices, and reference media.
+ *
+ * @example
+ * ```typescript
+ * import { GeminiOmniClient } from '@runapi.ai/gemini-omni';
+ * const client = new GeminiOmniClient({ apiKey: 'sk-...' });
+ *
+ * // Create a voice preset, then generate a video using it
+ * const audio = await client.createAudio.run({
+ *   audio_id: 'zephyr',
+ *   name: 'Narrator',
+ * });
+ * const video = await client.textToVideo.run({
+ *   prompt: 'A narrator walks through a futuristic city',
+ *   duration_seconds: 6,
+ *   audio_ids: [audio.audio!.id],
+ * });
+ * console.log(video.videos[0].url);
+ * ```
+ */
+declare class GeminiOmniClient extends BaseClient {
+    /** Registers a reusable voice preset from a built-in voice identity (synchronous). */
     readonly createAudio: CreateAudio;
+    /** Builds a reusable character from a reference image and description (synchronous). */
     readonly createCharacter: CreateCharacter;
+    /** Generates video from a prompt with optional characters, voices, images, and clips (async with polling). */
     readonly textToVideo: TextToVideo;
     constructor(options?: ClientOptions);
 }

package/dist/index.d.ts

@@ -1,108 +1,240 @@
-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, TimeoutError, ValidationError } from '@runapi.ai/core';
 
+/**
+ * One of 30 preset voice identities for audio creation.
+ * Each voice has a distinct pitch, cadence, and personality.
+ * Pass the chosen value to {@link CreateAudioParams.audio_id}.
+ */
 type GeminiOmniAudioVoice = 'achernar' | 'achird' | 'algenib' | 'algieba' | 'alnilam' | 'aoede' | 'autonoe' | 'callirrhoe' | 'charon' | 'despina' | 'enceladus' | 'erinome' | 'fenrir' | 'gacrux' | 'iapetus' | 'kore' | 'laomedeia' | 'leda' | 'orus' | 'puck' | 'pulcherrima' | 'rasalgethi' | 'sadachbia' | 'sadaltager' | 'schedar' | 'sulafat' | 'umbriel' | 'vindemiatrix' | 'zephyr' | 'zubenelgenubi';
+/**
+ * Parameters for registering a reusable voice preset.
+ * The returned audio ID can be attached to characters or text-to-video params
+ * to control narration voice.
+ */
 interface CreateAudioParams {
+    /** Preset voice identity. See {@link GeminiOmniAudioVoice} for the full list. */
     audio_id: GeminiOmniAudioVoice | string;
+    /** Display name for the voice preset, max 210 characters. */
     name: string;
+    /** Describes vocal characteristics (pitch, tone, accent), max 20 000 characters. */
     voice_description?: string;
+    /** Example dialogue line demonstrating the voice style, max 120 characters. */
     example_dialogue?: string;
 }
+/** A created voice preset with its server-assigned ID. */
 interface GeminiOmniAudio {
     id: string;
     name?: string;
     [key: string]: unknown;
 }
+/** Result of a synchronous create-audio call. */
 interface CreateAudioResponse {
     id: string;
+    /** The created voice preset; present on success. */
     audio?: GeminiOmniAudio;
     error?: string;
     [key: string]: unknown;
 }
+/**
+ * Parameters for building a reusable character from a reference image and description.
+ * The returned character ID can be passed to {@link TextToVideoParams.character_ids}
+ * for consistent identity across videos.
+ */
 interface CreateCharacterParams {
+    /** Appearance, identity, style, clothing, or personality description. */
     descriptions: string;
+    /** Character reference image URL, max 20 MB. */
     reference_image_url: string;
+    /** Audio IDs from create-audio to give the character a specific voice. */
     audio_ids?: string[];
+    /** Character display name, max 210 characters. */
     character_name?: string;
 }
+/** URL to a generated or reference image. */
 interface ImageMetadata {
     url: string;
     [key: string]: unknown;
 }
+/** A created character with its reference images. */
 interface GeminiOmniCharacter {
     id: string;
     name?: string;
+    /** Reference images associated with this character. */
     images?: ImageMetadata[];
     [key: string]: unknown;
 }
+/** Result of a synchronous create-character call. */
 interface CreateCharacterResponse {
     id: string;
+    /** The created character; present on success. */
     character?: GeminiOmniCharacter;
     error?: string;
     [key: string]: unknown;
 }
+/** Video duration in seconds. Longer durations consume more credits. */
 type GeminiOmniTextToVideoDuration = 4 | 6 | 8 | 10;
+/** Output aspect ratio -- landscape (16:9) or portrait (9:16). */
 type GeminiOmniTextToVideoAspectRatio = '16:9' | '9:16';
+/** Output resolution -- higher resolutions produce sharper video at higher cost. */
 type GeminiOmniTextToVideoResolution = '720p' | '1080p' | '4k';
+/**
+ * A trimmed segment of a source video for use in text-to-video generation.
+ * The trimmed segment (start to ends) must be within 10 seconds.
+ * Each clip consumes 2 reference units toward the 7-unit limit.
+ */
 interface GeminiOmniTextToVideoClip {
+    /** Public source video URL. */
     url: string;
+    /** Trim start time in seconds (>= 0). */
     start: number;
+    /** Trim end time in seconds (must be > start, within 10 s of start). */
     ends: number;
 }
+/**
+ * Parameters for multimodal video generation.
+ * Pre-create characters via `createCharacter` and audio voices via `createAudio`,
+ * then reference their IDs here.
+ *
+ * Reference units are shared: images (1 each) + video clips (2 each) + characters (1 each)
+ * must total 7 or fewer.
+ */
 interface TextToVideoParams {
+    /** Video generation prompt, max 20 000 characters. */
     prompt: string;
+    /** Output video duration in seconds. */
     duration_seconds: GeminiOmniTextToVideoDuration;
+    /** HTTPS callback URL for task completion notification. */
     callback_url?: string;
+    /** Reference image URLs, max 7. Each consumes 1 reference unit. */
     reference_image_urls?: string[];
+    /** Audio IDs from create-audio for narration voices, max 3. */
     audio_ids?: string[];
+    /** Source video clips for motion reference, max 1. Each consumes 2 reference units. */
     video_list?: GeminiOmniTextToVideoClip[];
+    /** Character IDs from create-character for consistent identity, max 3. Each consumes 1 reference unit. */
     character_ids?: string[];
     aspect_ratio?: GeminiOmniTextToVideoAspectRatio;
+    /** Defaults to 720p. */
     output_resolution?: GeminiOmniTextToVideoResolution;
+    /** Reproducibility seed in [0, 2 147 483 647]. */
     seed?: number;
 }
+/** Acknowledgement returned by `create()` before the task starts processing. */
 interface TaskCreateResponse {
     id: string;
     status?: AsyncTaskStatus;
 }
+/** URL to a generated video file. */
 interface VideoMetadata {
     url: string;
 }
+/** Async text-to-video task result with lifecycle status. */
 interface TextToVideoResponse {
     id: string;
     status: AsyncTaskStatus;
+    /** Generated video files; populated once the task completes. */
     videos?: VideoMetadata[];
     error?: string;
     [key: string]: unknown;
 }
+/** Narrowed response returned by `run()` once polling confirms completion. Videos are guaranteed present. */
 type CompletedTextToVideoResponse = TextToVideoResponse & {
     status: 'completed';
     videos: VideoMetadata[];
 };
 
+/**
+ * Registers a reusable voice preset from a built-in voice identity.
+ * This is a synchronous operation -- only `run()` is available (no create/get polling).
+ */
 declare class CreateAudio {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Register a reusable voice preset (synchronous).
+     * @param params Voice preset parameters.
+     * @param options Per-request overrides.
+     * @returns The created audio voice preset.
+     */
     run(params: CreateAudioParams, options?: RequestOptions): Promise<CreateAudioResponse>;
 }
 
+/**
+ * Builds a reusable character from a reference image and description.
+ * Attach audio IDs to give the character a specific voice.
+ * This is a synchronous operation -- only `run()` is available (no create/get polling).
+ */
 declare class CreateCharacter {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Build a reusable character (synchronous).
+     * @param params Character creation parameters.
+     * @param options Per-request overrides.
+     * @returns The created character.
+     */
     run(params: CreateCharacterParams, options?: RequestOptions): Promise<CreateCharacterResponse>;
 }
 
+/**
+ * Generates video from a prompt with optional characters, audio voices, reference images, and video clips.
+ * This is an async operation -- use `run()` for automatic polling or `create()`/`get()` for manual control.
+ */
 declare class TextToVideo {
     private readonly http;
     constructor(http: HttpClient);
+    /**
+     * Generate a video and wait until complete.
+     * @param params Text-to-video parameters.
+     * @param options Per-request and polling overrides.
+     * @returns The completed text-to-video result.
+     */
     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 status.
+     */
     get(id: string, options?: RequestOptions): Promise<TextToVideoResponse>;
 }
 
-declare class GeminiOmniClient {
+/**
+ * Gemini Omni multimodal generation client for voice presets, character creation,
+ * and text-to-video with optional characters, audio voices, and reference media.
+ *
+ * @example
+ * ```typescript
+ * import { GeminiOmniClient } from '@runapi.ai/gemini-omni';
+ * const client = new GeminiOmniClient({ apiKey: 'sk-...' });
+ *
+ * // Create a voice preset, then generate a video using it
+ * const audio = await client.createAudio.run({
+ *   audio_id: 'zephyr',
+ *   name: 'Narrator',
+ * });
+ * const video = await client.textToVideo.run({
+ *   prompt: 'A narrator walks through a futuristic city',
+ *   duration_seconds: 6,
+ *   audio_ids: [audio.audio!.id],
+ * });
+ * console.log(video.videos[0].url);
+ * ```
+ */
+declare class GeminiOmniClient extends BaseClient {
+    /** Registers a reusable voice preset from a built-in voice identity (synchronous). */
     readonly createAudio: CreateAudio;
+    /** Builds a reusable character from a reference image and description (synchronous). */
     readonly createCharacter: CreateCharacter;
+    /** Generates video from a prompt with optional characters, voices, images, and clips (async with polling). */
     readonly textToVideo: TextToVideo;
     constructor(options?: ClientOptions);
 }

package/dist/index.js

@@ -44,6 +44,12 @@ var CreateAudio = class {
     this.http = http;
   }
   http;
+  /**
+   * Register a reusable voice preset (synchronous).
+   * @param params Voice preset parameters.
+   * @param options Per-request overrides.
+   * @returns The created audio voice preset.
+   */
   async run(params, options) {
     return this.http.request("POST", ENDPOINT, {
       body: (0, import_core.compactParams)(params),
@@ -60,6 +66,12 @@ var CreateCharacter = class {
     this.http = http;
   }
   http;
+  /**
+   * Build a reusable character (synchronous).
+   * @param params Character creation parameters.
+   * @param options Per-request overrides.
+   * @returns The created character.
+   */
   async run(params, options) {
     return this.http.request("POST", ENDPOINT2, {
       body: (0, import_core2.compactParams)(params),
@@ -77,6 +89,12 @@ var TextToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Generate a video and wait until complete.
+   * @param params Text-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text-to-video result.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await (0, import_internal.pollUntilComplete)(() => this.get(id, options), {
@@ -85,12 +103,24 @@ 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 status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT3}/${id}`, {
       ...options
@@ -99,15 +129,18 @@ var TextToVideo = class {
 };
 
 // src/client.ts
-var GeminiOmniClient = class {
+var GeminiOmniClient = class extends import_core4.BaseClient {
+  /** Registers a reusable voice preset from a built-in voice identity (synchronous). */
   createAudio;
+  /** Builds a reusable character from a reference image and description (synchronous). */
   createCharacter;
+  /** Generates video from a prompt with optional characters, voices, images, and clips (async with polling). */
   textToVideo;
   constructor(options = {}) {
-    const http = (0, import_core4.createHttpClient)(options);
-    this.createAudio = new CreateAudio(http);
-    this.createCharacter = new CreateCharacter(http);
-    this.textToVideo = new TextToVideo(http);
+    super(options);
+    this.createAudio = new CreateAudio(this.http);
+    this.createCharacter = new CreateCharacter(this.http);
+    this.textToVideo = new TextToVideo(this.http);
   }
 };
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/create-audio.ts","../src/resources/create-character.ts","../src/resources/text-to-video.ts"],"sourcesContent":["export { GeminiOmniClient } from './client';\nexport * from './types';\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n} from '@runapi.ai/core';\n","import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { CreateAudio } from './resources/create-audio';\nimport { CreateCharacter } from './resources/create-character';\nimport { TextToVideo } from './resources/text-to-video';\n\nexport class GeminiOmniClient {\n  public readonly createAudio: CreateAudio;\n  public readonly createCharacter: CreateCharacter;\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.createAudio = new CreateAudio(http);\n    this.createCharacter = new CreateCharacter(http);\n    this.textToVideo = new TextToVideo(http);\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateAudioParams, CreateAudioResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_audio';\n\nexport class CreateAudio {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: CreateAudioParams, options?: RequestOptions): Promise<CreateAudioResponse> {\n    return this.http.request<CreateAudioResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateCharacterParams, CreateCharacterResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_character';\n\nexport class CreateCharacter {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: CreateCharacterParams, options?: RequestOptions): Promise<CreateCharacterResponse> {\n    return this.http.request<CreateCharacterResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToVideoResponse,\n  TaskCreateResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/text_to_video';\n\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToVideoResponse;\n  }\n\n  async create(params: TextToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,eAAqD;;;ACCrD,kBAA8B;AAG9B,IAAM,WAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAwD;AAC3F,WAAO,KAAK,KAAK,QAA6B,QAAQ,UAAU;AAAA,MAC9D,UAAM,2BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACdA,IAAAC,eAA8B;AAG9B,IAAMC,YAAW;AAEV,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA+B,SAA4D;AACnG,WAAO,KAAK,KAAK,QAAiC,QAAQA,WAAU;AAAA,MAClE,UAAM,4BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACdA,IAAAC,eAA8B;AAC9B,sBAAkC;AAQlC,IAAMC,YAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,UAAM,mCAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQA,WAAU;AAAA,MAC7D,UAAM,4BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAGA,SAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AH/BO,IAAM,mBAAN,MAAuB;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,WAAO,+BAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AACvC,SAAK,kBAAkB,IAAI,gBAAgB,IAAI;AAC/C,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;ADdA,IAAAC,eAUO;","names":["import_core","import_core","ENDPOINT","import_core","ENDPOINT","import_core"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/create-audio.ts","../src/resources/create-character.ts","../src/resources/text-to-video.ts"],"sourcesContent":["export { GeminiOmniClient } from './client';\nexport * from './types';\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n} from '@runapi.ai/core';\n","import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { CreateAudio } from './resources/create-audio';\nimport { CreateCharacter } from './resources/create-character';\nimport { TextToVideo } from './resources/text-to-video';\n\n/**\n * Gemini Omni multimodal generation client for voice presets, character creation,\n * and text-to-video with optional characters, audio voices, and reference media.\n *\n * @example\n * ```typescript\n * import { GeminiOmniClient } from '@runapi.ai/gemini-omni';\n * const client = new GeminiOmniClient({ apiKey: 'sk-...' });\n *\n * // Create a voice preset, then generate a video using it\n * const audio = await client.createAudio.run({\n *   audio_id: 'zephyr',\n *   name: 'Narrator',\n * });\n * const video = await client.textToVideo.run({\n *   prompt: 'A narrator walks through a futuristic city',\n *   duration_seconds: 6,\n *   audio_ids: [audio.audio!.id],\n * });\n * console.log(video.videos[0].url);\n * ```\n */\nexport class GeminiOmniClient extends BaseClient {\n  /** Registers a reusable voice preset from a built-in voice identity (synchronous). */\n  public readonly createAudio: CreateAudio;\n  /** Builds a reusable character from a reference image and description (synchronous). */\n  public readonly createCharacter: CreateCharacter;\n  /** Generates video from a prompt with optional characters, voices, images, and clips (async with polling). */\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.createAudio = new CreateAudio(this.http);\n    this.createCharacter = new CreateCharacter(this.http);\n    this.textToVideo = new TextToVideo(this.http);\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateAudioParams, CreateAudioResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_audio';\n\n/**\n * Registers a reusable voice preset from a built-in voice identity.\n * This is a synchronous operation -- only `run()` is available (no create/get polling).\n */\nexport class CreateAudio {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Register a reusable voice preset (synchronous).\n   * @param params Voice preset parameters.\n   * @param options Per-request overrides.\n   * @returns The created audio voice preset.\n   */\n  async run(params: CreateAudioParams, options?: RequestOptions): Promise<CreateAudioResponse> {\n    return this.http.request<CreateAudioResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateCharacterParams, CreateCharacterResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_character';\n\n/**\n * Builds a reusable character from a reference image and description.\n * Attach audio IDs to give the character a specific voice.\n * This is a synchronous operation -- only `run()` is available (no create/get polling).\n */\nexport class CreateCharacter {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Build a reusable character (synchronous).\n   * @param params Character creation parameters.\n   * @param options Per-request overrides.\n   * @returns The created character.\n   */\n  async run(params: CreateCharacterParams, options?: RequestOptions): Promise<CreateCharacterResponse> {\n    return this.http.request<CreateCharacterResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToVideoResponse,\n  TaskCreateResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/text_to_video';\n\n/**\n * Generates video from a prompt with optional characters, audio voices, reference images, and video clips.\n * This is an async operation -- use `run()` for automatic polling or `create()`/`get()` for manual control.\n */\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate a video and wait until complete.\n   * @param params Text-to-video parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed text-to-video result.\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 status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,eAA+C;;;ACC/C,kBAA8B;AAG9B,IAAM,WAAW;AAMV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAwD;AAC3F,WAAO,KAAK,KAAK,QAA6B,QAAQ,UAAU;AAAA,MAC9D,UAAM,2BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACxBA,IAAAC,eAA8B;AAG9B,IAAMC,YAAW;AAOV,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA+B,SAA4D;AACnG,WAAO,KAAK,KAAK,QAAiC,QAAQA,WAAU;AAAA,MAClE,UAAM,4BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACzBA,IAAAC,eAA8B;AAC9B,sBAAkC;AAQlC,IAAMC,YAAW;AAMV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,UAAM,mCAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQA,WAAU;AAAA,MAC7D,UAAM,4BAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAGA,SAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AH/BO,IAAM,mBAAN,cAA+B,wBAAW;AAAA;AAAA,EAE/B;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,kBAAkB,IAAI,gBAAgB,KAAK,IAAI;AACpD,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAAA,EAC9C;AACF;;;ADvCA,IAAAC,eAUO;","names":["import_core","import_core","ENDPOINT","import_core","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/create-audio.ts
 import { compactParams } from "@runapi.ai/core";
@@ -9,6 +9,12 @@ var CreateAudio = class {
     this.http = http;
   }
   http;
+  /**
+   * Register a reusable voice preset (synchronous).
+   * @param params Voice preset parameters.
+   * @param options Per-request overrides.
+   * @returns The created audio voice preset.
+   */
   async run(params, options) {
     return this.http.request("POST", ENDPOINT, {
       body: compactParams(params),
@@ -25,6 +31,12 @@ var CreateCharacter = class {
     this.http = http;
   }
   http;
+  /**
+   * Build a reusable character (synchronous).
+   * @param params Character creation parameters.
+   * @param options Per-request overrides.
+   * @returns The created character.
+   */
   async run(params, options) {
     return this.http.request("POST", ENDPOINT2, {
       body: compactParams2(params),
@@ -42,6 +54,12 @@ var TextToVideo = class {
     this.http = http;
   }
   http;
+  /**
+   * Generate a video and wait until complete.
+   * @param params Text-to-video parameters.
+   * @param options Per-request and polling overrides.
+   * @returns The completed text-to-video result.
+   */
   async run(params, options) {
     const { id } = await this.create(params, options);
     const response = await pollUntilComplete(() => this.get(id, options), {
@@ -50,12 +68,24 @@ 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 status.
+   */
   async get(id, options) {
     return this.http.request("GET", `${ENDPOINT3}/${id}`, {
       ...options
@@ -64,15 +94,18 @@ var TextToVideo = class {
 };
 
 // src/client.ts
-var GeminiOmniClient = class {
+var GeminiOmniClient = class extends BaseClient {
+  /** Registers a reusable voice preset from a built-in voice identity (synchronous). */
   createAudio;
+  /** Builds a reusable character from a reference image and description (synchronous). */
   createCharacter;
+  /** Generates video from a prompt with optional characters, voices, images, and clips (async with polling). */
   textToVideo;
   constructor(options = {}) {
-    const http = createHttpClient(options);
-    this.createAudio = new CreateAudio(http);
-    this.createCharacter = new CreateCharacter(http);
-    this.textToVideo = new TextToVideo(http);
+    super(options);
+    this.createAudio = new CreateAudio(this.http);
+    this.createCharacter = new CreateCharacter(this.http);
+    this.textToVideo = new TextToVideo(this.http);
   }
 };
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/resources/create-audio.ts","../src/resources/create-character.ts","../src/resources/text-to-video.ts","../src/index.ts"],"sourcesContent":["import { createHttpClient, type ClientOptions } from '@runapi.ai/core';\nimport { CreateAudio } from './resources/create-audio';\nimport { CreateCharacter } from './resources/create-character';\nimport { TextToVideo } from './resources/text-to-video';\n\nexport class GeminiOmniClient {\n  public readonly createAudio: CreateAudio;\n  public readonly createCharacter: CreateCharacter;\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    const http = createHttpClient(options);\n    this.createAudio = new CreateAudio(http);\n    this.createCharacter = new CreateCharacter(http);\n    this.textToVideo = new TextToVideo(http);\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateAudioParams, CreateAudioResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_audio';\n\nexport class CreateAudio {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: CreateAudioParams, options?: RequestOptions): Promise<CreateAudioResponse> {\n    return this.http.request<CreateAudioResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateCharacterParams, CreateCharacterResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_character';\n\nexport class CreateCharacter {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: CreateCharacterParams, options?: RequestOptions): Promise<CreateCharacterResponse> {\n    return this.http.request<CreateCharacterResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToVideoResponse,\n  TaskCreateResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/text_to_video';\n\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  async run(params: TextToVideoParams, options?: RequestOptions & PollingOptions): Promise<CompletedTextToVideoResponse> {\n    const { id } = await this.create(params, options);\n    const response = await pollUntilComplete<TextToVideoResponse>(() => this.get(id, options), {\n      maxWaitMs: options?.maxWaitMs,\n      pollIntervalMs: options?.pollIntervalMs,\n    });\n    return response as CompletedTextToVideoResponse;\n  }\n\n  async create(params: TextToVideoParams, options?: RequestOptions): Promise<TaskCreateResponse> {\n    return this.http.request<TaskCreateResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { GeminiOmniClient } from './client';\nexport * from './types';\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n} from '@runapi.ai/core';\n"],"mappings":";AAAA,SAAS,wBAA4C;;;ACCrD,SAAS,qBAAqB;AAG9B,IAAM,WAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAwD;AAC3F,WAAO,KAAK,KAAK,QAA6B,QAAQ,UAAU;AAAA,MAC9D,MAAM,cAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACdA,SAAS,iBAAAA,sBAAqB;AAG9B,IAAMC,YAAW;AAEV,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA+B,SAA4D;AACnG,WAAO,KAAK,KAAK,QAAiC,QAAQA,WAAU;AAAA,MAClE,MAAMD,eAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACdA,SAAS,iBAAAE,sBAAqB;AAC9B,SAAS,yBAAyB;AAQlC,IAAMC,YAAW;AAEV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,MAAM,kBAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQA,WAAU;AAAA,MAC7D,MAAMD,eAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAGC,SAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AH/BO,IAAM,mBAAN,MAAuB;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO,iBAAiB,OAAO;AACrC,SAAK,cAAc,IAAI,YAAY,IAAI;AACvC,SAAK,kBAAkB,IAAI,gBAAgB,IAAI;AAC/C,SAAK,cAAc,IAAI,YAAY,IAAI;AAAA,EACzC;AACF;;;AIdA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["compactParams","ENDPOINT","compactParams","ENDPOINT"]}
+{"version":3,"sources":["../src/client.ts","../src/resources/create-audio.ts","../src/resources/create-character.ts","../src/resources/text-to-video.ts","../src/index.ts"],"sourcesContent":["import { BaseClient, type ClientOptions } from '@runapi.ai/core';\nimport { CreateAudio } from './resources/create-audio';\nimport { CreateCharacter } from './resources/create-character';\nimport { TextToVideo } from './resources/text-to-video';\n\n/**\n * Gemini Omni multimodal generation client for voice presets, character creation,\n * and text-to-video with optional characters, audio voices, and reference media.\n *\n * @example\n * ```typescript\n * import { GeminiOmniClient } from '@runapi.ai/gemini-omni';\n * const client = new GeminiOmniClient({ apiKey: 'sk-...' });\n *\n * // Create a voice preset, then generate a video using it\n * const audio = await client.createAudio.run({\n *   audio_id: 'zephyr',\n *   name: 'Narrator',\n * });\n * const video = await client.textToVideo.run({\n *   prompt: 'A narrator walks through a futuristic city',\n *   duration_seconds: 6,\n *   audio_ids: [audio.audio!.id],\n * });\n * console.log(video.videos[0].url);\n * ```\n */\nexport class GeminiOmniClient extends BaseClient {\n  /** Registers a reusable voice preset from a built-in voice identity (synchronous). */\n  public readonly createAudio: CreateAudio;\n  /** Builds a reusable character from a reference image and description (synchronous). */\n  public readonly createCharacter: CreateCharacter;\n  /** Generates video from a prompt with optional characters, voices, images, and clips (async with polling). */\n  public readonly textToVideo: TextToVideo;\n\n  constructor(options: ClientOptions = {}) {\n    super(options);\n    this.createAudio = new CreateAudio(this.http);\n    this.createCharacter = new CreateCharacter(this.http);\n    this.textToVideo = new TextToVideo(this.http);\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateAudioParams, CreateAudioResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_audio';\n\n/**\n * Registers a reusable voice preset from a built-in voice identity.\n * This is a synchronous operation -- only `run()` is available (no create/get polling).\n */\nexport class CreateAudio {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Register a reusable voice preset (synchronous).\n   * @param params Voice preset parameters.\n   * @param options Per-request overrides.\n   * @returns The created audio voice preset.\n   */\n  async run(params: CreateAudioParams, options?: RequestOptions): Promise<CreateAudioResponse> {\n    return this.http.request<CreateAudioResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport type { CreateCharacterParams, CreateCharacterResponse } from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/create_character';\n\n/**\n * Builds a reusable character from a reference image and description.\n * Attach audio IDs to give the character a specific voice.\n * This is a synchronous operation -- only `run()` is available (no create/get polling).\n */\nexport class CreateCharacter {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Build a reusable character (synchronous).\n   * @param params Character creation parameters.\n   * @param options Per-request overrides.\n   * @returns The created character.\n   */\n  async run(params: CreateCharacterParams, options?: RequestOptions): Promise<CreateCharacterResponse> {\n    return this.http.request<CreateCharacterResponse>('POST', ENDPOINT, {\n      body: compactParams(params),\n      ...options,\n    });\n  }\n}\n","import type { HttpClient, RequestOptions, PollingOptions } from '@runapi.ai/core';\nimport { compactParams } from '@runapi.ai/core';\nimport { pollUntilComplete } from '@runapi.ai/core/internal';\nimport type {\n  CompletedTextToVideoResponse,\n  TaskCreateResponse,\n  TextToVideoParams,\n  TextToVideoResponse,\n} from '../types';\n\nconst ENDPOINT = '/api/v1/gemini_omni/text_to_video';\n\n/**\n * Generates video from a prompt with optional characters, audio voices, reference images, and video clips.\n * This is an async operation -- use `run()` for automatic polling or `create()`/`get()` for manual control.\n */\nexport class TextToVideo {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Generate a video and wait until complete.\n   * @param params Text-to-video parameters.\n   * @param options Per-request and polling overrides.\n   * @returns The completed text-to-video result.\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 status.\n   */\n  async get(id: string, options?: RequestOptions): Promise<TextToVideoResponse> {\n    return this.http.request<TextToVideoResponse>('GET', `${ENDPOINT}/${id}`, {\n      ...options,\n    });\n  }\n}\n","export { GeminiOmniClient } from './client';\nexport * from './types';\nexport {\n  RunApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  NotFoundError,\n  ValidationError,\n  RateLimitError,\n  ServiceUnavailableError,\n  NetworkError,\n  TimeoutError,\n} from '@runapi.ai/core';\n"],"mappings":";AAAA,SAAS,kBAAsC;;;ACC/C,SAAS,qBAAqB;AAG9B,IAAM,WAAW;AAMV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAwD;AAC3F,WAAO,KAAK,KAAK,QAA6B,QAAQ,UAAU;AAAA,MAC9D,MAAM,cAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACxBA,SAAS,iBAAAA,sBAAqB;AAG9B,IAAMC,YAAW;AAOV,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA+B,SAA4D;AACnG,WAAO,KAAK,KAAK,QAAiC,QAAQA,WAAU;AAAA,MAClE,MAAMD,eAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;ACzBA,SAAS,iBAAAE,sBAAqB;AAC9B,SAAS,yBAAyB;AAQlC,IAAMC,YAAW;AAMV,IAAM,cAAN,MAAkB;AAAA,EACvB,YAA6B,MAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,MAAM,IAAI,QAA2B,SAAkF;AACrH,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO;AAChD,UAAM,WAAW,MAAM,kBAAuC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG;AAAA,MACzF,WAAW,SAAS;AAAA,MACpB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAO,QAA2B,SAAuD;AAC7F,WAAO,KAAK,KAAK,QAA4B,QAAQA,WAAU;AAAA,MAC7D,MAAMD,eAAc,MAAM;AAAA,MAC1B,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,IAAY,SAAwD;AAC5E,WAAO,KAAK,KAAK,QAA6B,OAAO,GAAGC,SAAQ,IAAI,EAAE,IAAI;AAAA,MACxE,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;;;AH/BO,IAAM,mBAAN,cAA+B,WAAW;AAAA;AAAA,EAE/B;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAEhB,YAAY,UAAyB,CAAC,GAAG;AACvC,UAAM,OAAO;AACb,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAC5C,SAAK,kBAAkB,IAAI,gBAAgB,KAAK,IAAI;AACpD,SAAK,cAAc,IAAI,YAAY,KAAK,IAAI;AAAA,EAC9C;AACF;;;AIvCA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["compactParams","ENDPOINT","compactParams","ENDPOINT"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/gemini-omni",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "RunAPI Gemini Omni SDK for audio, character, and video workflows in 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/gemini-omni/README.md

@@ -68,6 +68,11 @@ runapi wait <task-id> --service gemini-omni --action text-to-video
 - Provider comparison: https://runapi.ai/providers/google
 - 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.
+
 ## License
 
 Licensed under the Apache License, Version 2.0.

package/skills/gemini-omni/SKILL.md

@@ -25,10 +25,19 @@ metadata:
 
 Create Gemini Omni voice resources, character resources, and text-to-video tasks through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
 
-## Routing decision
+## Critical: Integration Runtime
 
-- One-off voice, character, or 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 Gemini Omni 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/gemini-omni`
+- Ruby: `runapi-gemini-omni`
+- Go: `github.com/runapi-ai/gemini-omni-sdk/go`
 
 ## Variants
 
@@ -38,7 +47,7 @@ Create Gemini Omni voice resources, character resources, and text-to-video tasks
 
 ## 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.
+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.
 
 Inspect the available commands and request fields with CLI help:
 
@@ -64,13 +73,9 @@ runapi wait <task-id> --service gemini-omni --action text-to-video
 
 Available commands: `create-audio`, `create-character`, `text-to-video`.
 
-## SDK integration path
-
-When integrating Gemini Omni into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:
+## Generated file storage
 
-- JavaScript / TypeScript: `@runapi.ai/gemini-omni`
-- Ruby: `runapi-gemini-omni`
-- Go: `github.com/runapi-ai/gemini-omni-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