feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 41
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-599f240cba06bc6d2e7e825a56bd230fa1b632fca62e6aecf3a08a822aa80666.yml
-openapi_spec_hash: 197ebb9692cc426508148cbc5d3f6712
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-9675066b6d9d75638a402b738f23c767ca11bb8cd1f79346785c767fa3d5cd50.yml
+openapi_spec_hash: fda464254d1bce3ac2ff298e55f66e64
 config_hash: cf71a25b7e10f3a39a183524fa0ba05c

src/resources/videos.ts

@@ -138,9 +138,7 @@ export interface VideoCreateParams {
   fps?: number;
 
   /**
-   * Array of images to guide video generation, like keyframes. If size 1, starting
-   * frame, if size 2, starting and ending frame, if more than 2 then frame must be
-   * specified
+   * Array of images to guide video generation, similar to keyframes.
    */
   frame_images?: Array<VideoCreateParams.FrameImage>;
 
@@ -176,9 +174,11 @@ export interface VideoCreateParams {
   prompt?: string;
 
   /**
-   * TODO need to figure this out
+   * Unlike frame_images which constrain specific timeline positions, reference
+   * images guide the general appearance that should appear consistently across the
+   * video.
    */
-  reference_images?: Array<unknown>;
+  reference_images?: Array<string>;
 
   /**
    * Clip duration in seconds.
@@ -204,12 +204,20 @@ export interface VideoCreateParams {
 
 export namespace VideoCreateParams {
   export interface FrameImage {
-    frame: number | 'first' | 'last';
-
     /**
-     * idk
+     * 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';
   }
 }
 

tests/api-resources/videos.test.ts

@@ -23,14 +23,14 @@ describe('resource videos', () => {
     const response = await client.videos.create({
       model: 'model',
       fps: 0,
-      frame_images: [{ frame: 0, input_image: 'input_image' }],
+      frame_images: [{ input_image: 'input_image', frame: 0 }],
       guidance_scale: 0,
       height: 0,
       negative_prompt: 'negative_prompt',
       output_format: 'MP4',
       output_quality: 0,
       prompt: 'x',
-      reference_images: [{}],
+      reference_images: ['string'],
       seconds: 'seconds',
       seed: 0,
       steps: 10,