openai 6.26.0 → 6.28.0

package/src/resources/videos.ts

@@ -6,7 +6,7 @@ import { ConversationCursorPage, type ConversationCursorPageParams, PagePromise
 import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
-import { maybeMultipartFormRequestOptions } from '../internal/uploads';
+import { maybeMultipartFormRequestOptions, multipartFormRequestOptions } from '../internal/uploads';
 import { path } from '../internal/utils/path';
 
 export class Videos extends APIResource {
@@ -14,7 +14,7 @@ export class Videos extends APIResource {
    * Create a new video generation job from a prompt and optional reference assets.
    */
   create(body: VideoCreateParams, options?: RequestOptions): APIPromise<Video> {
-    return this._client.post('/videos', maybeMultipartFormRequestOptions({ body, ...options }, this._client));
+    return this._client.post('/videos', multipartFormRequestOptions({ body, ...options }, this._client));
   }
 
   /**
@@ -41,6 +41,19 @@ export class Videos extends APIResource {
     return this._client.delete(path`/videos/${videoID}`, options);
   }
 
+  /**
+   * Create a character from an uploaded video.
+   */
+  createCharacter(
+    body: VideoCreateCharacterParams,
+    options?: RequestOptions,
+  ): APIPromise<VideoCreateCharacterResponse> {
+    return this._client.post(
+      '/videos/characters',
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+
   /**
    * Download the generated video bytes or a derived preview asset.
    *
@@ -59,6 +72,34 @@ export class Videos extends APIResource {
     });
   }
 
+  /**
+   * Create a new video generation job by editing a source video or existing
+   * generated video.
+   */
+  edit(body: VideoEditParams, options?: RequestOptions): APIPromise<Video> {
+    return this._client.post(
+      '/videos/edits',
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+
+  /**
+   * Create an extension of a completed video.
+   */
+  extend(body: VideoExtendParams, options?: RequestOptions): APIPromise<Video> {
+    return this._client.post(
+      '/videos/extensions',
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+
+  /**
+   * Fetch a character.
+   */
+  getCharacter(characterID: string, options?: RequestOptions): APIPromise<VideoGetCharacterResponse> {
+    return this._client.get(path`/videos/characters/${characterID}`, options);
+  }
+
   /**
    * Create a remix of a completed video using a refreshed prompt.
    */
@@ -72,6 +113,15 @@ export class Videos extends APIResource {
 
 export type VideosPage = ConversationCursorPage<Video>;
 
+export interface ImageInputReferenceParam {
+  file_id?: string;
+
+  /**
+   * A fully qualified URL or base64-encoded data URL.
+   */
+  image_url?: string;
+}
+
 /**
  * Structured information describing a generated video job.
  */
@@ -190,6 +240,40 @@ export interface VideoDeleteResponse {
   object: 'video.deleted';
 }
 
+export interface VideoCreateCharacterResponse {
+  /**
+   * Identifier for the character creation cameo.
+   */
+  id: string | null;
+
+  /**
+   * Unix timestamp (in seconds) when the character was created.
+   */
+  created_at: number;
+
+  /**
+   * Display name for the character.
+   */
+  name: string | null;
+}
+
+export interface VideoGetCharacterResponse {
+  /**
+   * Identifier for the character creation cameo.
+   */
+  id: string | null;
+
+  /**
+   * Unix timestamp (in seconds) when the character was created.
+   */
+  created_at: number;
+
+  /**
+   * Display name for the character.
+   */
+  name: string | null;
+}
+
 export interface VideoCreateParams {
   /**
    * Text prompt that describes the video to generate.
@@ -197,9 +281,9 @@ export interface VideoCreateParams {
   prompt: string;
 
   /**
-   * Optional multipart reference asset that guides generation.
+   * Optional reference asset upload or reference object that guides generation.
    */
-  input_reference?: Uploadable;
+  input_reference?: Uploadable | ImageInputReferenceParam;
 
   /**
    * The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
@@ -227,6 +311,18 @@ export interface VideoListParams extends ConversationCursorPageParams {
   order?: 'asc' | 'desc';
 }
 
+export interface VideoCreateCharacterParams {
+  /**
+   * Display name for this API character.
+   */
+  name: string;
+
+  /**
+   * Video file used to create a character.
+   */
+  video: Uploadable;
+}
+
 export interface VideoDownloadContentParams {
   /**
    * Which downloadable asset to return. Defaults to the MP4 video.
@@ -234,6 +330,60 @@ export interface VideoDownloadContentParams {
   variant?: 'video' | 'thumbnail' | 'spritesheet';
 }
 
+export interface VideoEditParams {
+  /**
+   * Text prompt that describes how to edit the source video.
+   */
+  prompt: string;
+
+  /**
+   * Reference to the completed video to edit.
+   */
+  video: Uploadable | VideoEditParams.VideoReferenceInputParam;
+}
+
+export namespace VideoEditParams {
+  /**
+   * Reference to the completed video.
+   */
+  export interface VideoReferenceInputParam {
+    /**
+     * The identifier of the completed video.
+     */
+    id: string;
+  }
+}
+
+export interface VideoExtendParams {
+  /**
+   * Updated text prompt that directs the extension generation.
+   */
+  prompt: string;
+
+  /**
+   * Length of the newly generated extension segment in seconds (allowed values: 4,
+   * 8, 12, 16, 20).
+   */
+  seconds: VideoSeconds;
+
+  /**
+   * Reference to the completed video to extend.
+   */
+  video: Uploadable | VideoExtendParams.VideoReferenceInputParam;
+}
+
+export namespace VideoExtendParams {
+  /**
+   * Reference to the completed video.
+   */
+  export interface VideoReferenceInputParam {
+    /**
+     * The identifier of the completed video.
+     */
+    id: string;
+  }
+}
+
 export interface VideoRemixParams {
   /**
    * Updated text prompt that directs the remix generation.
@@ -243,16 +393,22 @@ export interface VideoRemixParams {
 
 export declare namespace Videos {
   export {
+    type ImageInputReferenceParam as ImageInputReferenceParam,
     type Video as Video,
     type VideoCreateError as VideoCreateError,
     type VideoModel as VideoModel,
     type VideoSeconds as VideoSeconds,
     type VideoSize as VideoSize,
     type VideoDeleteResponse as VideoDeleteResponse,
+    type VideoCreateCharacterResponse as VideoCreateCharacterResponse,
+    type VideoGetCharacterResponse as VideoGetCharacterResponse,
     type VideosPage as VideosPage,
     type VideoCreateParams as VideoCreateParams,
     type VideoListParams as VideoListParams,
+    type VideoCreateCharacterParams as VideoCreateCharacterParams,
     type VideoDownloadContentParams as VideoDownloadContentParams,
+    type VideoEditParams as VideoEditParams,
+    type VideoExtendParams as VideoExtendParams,
     type VideoRemixParams as VideoRemixParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '6.26.0'; // x-release-please-version
+export const VERSION = '6.28.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.26.0";
+export declare const VERSION = "6.28.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.26.0";
+export declare const VERSION = "6.28.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '6.26.0'; // x-release-please-version
+exports.VERSION = '6.28.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '6.26.0'; // x-release-please-version
+export const VERSION = '6.28.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map