samsar-js 0.48.0

package/dist/index.d.ts

@@ -0,0 +1,977 @@
+type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+type QueryValue = string | number | boolean | null | undefined;
+type QueryParams = Record<string, QueryValue>;
+export interface SamsarClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    fetch?: FetchLike;
+    defaultHeaders?: Record<string, string>;
+}
+export interface SamsarRequestOptions {
+    idempotencyKey?: string;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    query?: QueryParams;
+}
+export interface SamsarResult<T> {
+    data: T;
+    status: number;
+    headers: Record<string, string>;
+    creditsCharged?: number;
+    creditsRemaining?: number;
+    raw: Response;
+}
+export interface FontOptions {
+    key?: string;
+    font_key?: string;
+    language?: string;
+    family?: string;
+}
+export interface CreateVideoFromTextInput {
+    prompt: string;
+    image_model: string;
+    video_model: string;
+    duration: number;
+    tone?: string;
+    aspect_ratio?: string;
+    video_model_sub_type?: string;
+    font_key?: string;
+    fontKey?: string;
+    subtitle_font?: string;
+    subtitleFont?: string;
+    font?: FontOptions;
+    language?: string;
+    languageString?: string | null;
+    enable_subtitles?: boolean;
+    enableSubtitles?: boolean;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    [key: string]: unknown;
+}
+export interface CreateVideoResponse {
+    request_id: string;
+    session_id?: string;
+    sessionID?: string;
+    [key: string]: unknown;
+}
+export interface OutroFocusArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ImageListToVideoItem {
+    image_url?: string;
+    imageUrl?: string;
+    url?: string;
+    src?: string;
+    enhanced_url?: string;
+    enhancedUrl?: string;
+    use_enhanced?: boolean;
+    useEnhanced?: boolean;
+    is_enhanced?: boolean;
+    isEnhanced?: boolean;
+    from_enhanced_list?: boolean;
+    fromEnhancedList?: boolean;
+    skip_enhancement?: boolean;
+    skipEnhancement?: boolean;
+    [key: string]: unknown;
+}
+export interface CreateVideoFromImageListInput {
+    image_urls: Array<string | ImageListToVideoItem>;
+    metadata?: Record<string, unknown>;
+    prompt?: string;
+    language?: string;
+    languageString?: string | null;
+    font_key?: string;
+    fontKey?: string;
+    subtitle_font?: string;
+    subtitleFont?: string;
+    font?: FontOptions;
+    enable_subtitles?: boolean;
+    enableSubtitles?: boolean;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    outro_image_url?: string;
+    add_outro_animation?: boolean;
+    add_outro_focus_area?: boolean;
+    outro_focust_area?: OutroFocusArea | null;
+    [key: string]: unknown;
+}
+export interface TranscriptBuilderPayload {
+    prompt?: string;
+    imageDescriptionList?: unknown[];
+    metadata?: Record<string, unknown>;
+    imageList?: string[];
+    language?: string;
+    languageString?: string | null;
+    [key: string]: unknown;
+}
+export interface CreateVideoFromImageListResponse {
+    request_id?: string;
+    session_id?: string;
+    sessionID?: string;
+    status?: string;
+    case_type?: string;
+    creditsCharged?: number;
+    remainingCredits?: number | null;
+    [key: string]: unknown;
+}
+export interface TranslateVideoInput {
+    videoSessionId?: string;
+    video_session_id?: string;
+    videoSessionID?: string;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    request_id?: string;
+    requestId?: string;
+    language?: string;
+    languageString?: string | null;
+    language_code?: string;
+    languageCode?: string;
+    langauge?: string;
+    langauge_code?: string;
+    langaugeCode?: string;
+    outro_image_url?: string;
+    outroImageUrl?: string;
+    new_outro_image_url?: string;
+    newOutroImageUrl?: string;
+    [key: string]: unknown;
+}
+export interface TranslateVideoResponse {
+    request_id?: string;
+    session_id?: string;
+    sessionID?: string;
+    creditsCharged?: number;
+    remainingCredits?: number | null;
+    [key: string]: unknown;
+}
+export interface UpdateVideoOutroImageInput {
+    videoSessionId?: string;
+    video_session_id?: string;
+    videoSessionID?: string;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    request_id?: string;
+    requestId?: string;
+    outro_image_url?: string;
+    outroImageUrl?: string;
+    new_outro_image_url?: string;
+    newOutroImageUrl?: string;
+    [key: string]: unknown;
+}
+export interface UpdateVideoOutroImageResponse {
+    request_id?: string;
+    session_id?: string;
+    sessionID?: string;
+    creditsCharged?: number;
+    remainingCredits?: number | null;
+    [key: string]: unknown;
+}
+export interface AddVideoOutroImageInput {
+    videoSessionId?: string;
+    video_session_id?: string;
+    videoSessionID?: string;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    request_id?: string;
+    requestId?: string;
+    outro_image_url?: string;
+    outroImageUrl?: string;
+    new_outro_image_url?: string;
+    newOutroImageUrl?: string;
+    add_outro_animation?: boolean;
+    addOutroAnimation?: boolean;
+    add_outro_focus_area?: boolean;
+    addOutroFocusArea?: boolean;
+    outro_focust_area?: OutroFocusArea | null;
+    outro_focus_area?: OutroFocusArea | null;
+    outroFocustArea?: OutroFocusArea | null;
+    outroFocusArea?: OutroFocusArea | null;
+    [key: string]: unknown;
+}
+export interface AddVideoOutroImageResponse {
+    request_id?: string;
+    session_id?: string;
+    sessionID?: string;
+    creditsCharged?: number;
+    remainingCredits?: number | null;
+    [key: string]: unknown;
+}
+export interface JoinVideosInput {
+    session_ids?: string[];
+    sessionIds?: string[];
+    video_session_ids?: string[];
+    videoSessionIds?: string[];
+    blend_scenes?: boolean;
+    blendScenes?: boolean;
+    [key: string]: unknown;
+}
+export interface JoinVideosResponse {
+    request_id?: string;
+    session_id?: string;
+    sessionID?: string;
+    creditsCharged?: number;
+    remainingCredits?: number | null;
+    [key: string]: unknown;
+}
+export interface RemoveSubtitlesInput {
+    videoSessionId?: string;
+    video_session_id?: string;
+    videoSessionID?: string;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    request_id?: string;
+    requestId?: string;
+    [key: string]: unknown;
+}
+export interface RemoveSubtitlesResponse {
+    request_id?: string;
+    session_id?: string;
+    sessionID?: string;
+    creditsCharged?: number;
+    remainingCredits?: number | null;
+    [key: string]: unknown;
+}
+export interface CancelRenderInput {
+    videoSessionId?: string;
+    video_session_id?: string;
+    videoSessionID?: string;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    request_id?: string;
+    requestId?: string;
+    [key: string]: unknown;
+}
+export interface CancelRenderResponse {
+    request_id?: string;
+    session_id?: string;
+    sessionID?: string;
+    status?: string;
+    cancelled?: boolean;
+    message?: string;
+    [key: string]: unknown;
+}
+export interface FetchLatestVideoVersionResponse {
+    session_id: string;
+    result_url?: string;
+    status?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+export interface CompletedVideoSession {
+    session_id: string;
+    langauge: string;
+    language?: string;
+    result_url: string;
+    [key: string]: unknown;
+}
+export type ListCompletedVideoSessionsResponse = CompletedVideoSession[];
+export interface SupportedTextToVideoModelsResponse {
+    IMAGE_MODELS: SupportedTextToVideoModelOption[];
+    VIDEO_MODELS: SupportedTextToVideoModelOption[];
+    [key: string]: unknown;
+}
+export interface SupportedTextToVideoModelOption {
+    label: string;
+    value: string;
+    basePrice: number | null;
+    [key: string]: unknown;
+}
+export interface EnhanceMessageRequest {
+    message: string;
+    metadata?: Record<string, unknown>;
+    language?: string;
+}
+export interface EnhanceMessageResponse {
+    content: string;
+    [key: string]: unknown;
+}
+export interface EmbeddingStructuredField {
+    key: string;
+    type: string;
+    sampleValues?: unknown[];
+    stats?: Record<string, unknown>;
+}
+export interface EmbeddingFieldOptions {
+    searchable?: boolean;
+    filterable?: boolean;
+    retrievable?: boolean;
+}
+export type EmbeddingFieldOptionsInput = Record<string, EmbeddingFieldOptions> | Array<EmbeddingFieldOptions & {
+    key?: string;
+    field?: string;
+    name?: string;
+    path?: string;
+    column_name?: string;
+    columnName?: string;
+}>;
+export interface CreateEmbeddingRequest {
+    records: Array<Record<string, unknown>>;
+    name?: string;
+    embedding_name?: string;
+    template_name?: string;
+    field_options?: EmbeddingFieldOptionsInput;
+    fieldOptions?: EmbeddingFieldOptionsInput;
+    [key: string]: unknown;
+}
+export interface CreateEmbeddingResponse {
+    template_id: string;
+    template_hash?: string;
+    hash_link?: string;
+    record_count?: number;
+    structured_fields?: EmbeddingStructuredField[];
+    unstructured_fields?: string[];
+    [key: string]: unknown;
+}
+export interface UpdateEmbeddingRequest {
+    template_id: string;
+    records: Array<Record<string, unknown>>;
+    field_options?: EmbeddingFieldOptionsInput;
+    fieldOptions?: EmbeddingFieldOptionsInput;
+    [key: string]: unknown;
+}
+export interface UpdateEmbeddingResponse {
+    template_id: string;
+    template_hash?: string;
+    record_count?: number;
+    structured_fields?: EmbeddingStructuredField[];
+    unstructured_fields?: string[];
+    [key: string]: unknown;
+}
+export interface DeleteEmbeddingsRequest {
+    template_id: string;
+    [key: string]: unknown;
+}
+export interface DeleteEmbeddingsResponse {
+    template_id: string;
+    deleted_count?: number;
+    record_count?: number;
+    status?: string;
+    [key: string]: unknown;
+}
+export interface DeleteEmbeddingRequest {
+    template_id: string;
+    source_id?: string;
+    sourceId?: string;
+    source_ids?: string[];
+    sourceIds?: string[];
+    id?: string;
+    ids?: string[];
+    record_id?: string;
+    recordId?: string;
+    record_ids?: string[];
+    recordIds?: string[];
+    [key: string]: unknown;
+}
+export type DeleteEmbeddingResponse = DeleteEmbeddingsResponse;
+export interface SearchAgainstEmbeddingRequest {
+    template_id: string;
+    search_term: string;
+    search_date?: string;
+    searchDate?: string;
+    structured_filters?: Record<string, unknown>;
+    filters?: Record<string, unknown>;
+    search_params?: Record<string, unknown>;
+    searchParams?: Record<string, unknown>;
+    limit?: number;
+    num_candidates?: number;
+    rerank?: boolean;
+    include_raw?: boolean;
+    [key: string]: unknown;
+}
+export interface EmbeddingSearchResult {
+    id: string;
+    score?: number;
+    structured_filters?: Record<string, unknown>;
+    record?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface SearchAgainstEmbeddingResponse {
+    template_id: string;
+    template_name?: string | null;
+    structured_filters?: Record<string, unknown>;
+    results?: EmbeddingSearchResult[];
+    [key: string]: unknown;
+}
+export interface SimilarToEmbeddingRequest {
+    template_id: string;
+    search_term?: string;
+    search_date?: string;
+    searchDate?: string;
+    search_json?: Record<string, unknown>;
+    search_record?: Record<string, unknown>;
+    searchJson?: Record<string, unknown>;
+    searchRecord?: Record<string, unknown>;
+    structured_filters?: Record<string, unknown>;
+    filters?: Record<string, unknown>;
+    search_params?: Record<string, unknown>;
+    searchParams?: Record<string, unknown>;
+    limit?: number;
+    min_results?: number;
+    minResults?: number;
+    num_candidates?: number;
+    [key: string]: unknown;
+}
+export interface SimilarToEmbeddingResponse {
+    template_id: string;
+    structured_filters?: Record<string, unknown>;
+    matches?: Array<{
+        id: string;
+        score?: number;
+    }>;
+    [key: string]: unknown;
+}
+export interface EmbeddingTemplateSummary {
+    template_id: string;
+    name?: string | null;
+    template_hash?: string | null;
+    hash_link?: string | null;
+    record_count?: number;
+    structured_fields?: EmbeddingStructuredField[];
+    unstructured_fields?: string[];
+    embedding_model?: string;
+    created_at?: string | null;
+    updated_at?: string | null;
+    [key: string]: unknown;
+}
+export interface ListEmbeddingTemplatesResponse {
+    templates: EmbeddingTemplateSummary[];
+    pagination?: {
+        total?: number;
+        limit?: number;
+        offset?: number;
+        has_more?: boolean;
+    };
+    [key: string]: unknown;
+}
+export interface EmbeddingStatusResponse {
+    template_id: string;
+    has_embeddings: boolean;
+    record_count?: number;
+    status?: string;
+    [key: string]: unknown;
+}
+export interface RemoveBrandingFromImageRequest {
+    image_url: string;
+}
+export interface RemoveBrandingFromImageResponse {
+    status?: string;
+    message?: string;
+    request_id?: string;
+    session_id?: string;
+    global_status_id?: string;
+    case_type?: string;
+    image_url: string;
+    userId?: string;
+    creditsCharged?: number;
+    remainingCredits?: number;
+    [key: string]: unknown;
+}
+export interface ReplaceBrandingFromImageRequest {
+    image_urls: string[];
+}
+export interface ReplaceBrandingFromImageResponse {
+    status?: string;
+    message?: string;
+    request_id?: string;
+    session_id?: string;
+    global_status_id?: string;
+    case_type?: string;
+    image_urls: string[];
+    userId?: string;
+    creditsCharged?: number;
+    remainingCredits?: number;
+    [key: string]: unknown;
+}
+export interface EnhanceImageRequest {
+    image_url: string;
+    resolution?: '1k' | '2k' | '3k' | '4k';
+    aspect_ratio?: string;
+}
+export interface EnhanceImageResponse {
+    status?: string;
+    message?: string;
+    request_id?: string;
+    session_id?: string;
+    global_status_id?: string;
+    case_type?: string;
+    image_url: string;
+    resolution?: string;
+    aspect_ratio?: string;
+    userId?: string;
+    creditsCharged?: number;
+    remainingCredits?: number;
+    [key: string]: unknown;
+}
+export interface ExtendImageListRequest {
+    image_urls: string[];
+    num_images: number;
+    prompt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ExtendImageListResponse {
+    status?: string;
+    message?: string;
+    request_id?: string;
+    session_id?: string;
+    global_status_id?: string;
+    case_type?: string;
+    image_urls: string[];
+    metadata?: Record<string, unknown>;
+    prompt?: string;
+    num_images?: number;
+    userId?: string;
+    creditsCharged?: number;
+    remainingCredits?: number;
+    [key: string]: unknown;
+}
+export interface RollupBannerOverlay {
+    footer?: string | null;
+    bottom?: string | null;
+    bottom_text?: string | null;
+    text?: string | null;
+    title?: string | null;
+    top_left?: string | null;
+    top_right?: string | null;
+    topLeft?: string | null;
+    topRight?: string | null;
+    image_category?: string | null;
+}
+export interface RollupBannerImageItem {
+    image_url?: string;
+    imageUrl?: string;
+    url?: string;
+    src?: string;
+    overlay?: RollupBannerOverlay | null;
+    image_text?: string | null;
+    image_title?: string | null;
+    title?: string | null;
+    name?: string | null;
+    image_category?: string | null;
+    category?: string | null;
+    image_duration?: number | string | null;
+    duration?: number | string | null;
+    duration_text?: string | null;
+    durationText?: string | null;
+    activity_id?: number | null;
+    enhanced_url?: string | null;
+    enhancedUrl?: string | null;
+    [key: string]: unknown;
+}
+export type RollupBannerImageInput = string | RollupBannerImageItem;
+export interface RollupBannerFontOptions {
+    key?: string;
+    language?: string;
+    family?: string;
+}
+export interface RollupBannerImageTilingPosition {
+    font_key?: string;
+    font_family?: string;
+    font?: RollupBannerFontOptions;
+    top_left?: {
+        margin_min?: number;
+        margin_ratio?: number;
+        diameter_min?: number;
+        diameter_max?: number;
+        diameter_ratio?: number;
+        inner_padding_min?: number;
+        inner_padding_ratio?: number;
+    };
+    top_right?: {
+        margin_min?: number;
+        margin_ratio?: number;
+        max_width_floor?: number;
+        min_width?: number;
+        padding_left?: number;
+        padding_right?: number;
+        padding_top?: number;
+        padding_bottom?: number;
+        overlay_height_min?: number;
+    };
+    bottom?: {
+        inset_min?: number;
+        inset_ratio?: number;
+        offset_min?: number;
+        offset_ratio?: number;
+        container_margin_min?: number;
+        container_margin_ratio?: number;
+        text_inset_min?: number;
+        text_inset_ratio?: number;
+        overlay_height_min?: number;
+    };
+}
+export interface CreateRollupBannerRequest {
+    images?: RollupBannerImageInput[];
+    image_list?: RollupBannerImageInput[];
+    image_urls?: RollupBannerImageInput[];
+    logo_url?: string | null;
+    header_image_url?: string | null;
+    header_text?: string | null;
+    header_cta?: string[] | null;
+    footer_text?: string | null;
+    footer_image_url?: string | null;
+    footer_logo_url?: string | null;
+    image_tiling_position?: RollupBannerImageTilingPosition;
+    max_tiles?: number;
+    columns?: number;
+}
+export interface CreateRollupBannerResponse {
+    status?: string;
+    message?: string;
+    session_id?: string;
+    request_id?: string;
+    result_url?: string | null;
+    thumbnail_url?: string | null;
+    result_urls?: string[];
+    creditsCharged?: number;
+    remainingCredits?: number;
+    [key: string]: unknown;
+}
+export interface EnhanceAndGenerateRollupBannerRequest extends CreateRollupBannerRequest {
+}
+export interface EnhanceAndGenerateRollupBannerResponse extends CreateRollupBannerResponse {
+    case_type?: string;
+    rollup_session_id?: string;
+    rollup_request_id?: string;
+    input_image_urls?: string[];
+}
+export interface GlobalStatusResponse {
+    session_id: string | null;
+    request_id: string | null;
+    status: string;
+    type?: 'image' | 'video' | string;
+    provider?: string | null;
+    result_url?: string | null;
+    thumbnail_url?: string | null;
+    result_urls?: string[];
+    videoLink?: string | null;
+    remoteURL?: string | null;
+    expressGenerationStatus?: unknown;
+    expressGenerationError?: string | null;
+    request_type?: string | null;
+    case_type?: string | null;
+    message?: string | null;
+    [key: string]: unknown;
+}
+export interface CreditTopUpSummary {
+    id?: string;
+    amountPaidCents?: number;
+    currency?: string;
+    paymentType?: string;
+    paymentStatus?: string;
+    billingReason?: string;
+    creditsApplied?: number;
+    paymentDate?: string;
+    stripeInvoiceId?: string;
+    stripeInvoiceNumber?: string;
+    invoicePdfUrl?: string;
+    hostedInvoiceUrl?: string;
+    receiptUrl?: string | null;
+    receiptAvailable?: boolean;
+    productSummary?: string;
+    [key: string]: unknown;
+}
+export interface CreditsBalanceResponse {
+    remainingCredits: number;
+    lastTopUp?: CreditTopUpSummary | null;
+    [key: string]: unknown;
+}
+export interface CreateLoginTokenResponse {
+    loginToken: string;
+    expiresInSeconds?: number;
+    expiresAt?: string;
+    [key: string]: unknown;
+}
+export interface CreditsRechargeResponse {
+    url: string;
+    checkoutSessionId?: string | null;
+    paymentIntentId?: string | null;
+    paymentStatusEndpoint?: string;
+    credits: number;
+    amountUsd: number;
+    amountCents: number;
+    currency: string;
+    [key: string]: unknown;
+}
+export interface EnableAutoRechargeRequest {
+    thresholdCredits?: number;
+    amountUsd?: number;
+    maxMonthlyUsd?: number;
+    requestSetupSession?: boolean;
+    paymentMethodId?: string;
+    enabled?: boolean;
+    [key: string]: unknown;
+}
+export interface AutoRechargeRunSummary {
+    status?: string;
+    reason?: string;
+    invoiceId?: string;
+    hostedInvoiceUrl?: string;
+    creditsToAdd?: number;
+    maxMonthlyUsd?: number;
+    monthlyTotalUsd?: number;
+    [key: string]: unknown;
+}
+export interface EnableAutoRechargeResponse {
+    autoRechargeEnabled?: boolean;
+    autoRechargeAmountUsd?: number;
+    autoRechargeThreshold?: number;
+    autoRechargeMaxMonthlyUsd?: number;
+    stripeCustomerId?: string;
+    setupSessionUrl?: string | null;
+    setupSessionId?: string | null;
+    setupIntentId?: string | null;
+    checkoutSessionId?: string | null;
+    paymentStatusEndpoint?: string;
+    url?: string | null;
+    hasPaymentMethod?: boolean;
+    autoRechargeRun?: AutoRechargeRunSummary | null;
+    [key: string]: unknown;
+}
+export interface PaymentStatusRequest {
+    checkoutSessionId?: string;
+    paymentIntentId?: string;
+    setupIntentId?: string;
+}
+export interface PaymentStatusResponse {
+    status: 'pending' | 'succeeded' | 'failed';
+    mode?: 'payment' | 'setup' | string | null;
+    checkoutSessionId?: string | null;
+    sessionStatus?: string | null;
+    paymentStatus?: string | null;
+    paymentIntentId?: string | null;
+    paymentIntentStatus?: string | null;
+    setupIntentId?: string | null;
+    setupIntentStatus?: string | null;
+    amountCents?: number | null;
+    currency?: string | null;
+    [key: string]: unknown;
+}
+export interface UpdateAutoRechargeThresholdRequest {
+    thresholdCredits: number;
+    [key: string]: unknown;
+}
+export interface UpdateAutoRechargeThresholdResponse {
+    autoRechargeEnabled?: boolean;
+    autoRechargeThreshold?: number;
+    autoRechargeAmountUsd?: number;
+    autoRechargeMaxMonthlyUsd?: number;
+    [key: string]: unknown;
+}
+export interface SamsarErrorInit {
+    status?: number;
+    body?: unknown;
+    headers?: Record<string, string>;
+    url: string;
+    creditsCharged?: number;
+    creditsRemaining?: number;
+}
+export declare class SamsarRequestError extends Error {
+    status?: number;
+    body?: unknown;
+    headers: Record<string, string>;
+    url: string;
+    creditsCharged?: number;
+    creditsRemaining?: number;
+    constructor(message: string, init: SamsarErrorInit);
+}
+export declare class SamsarClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly fetchFn;
+    private readonly defaultHeaders;
+    constructor(options: SamsarClientOptions);
+    /**
+     * Create a new video generation job from text.
+     */
+    createVideoFromText(input: CreateVideoFromTextInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<CreateVideoResponse>>;
+    /**
+     * Create a video from a list of image URLs with optional prompt/metadata via the image_list_to_video route.
+     */
+    createVideoFromImageList(input: CreateVideoFromImageListInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<CreateVideoFromImageListResponse>>;
+    /**
+     * Translate an existing video session into a new language.
+     * Creates a new session_id and queues generation steps for lip sync + transcription + video render.
+     */
+    translateVideo(input: TranslateVideoInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<TranslateVideoResponse>>;
+    /**
+     * Join multiple existing video sessions into a single session by appending their timelines.
+     * Creates a new session_id and queues transcription + frame + video generation.
+     */
+    joinVideos(input: JoinVideosInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<JoinVideosResponse>>;
+    /**
+     * Remove subtitle/transcript text overlays by cloning an existing session and re-running
+     * only frame + video generation on the new session.
+     */
+    removeSubtitles(input: RemoveSubtitlesInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<RemoveSubtitlesResponse>>;
+    /**
+     * Cancel an in-progress render for an existing video session.
+     */
+    cancelRender(input: CancelRenderInput, options?: SamsarRequestOptions): Promise<SamsarResult<CancelRenderResponse>>;
+    /**
+     * Update the outro image for an existing video session by cloning it into a new session and re-running
+     * only the final video render step.
+     */
+    updateVideoOutroImage(input: UpdateVideoOutroImageInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<UpdateVideoOutroImageResponse>>;
+    /**
+     * Add or replace the outro image for an existing video session by cloning it into a new session and
+     * re-running frame/video generation.
+     */
+    addVideoOutroImage(input: AddVideoOutroImageInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<AddVideoOutroImageResponse>>;
+    /**
+     * Fetch the latest available render URL for a given video session id.
+     * Maps to GET /video/fetch_latest_version?session_id={sessionId}.
+     */
+    fetchLatestVideoVersion(sessionId: string, options?: SamsarRequestOptions): Promise<SamsarResult<FetchLatestVideoVersionResponse>>;
+    /**
+     * List completed video sessions for the authenticated API key.
+     * Maps to GET /video/list_completed_video_sessions.
+     */
+    listCompletedVideoSessions(options?: SamsarRequestOptions & {
+        limit?: number;
+    }): Promise<SamsarResult<ListCompletedVideoSessionsResponse>>;
+    /**
+     * Fetch the supported image/video model keys for the text_to_video route.
+     * Maps to GET /video/supported_models.
+     */
+    getSupportedTextToVideoModels(options?: SamsarRequestOptions): Promise<SamsarResult<SupportedTextToVideoModelsResponse>>;
+    /**
+     * Enhance or rewrite text using the chat enhancement endpoint.
+     * Optionally pass `language` (code or name) to enforce the output language.
+     */
+    enhanceMessage(payload: EnhanceMessageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<EnhanceMessageResponse>>;
+    /**
+     * Create a new embedding template and store embeddings for a JSON array.
+     */
+    createEmbedding(payload: CreateEmbeddingRequest, options?: SamsarRequestOptions): Promise<SamsarResult<CreateEmbeddingResponse>>;
+    /**
+     * Update an existing embedding template with additional records.
+     */
+    updateEmbedding(payload: UpdateEmbeddingRequest, options?: SamsarRequestOptions): Promise<SamsarResult<UpdateEmbeddingResponse>>;
+    /**
+     * Delete all embeddings for a template.
+     */
+    deleteEmbeddings(payload: DeleteEmbeddingsRequest, options?: SamsarRequestOptions): Promise<SamsarResult<DeleteEmbeddingsResponse>>;
+    /**
+     * Delete one or more embeddings from a template by record id.
+     */
+    deleteEmbedding(payload: DeleteEmbeddingRequest, options?: SamsarRequestOptions): Promise<SamsarResult<DeleteEmbeddingResponse>>;
+    /**
+     * Search against an embedding template using a natural language query.
+     */
+    searchAgainstEmbedding(payload: SearchAgainstEmbeddingRequest, options?: SamsarRequestOptions): Promise<SamsarResult<SearchAgainstEmbeddingResponse>>;
+    /**
+     * Search against an embedding template using the pluralized endpoint.
+     */
+    searchAgainstEmbeddings(payload: SearchAgainstEmbeddingRequest, options?: SamsarRequestOptions): Promise<SamsarResult<SearchAgainstEmbeddingResponse>>;
+    /**
+     * Find similar records to a query within an embedding template.
+     */
+    similarToEmbedding(payload: SimilarToEmbeddingRequest, options?: SamsarRequestOptions): Promise<SamsarResult<SimilarToEmbeddingResponse>>;
+    /**
+     * List all embedding templates for the API key.
+     */
+    listEmbeddingTemplates(options?: SamsarRequestOptions & {
+        limit?: number;
+        offset?: number;
+    }): Promise<SamsarResult<ListEmbeddingTemplatesResponse>>;
+    /**
+     * Check whether embeddings exist for a template id.
+     */
+    getEmbeddingStatus(templateId: string, options?: SamsarRequestOptions): Promise<SamsarResult<EmbeddingStatusResponse>>;
+    /**
+     * Remove branding/watermark from an image by URL.
+     */
+    removeBrandingFromImage(payload: RemoveBrandingFromImageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<RemoveBrandingFromImageResponse>>;
+    /**
+     * Replace branding/watermark on an image by providing the original and replacement image URLs.
+     */
+    replaceBrandingFromImage(payload: ReplaceBrandingFromImageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<ReplaceBrandingFromImageResponse>>;
+    /**
+     * Enhance an image by upscaling it with the specified resolution.
+     */
+    enhanceImage(payload: EnhanceImageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<EnhanceImageResponse>>;
+    /**
+     * Add or extend a saved image list for the authenticated API key.
+     */
+    extendImageList(payload: ExtendImageListRequest, options?: SamsarRequestOptions): Promise<SamsarResult<ExtendImageListResponse>>;
+    /**
+     * Create a roll-up banner from preprocessed (already enhanced) images.
+     */
+    createRollupBanner(payload: CreateRollupBannerRequest, options?: SamsarRequestOptions): Promise<SamsarResult<CreateRollupBannerResponse>>;
+    /**
+     * Enhance low-resolution images (if needed) and generate a roll-up banner.
+     */
+    enhanceAndGenerateRollupBanner(payload: EnhanceAndGenerateRollupBannerRequest, options?: SamsarRequestOptions): Promise<SamsarResult<EnhanceAndGenerateRollupBannerResponse>>;
+    /**
+     * Fetch the remaining credits and last credit top-up for the API key.
+     */
+    getCreditsBalance(options?: SamsarRequestOptions): Promise<SamsarResult<CreditsBalanceResponse>>;
+    /**
+     * Create a short-lived login token that can be exchanged for an auth token in the client app.
+     */
+    createLoginToken(options?: SamsarRequestOptions): Promise<SamsarResult<CreateLoginTokenResponse>>;
+    /**
+     * Create a Stripe checkout link to recharge a specific number of credits.
+     * Business rule: 1 USD = 100 credits.
+     */
+    createCreditsRecharge(credits: number, options?: SamsarRequestOptions): Promise<SamsarResult<CreditsRechargeResponse>>;
+    /**
+     * Enable or update auto-recharge settings for the API key.
+     * Returns a Stripe setup URL when a payment method is required.
+     */
+    enableAutoRecharge(payload: EnableAutoRechargeRequest, options?: SamsarRequestOptions): Promise<SamsarResult<EnableAutoRechargeResponse>>;
+    /**
+     * Update the auto-recharge threshold for an enabled account.
+     */
+    updateAutoRechargeThreshold(payload: UpdateAutoRechargeThresholdRequest, options?: SamsarRequestOptions): Promise<SamsarResult<UpdateAutoRechargeThresholdResponse>>;
+    /**
+     * Poll for checkout/payment/setup status using IDs returned by credit recharge or auto-recharge setup.
+     */
+    getPaymentStatus(payload: PaymentStatusRequest, options?: SamsarRequestOptions): Promise<SamsarResult<PaymentStatusResponse>>;
+    /**
+     * Retrieve the status of an asynchronous request by request_id.
+     * Defaults to GET /status?request_id={requestId}, but the path can be overridden.
+     * Normalizes the response to expose status/result_url for both image and video flows.
+     */
+    getStatus(requestId: string, options?: SamsarRequestOptions & {
+        path?: string;
+        queryParams?: QueryParams;
+    }): Promise<SamsarResult<GlobalStatusResponse>>;
+    /**
+     * Retrieve the status of an image request (maps to GET /image/status).
+     */
+    getImageStatus(requestId: string, options?: SamsarRequestOptions & {
+        queryParams?: QueryParams;
+    }): Promise<SamsarResult<GlobalStatusResponse>>;
+    private get;
+    private post;
+    private request;
+    private buildHeaders;
+    private buildUrl;
+}
+export default SamsarClient;