feat: Add support for video model media params

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 75
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-cb426a424ebc4c1b0c9a774aa167edb2cc78139736fb9cb3314678e8cbdc0b57.yml
-openapi_spec_hash: eb45b0703de7ff4daf0502f78597a3b7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-76f8801298719cc87e9dc4c64b321bcfd432416d76488499d340b4bb6bf81b9b.yml
+openapi_spec_hash: ce0b83ef0a5f174461bd7d13a379b636
 config_hash: 52d213100a0ca1a4b2cdcd2718936b51

src/resources/videos.ts

@@ -131,10 +131,16 @@ export interface VideoCreateParams {
   fps?: number;
 
   /**
-   * Array of images to guide video generation, similar to keyframes.
+   * @deprecated Deprecated: use media.frame_images instead. Array of images to guide
+   * video generation, similar to keyframes.
    */
   frame_images?: Array<VideoCreateParams.FrameImage>;
 
+  /**
+   * Whether to generate audio for the video.
+   */
+  generate_audio?: boolean;
+
   /**
    * Controls how closely the video generation follows your prompt. Higher values
    * make the model adhere more strictly to your text description, while lower values
@@ -146,6 +152,12 @@ export interface VideoCreateParams {
 
   height?: number;
 
+  /**
+   * Media inputs for video generation. The accepted fields depend on the model type
+   * (e.g. i2v, r2v, t2v, videoedit).
+   */
+  media?: VideoCreateParams.Media;
+
   /**
    * Similar to prompt, but specifies what to avoid instead of what to include
    */
@@ -167,12 +179,22 @@ export interface VideoCreateParams {
   prompt?: string;
 
   /**
-   * Unlike frame_images which constrain specific timeline positions, reference
-   * images guide the general appearance that should appear consistently across the
-   * video.
+   * Aspect ratio of the video.
+   */
+  ratio?: string;
+
+  /**
+   * @deprecated Deprecated: use media.reference_images instead. Unlike frame_images
+   * which constrain specific timeline positions, reference images guide the general
+   * appearance that should appear consistently across the video.
    */
   reference_images?: Array<string>;
 
+  /**
+   * Video resolution.
+   */
+  resolution?: string;
+
   /**
    * Clip duration in seconds.
    */
@@ -212,6 +234,92 @@ export namespace VideoCreateParams {
      */
     frame?: number | 'first' | 'last';
   }
+
+  /**
+   * Media inputs for video generation. The accepted fields depend on the model type
+   * (e.g. i2v, r2v, t2v, videoedit).
+   */
+  export interface Media {
+    /**
+     * Array of audio inputs.
+     */
+    audio_inputs?: Array<Media.AudioInput>;
+
+    /**
+     * Array of images to guide video generation at specific timeline positions.
+     */
+    frame_images?: Array<Media.FrameImage>;
+
+    /**
+     * Array of video clips to use as starting clips.
+     */
+    frame_videos?: Array<Media.FrameVideo>;
+
+    /**
+     * Array of image URLs that guide the general appearance across the video.
+     */
+    reference_images?: Array<string>;
+
+    /**
+     * Array of reference videos.
+     */
+    reference_videos?: Array<Media.ReferenceVideo>;
+
+    /**
+     * Source video to edit.
+     */
+    source_video?: Media.SourceVideo;
+  }
+
+  export namespace Media {
+    export interface AudioInput {
+      /**
+       * URL of the audio.
+       */
+      audio: string;
+    }
+
+    export interface FrameImage {
+      /**
+       * URL path to hosted image that is used for a frame
+       */
+      input_image: string;
+
+      /**
+       * Optional param to specify where to insert the frame. If this is omitted, the
+       * following heuristics are applied:
+       *
+       * - frame_images size is one, frame is first.
+       * - If size is two, frames are first and last.
+       * - If size is larger, frames are first, last and evenly spaced between.
+       */
+      frame?: number | 'first' | 'last';
+    }
+
+    export interface FrameVideo {
+      /**
+       * URL of the video.
+       */
+      video: string;
+    }
+
+    export interface ReferenceVideo {
+      /**
+       * URL of the video.
+       */
+      video: string;
+    }
+
+    /**
+     * Source video to edit.
+     */
+    export interface SourceVideo {
+      /**
+       * URL of the video.
+       */
+      video: string;
+    }
+  }
 }
 
 export declare namespace Videos {

tests/api-resources/videos.test.ts

@@ -24,13 +24,24 @@ describe('resource videos', () => {
       model: 'model',
       fps: 0,
       frame_images: [{ input_image: 'input_image', frame: 0 }],
+      generate_audio: true,
       guidance_scale: 0,
       height: 0,
+      media: {
+        audio_inputs: [{ audio: 'audio' }],
+        frame_images: [{ input_image: 'input_image', frame: 0 }],
+        frame_videos: [{ video: 'video' }],
+        reference_images: ['string'],
+        reference_videos: [{ video: 'video' }],
+        source_video: { video: 'video' },
+      },
       negative_prompt: 'negative_prompt',
       output_format: 'MP4',
       output_quality: 0,
       prompt: 'x',
+      ratio: 'ratio',
       reference_images: ['string'],
+      resolution: 'resolution',
       seconds: 'seconds',
       seed: 0,
       steps: 10,