// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

import { APIResource } from '../core/resource';
import { RequestOptions } from '../internal/request-options';
import { APIPromiseWithAwaitableTask, wrapAsWaitableResource } from '../lib/polling';

/**
 * These endpoints all kick off tasks to create generations.
 */
export class VideoToVideo extends APIResource {
  /**
   * This endpoint will start a new task to generate a video from a video.
   *
   * @example
   * ```ts
   * const videoToVideo = await client.videoToVideo.create({
   *   model: 'gen4_aleph',
   *   promptText: 'x',
   *   videoUri: 'https://example.com/video.mp4',
   * });
   * ```
   */
  create(
    body: VideoToVideoCreateParams,
    options?: RequestOptions,
  ): APIPromiseWithAwaitableTask<VideoToVideoCreateResponse> {
    return wrapAsWaitableResource<VideoToVideoCreateResponse>(this._client)(
      this._client.post('/v1/video_to_video', { body, ...options }),
    );
  }
}

export interface VideoToVideoCreateResponse {
  /**
   * The ID of the task that was created. Use this to retrieve the task later.
   */
  id: string;
}

export type VideoToVideoCreateParams =
  | VideoToVideoCreateParams.Gen4Aleph
  | VideoToVideoCreateParams.Seedance2;

export declare namespace VideoToVideoCreateParams {
  export interface Gen4Aleph {
    model: 'gen4_aleph';

    /**
     * A non-empty string up to 1000 characters (measured in UTF-16 code units). This
     * should describe in detail what should appear in the output.
     */
    promptText: string;

    /**
     * A HTTPS URL.
     */
    videoUri: string;

    /**
     * Settings that affect the behavior of the content moderation system.
     */
    contentModeration?: Gen4Aleph.ContentModeration;

    /**
     * @deprecated Deprecated. This field is ignored. The resolution of the output
     * video is determined by the input video.
     */
    ratio?:
      | '1280:720'
      | '720:1280'
      | '1104:832'
      | '960:960'
      | '832:1104'
      | '1584:672'
      | '848:480'
      | '640:480';

    /**
     * An array of references. Currently up to one reference is supported. See
     * [our docs](/assets/inputs#images) on image inputs for more information.
     */
    references?: Array<Gen4Aleph.Reference>;

    /**
     * If unspecified, a random number is chosen. Varying the seed integer is a way to
     * get different results for the same other request parameters. Using the same seed
     * integer for an identical request will produce similar results.
     */
    seed?: number;
  }

  export namespace Gen4Aleph {
    /**
     * Settings that affect the behavior of the content moderation system.
     */
    export interface ContentModeration {
      /**
       * When set to `low`, the content moderation system will be less strict about
       * preventing generations that include recognizable public figures.
       */
      publicFigureThreshold?: 'auto' | 'low';
    }

    /**
     * Passing an image reference allows the model to emulate the style or content of
     * the reference in the output.
     */
    export interface Reference {
      type: 'image';

      /**
       * A HTTPS URL.
       */
      uri: string;
    }
  }

  export interface Seedance2 {
    model: 'seedance2';

    /**
     * A HTTPS URL.
     */
    promptVideo: string;

    /**
     * Whether to generate audio for the video. Audio inclusion affects pricing.
     */
    audio?: boolean;

    /**
     * The number of seconds of duration for the output video. Must be an integer from
     * 4 to 15.
     */
    duration?: number;

    /**
     * The number of video generations to produce.
     */
    outputCount?: number;

    /**
     * An optional text prompt up to 3500 characters describing what should appear in
     * the output video.
     */
    promptText?: string;

    /**
     * The resolution of the output video.
     */
    ratio?:
      | '992:432'
      | '864:496'
      | '752:560'
      | '640:640'
      | '560:752'
      | '496:864'
      | '1470:630'
      | '1280:720'
      | '1112:834'
      | '960:960'
      | '834:1112'
      | '720:1280';

    /**
     * An optional array of image references (up to 9). See
     * [our docs](/assets/inputs#images) on image inputs for more information.
     */
    references?: string | Array<Seedance2.PromptImage>;

    /**
     * An optional array of up to 3 video references. See
     * [our docs](/assets/inputs#videos) on video inputs for more information.
     */
    referenceVideos?: Array<Seedance2.ReferenceVideo>;
  }

  export namespace Seedance2 {
    export interface PromptImage {
      /**
       * A HTTPS URL.
       */
      uri: string;

      /**
       * The position of the image in the output video. "first" will use the image as the
       * first frame, "last" as the last frame. Omit for a reference image.
       */
      position?: 'first' | 'last';
    }

    /**
     * A video reference allows the model to use the video as additional context for
     * the output.
     */
    export interface ReferenceVideo {
      type: 'video';

      /**
       * A HTTPS URL.
       */
      uri: string;
    }
  }
}

export declare namespace VideoToVideo {
  export {
    type VideoToVideoCreateResponse as VideoToVideoCreateResponse,
    type VideoToVideoCreateParams as VideoToVideoCreateParams,
  };
}