seacloud-sdk 0.12.19 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -6425,6 +6425,1401 @@ interface KlingV2MasterI2vResource {
6425
6425
  */
6426
6426
  declare function klingV2MasterI2v(params: KlingV2MasterI2vParams): Promise<KlingV2MasterI2vResource[]>;
6427
6427
 
6428
+ /**
6429
+ * ============================================================================
6430
+ * Kling V3 Omni Image 参数接口定义
6431
+ * ============================================================================
6432
+ *
6433
+ * 这是一个多模态图片生成接口,支持文本提示词和参考图片输入。
6434
+ *
6435
+ * 核心功能:
6436
+ * 1. 文生图 (Text-to-Image) - 纯文本描述生成图片
6437
+ * 2. 图生图 (Image-to-Image) - 参考图片风格融合
6438
+ * 3. 多图参考 - 组合多张图片的特征
6439
+ * 4. 灵活分辨率 - 支持 1k/2k/4k 分辨率
6440
+ * 5. 单图/组图模式 - 批量生成或单张精细生成
6441
+ */
6442
+ interface KlingV3OmniImageParams {
6443
+ /**
6444
+ * 图片生成提示词
6445
+ *
6446
+ * 功能:描述期望生成的图片内容
6447
+ *
6448
+ * 使用技巧:
6449
+ * - 详细描述:主体、场景、风格、光线、色彩等
6450
+ * - 质量词:高清、4K、电影级、艺术品质
6451
+ * - 风格词:写实、卡通、水彩、油画、赛博朋克等
6452
+ * - 构图词:特写、全景、鸟瞰、对称构图等
6453
+ *
6454
+ * 示例:
6455
+ * - 基础:'一朵红色的玫瑰'
6456
+ * - 详细:'4K高清,一朵盛开的红色玫瑰,晨露点缀,柔和的光线,浅景深,电影级画质'
6457
+ * - 风格化:'赛博朋克风格的未来城市,霓虹灯璀璨,倒映在湿润的街道上,电影级画质'
6458
+ *
6459
+ * 限制:最多 2500 个字符
6460
+ *
6461
+ * @length 1 - 2500
6462
+ */
6463
+ prompt: string;
6464
+ /**
6465
+ * 参考图片列表
6466
+ *
6467
+ * 功能:提供图片作为生成参考,支持多种使用方式
6468
+ *
6469
+ * 使用方式:
6470
+ * 1. 风格参考 - 提取图片的艺术风格、色调
6471
+ * 2. 场景参考 - 参考图片的构图、布局
6472
+ * 3. 元素参考 - 融合多张图片的元素特征
6473
+ * 4. 主体参考 - 保持主体特征的图片变体
6474
+ *
6475
+ * 示例:
6476
+ * ```typescript
6477
+ * // 单图风格迁移
6478
+ * image_list: [
6479
+ * { image_url: 'style-reference.jpg' }
6480
+ * ]
6481
+ *
6482
+ * // 多图元素融合
6483
+ * image_list: [
6484
+ * { image_url: 'building-style.jpg' }, // 建筑风格
6485
+ * { image_url: 'color-palette.jpg' }, // 色彩参考
6486
+ * { image_url: 'lighting.jpg' } // 光线效果
6487
+ * ]
6488
+ * ```
6489
+ *
6490
+ * 技术规格:
6491
+ * - 格式:jpg / jpeg / png
6492
+ * - 大小:≤ 10MB
6493
+ * - 尺寸:≥ 300px
6494
+ * - 宽高比:1:2.5 ~ 2.5:1
6495
+ * - 输入方式:URL 或 Base64 编码
6496
+ *
6497
+ * 数量限制:
6498
+ * - 参考图片数 + 参考元素数 ≤ 10
6499
+ * - image_url 参数值不得为空
6500
+ */
6501
+ image_list?: Array<{
6502
+ /**
6503
+ * 图片 URL 或 Base64 编码数据
6504
+ * 支持的图片格式:.jpg / .jpeg / .png
6505
+ * 注意:不能为空
6506
+ */
6507
+ image_url?: string;
6508
+ }>;
6509
+ /**
6510
+ * 图片分辨率
6511
+ *
6512
+ * 分辨率说明:
6513
+ * - '1k': 适用于快速预览、测试、社交媒体
6514
+ * - '2k': 适用于一般用途、网页展示、高质量需求
6515
+ * - '4k': 适用于印刷、商业用途、最高质量要求
6516
+ *
6517
+ * 选择建议:
6518
+ * - 测试阶段:1k 快速迭代
6519
+ * - 一般使用:2k 平衡质量和速度
6520
+ * - 最终输出:4k 确保最佳质量
6521
+ * - 社交媒体:1k-2k 已足够
6522
+ * - 印刷用途:4k 推荐
6523
+ *
6524
+ * 注意:分辨率越高,生成时间越长,成本越高
6525
+ */
6526
+ resolution?: '1k' | '2k' | '4k';
6527
+ /**
6528
+ * 生成组图的图片数量
6529
+ *
6530
+ * 功能:批量生成多张相关图片
6531
+ * 适用场景:需要多个变体、选择最佳效果
6532
+ *
6533
+ * 使用说明:
6534
+ * - 仅在 result_type='series' 时有效
6535
+ * - 可以生成同一主题的多个变体
6536
+ * - 每张图片略有差异,提供更多选择
6537
+ *
6538
+ * 示例:
6539
+ * ```typescript
6540
+ * {
6541
+ * prompt: '现代简约风格的客厅设计',
6542
+ * result_type: 'series',
6543
+ * series_amount: 4 // 生成4张不同的客厅设计
6544
+ * }
6545
+ * ```
6546
+ *
6547
+ * 取值范围:[2, 9]
6548
+ * @default 4
6549
+ */
6550
+ series_amount?: number;
6551
+ /**
6552
+ * 生成图片数量
6553
+ *
6554
+ * 功能:单独生成多张独立图片
6555
+ * 适用场景:需要多张独立的图片,而非组图
6556
+ *
6557
+ * 使用说明:
6558
+ * - 仅在 result_type='single' 时有效
6559
+ * - 每张图片完全独立生成
6560
+ * - 适合批量生成不同图片
6561
+ *
6562
+ * 示例:
6563
+ * ```typescript
6564
+ * {
6565
+ * prompt: '各种水果的特写照片',
6566
+ * result_type: 'single',
6567
+ * n: 5 // 生成5张不同的水果照片
6568
+ * }
6569
+ * ```
6570
+ *
6571
+ * 取值范围:[1, 9]
6572
+ * @default 1
6573
+ */
6574
+ n?: number;
6575
+ /**
6576
+ * 生成结果模式 - 单图/组图切换
6577
+ *
6578
+ * 模式说明:
6579
+ * - 'single' (单图模式)
6580
+ * 特点:每张图片独立生成,彼此无关联
6581
+ * 适用:需要多样性、完全不同的图片
6582
+ * 参数:使用 n 控制数量
6583
+ *
6584
+ * - 'series' (组图模式)
6585
+ * 特点:生成相关联的图片组,主题一致但有变化
6586
+ * 适用:需要同一主题的多个版本供选择
6587
+ * 参数:使用 series_amount 控制数量
6588
+ *
6589
+ * 选择建议:
6590
+ * - 需要最佳效果选项:使用 series 模式
6591
+ * - 需要不同主题图片:使用 single 模式
6592
+ * - 快速迭代测试:single + n=1
6593
+ * - 商业项目选图:series + series_amount=4
6594
+ *
6595
+ * 示例:
6596
+ * ```typescript
6597
+ * // 组图模式 - 生成同一场景的4个变体
6598
+ * {
6599
+ * prompt: '日落海滩风景',
6600
+ * result_type: 'series',
6601
+ * series_amount: 4
6602
+ * }
6603
+ *
6604
+ * // 单图模式 - 生成3张完全不同的图片
6605
+ * {
6606
+ * prompt: '自然风景',
6607
+ * result_type: 'single',
6608
+ * n: 3
6609
+ * }
6610
+ * ```
6611
+ */
6612
+ result_type?: 'single' | 'series';
6613
+ /**
6614
+ * 图片宽高比
6615
+ *
6616
+ * 比例说明及适用场景:
6617
+ *
6618
+ * - '16:9' (横屏宽幅)
6619
+ * 适用:横幅海报、网站头图、YouTube缩略图、电影截图
6620
+ * 特点:视野开阔,适合风景、建筑、场景展示
6621
+ *
6622
+ * - '9:16' (竖屏)
6623
+ * 适用:手机壁纸、竖屏海报、Stories、短视频封面
6624
+ * 特点:适合移动端展示,人物全身照
6625
+ *
6626
+ * - '1:1' (方形)
6627
+ * 适用:Instagram、头像、产品图、通用展示
6628
+ * 特点:各平台兼容性好,构图均衡
6629
+ *
6630
+ * - '4:3' (标准横屏)
6631
+ * 适用:传统照片、PPT、演示文稿
6632
+ * 特点:经典比例,适合大多数场景
6633
+ *
6634
+ * - '3:4' (标准竖屏)
6635
+ * 适用:人物肖像、杂志封面
6636
+ * 特点:传统竖版比例
6637
+ *
6638
+ * - '3:2' / '2:3'
6639
+ * 适用:摄影作品、艺术照片
6640
+ * 特点:摄影常用比例
6641
+ *
6642
+ * - '21:9' (超宽屏)
6643
+ * 适用:电影级画面、全景图、宽幅横幅
6644
+ * 特点:电影感强,视觉冲击力大
6645
+ *
6646
+ * - 'auto' / '' (自动)
6647
+ * 特点:参考原图横纵比生成新图时自动选择
6648
+ *
6649
+ * 选择建议:
6650
+ * - 风景照:16:9 或 21:9
6651
+ * - 人物照:3:4 或 9:16
6652
+ * - 产品图:1:1 或 4:3
6653
+ * - 社交媒体:1:1 通用性最好
6654
+ * - 手机壁纸:9:16
6655
+ * - 桌面壁纸:16:9
6656
+ *
6657
+ * 注意:
6658
+ * - 参考原图横纵比生成新图时,当前参数无效
6659
+ * - 不同比例会影响构图和视觉效果
6660
+ */
6661
+ aspect_ratio?: '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9' | 'auto' | '';
6662
+ /**
6663
+ * 外部任务 ID
6664
+ *
6665
+ * 功能:自定义任务标识符,用于任务追踪和管理
6666
+ *
6667
+ * 使用场景:
6668
+ * - 关联业务系统的任务 ID
6669
+ * - 批量任务管理和追踪
6670
+ * - 任务去重判断
6671
+ * - 日志和审计追踪
6672
+ *
6673
+ * 要求:
6674
+ * - 单用户下需保证唯一性
6675
+ * - 建议使用有意义的命名规则
6676
+ *
6677
+ * 示例:
6678
+ * - 'design_project_001_hero_image'
6679
+ * - 'user_12345_avatar_20260211'
6680
+ * - `task_${Date.now()}_${userId}`
6681
+ */
6682
+ external_task_id?: string;
6683
+ }
6684
+ interface KlingV3OmniImageResource {
6685
+ type: string;
6686
+ url: string;
6687
+ size?: number;
6688
+ jobId?: string;
6689
+ [key: string]: any;
6690
+ }
6691
+ /**
6692
+ * ============================================================================
6693
+ * Kling V3 Omni Image - 多模态图片生成
6694
+ * ============================================================================
6695
+ *
6696
+ * 功能概述:
6697
+ * kling_v3_omni_image 是一个强大的多模态图片生成接口,支持文本提示词
6698
+ * 和参考图片输入,能够生成高质量的图片,支持多种分辨率和宽高比。
6699
+ *
6700
+ * 核心能力:
6701
+ * ✓ 文生图 - 纯文本描述生成图片
6702
+ * ✓ 图生图 - 基于参考图片的风格迁移和变体生成
6703
+ * ✓ 多图融合 - 组合多张参考图片的特征
6704
+ * ✓ 灵活配置 - 支持1k/2k/4k分辨率,9种宽高比
6705
+ * ✓ 批量生成 - 单图/组图模式,最多9张
6706
+ *
6707
+ * API 文档:
6708
+ * https://docs.qingque.cn/d/home/eZQCRUy_LWt70n5Wz2sTiLV6J?identityId=2LKTadU2MSa#section=h.hhdxwtuxzvyf
6709
+ *
6710
+ * @example
6711
+ * // 示例1: 基础文生图
6712
+ * ```typescript
6713
+ * import { initSeacloud, klingV3OmniImage } from 'seacloud-sdk';
6714
+ *
6715
+ * initSeacloud('your-api-key');
6716
+ *
6717
+ * const result = await klingV3OmniImage({
6718
+ * prompt: "4K高清,一座现代化的摩天大楼,日落时分,金色光芒",
6719
+ * resolution: "2k",
6720
+ * aspect_ratio: "16:9",
6721
+ * n: 1
6722
+ * });
6723
+ * ```
6724
+ *
6725
+ * @example
6726
+ * // 示例2: 图生图 - 风格迁移
6727
+ * ```typescript
6728
+ * const result = await klingV3OmniImage({
6729
+ * prompt: "保持原图构图,转换为水彩画风格",
6730
+ * image_list: [{
6731
+ * image_url: "https://example.com/original.jpg"
6732
+ * }],
6733
+ * resolution: "2k"
6734
+ * });
6735
+ * ```
6736
+ *
6737
+ * @example
6738
+ * // 示例3: 多图参考融合
6739
+ * ```typescript
6740
+ * const result = await klingV3OmniImage({
6741
+ * prompt: "融合多种风格元素的现代艺术作品",
6742
+ * image_list: [
6743
+ * { image_url: "style1.jpg" }, // 艺术风格参考
6744
+ * { image_url: "color.jpg" }, // 色彩参考
6745
+ * { image_url: "composition.jpg" } // 构图参考
6746
+ * ],
6747
+ * resolution: "4k",
6748
+ * aspect_ratio: "1:1"
6749
+ * });
6750
+ * ```
6751
+ *
6752
+ * @example
6753
+ * // 示例4: 组图模式 - 生成多个变体供选择
6754
+ * ```typescript
6755
+ * const result = await klingV3OmniImage({
6756
+ * prompt: "极简主义风格的logo设计,蓝色系",
6757
+ * result_type: "series",
6758
+ * series_amount: 4, // 生成4个变体
6759
+ * resolution: "2k",
6760
+ * aspect_ratio: "1:1"
6761
+ * });
6762
+ * ```
6763
+ *
6764
+ * @example
6765
+ * // 示例5: 高分辨率竖屏壁纸
6766
+ * ```typescript
6767
+ * const result = await klingV3OmniImage({
6768
+ * prompt: "梦幻星空,紫色调,适合手机壁纸",
6769
+ * resolution: "4k",
6770
+ * aspect_ratio: "9:16",
6771
+ * result_type: "series",
6772
+ * series_amount: 3
6773
+ * });
6774
+ * ```
6775
+ *
6776
+ * @param params 请求参数,详见 KlingV3OmniImageParams 接口定义
6777
+ * @returns 生成的资源列表,包含图片 URL、任务 ID 等信息
6778
+ */
6779
+ declare function klingV3OmniImage(params: KlingV3OmniImageParams): Promise<KlingV3OmniImageResource[]>;
6780
+
6781
+ /**
6782
+ * ============================================================================
6783
+ * Kling V3 Omni Video 参数接口定义
6784
+ * ============================================================================
6785
+ *
6786
+ * 这是一个强大的多模态视频生成接口,支持以下核心功能:
6787
+ *
6788
+ * 1. 文生视频 (Text-to-Video)
6789
+ * - 纯文本提示词生成视频
6790
+ * - 适用场景:创意视频、概念可视化、广告素材
6791
+ *
6792
+ * 2. 图生视频 (Image-to-Video)
6793
+ * - 首帧/尾帧驱动:静态图片动态化
6794
+ * - 多图参考:风格、场景、元素融合
6795
+ * - 适用场景:故事板动画、角色动画
6796
+ *
6797
+ * 3. 视频编辑 (Video Editing)
6798
+ * - 待编辑模式:修改现有视频内容
6799
+ * - 特征参考模式:学习视频运动模式
6800
+ * - 适用场景:风格迁移、二次创作
6801
+ *
6802
+ * 4. 多模态组合
6803
+ * - 文本+图片+视频+元素的任意组合
6804
+ * - 适用场景:复杂创意实现
6805
+ *
6806
+ * 5. 多镜头生成
6807
+ * - 自定义分镜脚本
6808
+ * - 适用场景:短剧、广告片
6809
+ */
6810
+ interface KlingV3OmniVideoParams {
6811
+ /**
6812
+ * 视频生成提示词
6813
+ *
6814
+ * 功能:描述期望生成的视频内容,支持正面和负面描述
6815
+ *
6816
+ * 使用技巧:
6817
+ * - 正面描述:详细描述期望的内容、风格、动作、光线等
6818
+ * - 负面描述:可以在文本中说明不希望出现的元素
6819
+ * - 支持模板化处理,可以组合使用多种描述方式
6820
+ *
6821
+ * 示例:
6822
+ * - 基础:'一只猫在花园里玩耍'
6823
+ * - 详细:'电影级画质,一只橘色的猫在阳光明媚的花园中追逐蝴蝶,镜头缓慢推进,温馨治愈的氛围'
6824
+ * - 风格化:'赛博朋克风格的城市街道,霓虹灯闪烁,雨夜场景,电影级画质'
6825
+ *
6826
+ * 限制:最多 2500 个字符
6827
+ *
6828
+ * @length 1 - 2500
6829
+ */
6830
+ prompt: string;
6831
+ /**
6832
+ * 参考图片列表
6833
+ *
6834
+ * 功能:提供图片作为生成参考,支持三种使用方式
6835
+ *
6836
+ * 方式1:首帧/尾帧驱动
6837
+ * - 使用 type='first_frame' 指定视频的第一帧
6838
+ * - 使用 type='end_frame' 指定视频的最后一帧
6839
+ * - 用于静态图片动态化、故事板动画
6840
+ * - 注意:设置尾帧时必须同时设置首帧
6841
+ *
6842
+ * 示例:
6843
+ * ```typescript
6844
+ * image_list: [
6845
+ * { image_url: 'sunrise.jpg', type: 'first_frame' }, // 日出场景
6846
+ * { image_url: 'sunset.jpg', type: 'end_frame' } // 日落场景
6847
+ * ]
6848
+ * ```
6849
+ *
6850
+ * 方式2:风格/场景/元素参考
6851
+ * - 不指定 type 参数,图片作为风格、场景或元素的参考
6852
+ * - 可以使用多张图片提供不同方面的参考
6853
+ * - 用于融合多种视觉元素
6854
+ *
6855
+ * 示例:
6856
+ * ```typescript
6857
+ * image_list: [
6858
+ * { image_url: 'architecture.jpg' }, // 建筑风格参考
6859
+ * { image_url: 'lighting.jpg' }, // 光线效果参考
6860
+ * { image_url: 'color.jpg' } // 色彩风格参考
6861
+ * ]
6862
+ * ```
6863
+ *
6864
+ * 方式3:混合使用
6865
+ * - 可以同时使用首帧和风格参考
6866
+ *
6867
+ * 技术规格:
6868
+ * - 格式:jpg / jpeg / png
6869
+ * - 大小:≤ 10MB
6870
+ * - 尺寸:≥ 300px
6871
+ * - 宽高比:1:2.5 ~ 2.5:1
6872
+ * - 输入方式:URL 或 Base64 编码
6873
+ *
6874
+ * 数量限制:
6875
+ * - 有参考视频时:图片数 + 元素数 ≤ 4
6876
+ * - 无参考视频时:图片数 + 元素数 ≤ 7
6877
+ * - 图片数 > 2 时:不支持设置尾帧
6878
+ *
6879
+ * 功能互斥:
6880
+ * - 使用首帧/尾帧时,不能使用视频编辑功能
6881
+ */
6882
+ image_list?: Array<{
6883
+ /**
6884
+ * 图片 URL 或 Base64 编码数据
6885
+ * 注意:不能为空
6886
+ */
6887
+ image_url?: string;
6888
+ /**
6889
+ * 图片类型
6890
+ * - 'first_frame': 作为视频的第一帧
6891
+ * - 'end_frame': 作为视频的最后一帧
6892
+ * - 不设置: 作为风格/场景/元素参考
6893
+ */
6894
+ type?: 'first_frame' | 'end_frame';
6895
+ }>;
6896
+ /**
6897
+ * 是否生成多镜头视频
6898
+ *
6899
+ * 功能:启用后可以生成包含多个镜头的视频
6900
+ * 适用场景:短剧制作、广告片、故事性视频
6901
+ *
6902
+ * 示例:
6903
+ * ```typescript
6904
+ * {
6905
+ * multi_shot: true,
6906
+ * shot_type: 'customize',
6907
+ * multi_prompt: [
6908
+ * { prompt: '镜头1:咖啡店外景' },
6909
+ * { prompt: '镜头2:店内氛围' },
6910
+ * { prompt: '镜头3:咖啡制作特写' }
6911
+ * ]
6912
+ * }
6913
+ * ```
6914
+ *
6915
+ * 注意事项:
6916
+ * - multi_shot=true 时,prompt 参数无效
6917
+ * - multi_shot=false 时,shot_type 和 multi_prompt 参数无效
6918
+ */
6919
+ multi_shot?: boolean;
6920
+ /**
6921
+ * 分镜方式
6922
+ *
6923
+ * 当前仅支持:'customize' (自定义分镜)
6924
+ *
6925
+ * 注意:当 multi_shot=true 时,此参数必填
6926
+ */
6927
+ shot_type?: 'customize';
6928
+ /**
6929
+ * 参考视频列表
6930
+ *
6931
+ * 功能:提供视频作为生成参考,支持两种使用方式
6932
+ *
6933
+ * 方式1:待编辑视频 (refer_type='base')
6934
+ * - 对现有视频进行修改、风格转换、场景替换
6935
+ * - 保持原视频的运动节奏,改变视觉内容
6936
+ * - 适用场景:视频二次创作、风格迁移
6937
+ *
6938
+ * 示例:
6939
+ * ```typescript
6940
+ * video_list: [{
6941
+ * video_url: 'original.mp4',
6942
+ * refer_type: 'base',
6943
+ * keep_original_sound: 'yes' // 保留原视频声音
6944
+ * }]
6945
+ * ```
6946
+ * 效果:将现代街道转换为古代街道,保持行人走动节奏
6947
+ *
6948
+ * 方式2:特征参考视频 (refer_type='feature')
6949
+ * - 学习参考视频的运动模式、节奏、动态特征
6950
+ * - 应用到新的场景和内容中
6951
+ * - 适用场景:运动迁移、动态效果复用
6952
+ *
6953
+ * 示例:
6954
+ * ```typescript
6955
+ * video_list: [{
6956
+ * video_url: 'motion-reference.mp4',
6957
+ * refer_type: 'feature',
6958
+ * keep_original_sound: 'no'
6959
+ * }]
6960
+ * ```
6961
+ * 效果:参考海浪的运动节奏生成云朵流动的视频
6962
+ *
6963
+ * 声音处理:
6964
+ * - keep_original_sound='yes': 保留原视频音频
6965
+ * - keep_original_sound='no': 不保留音频(默认)
6966
+ *
6967
+ * 技术规格:
6968
+ * - 格式:mp4 / mov
6969
+ * - 时长:3-10 秒
6970
+ * - 分辨率:宽高 720-2160px
6971
+ * - 帧率:24-60 fps (输出固定为 24fps)
6972
+ * - 大小:≤ 200MB
6973
+ *
6974
+ * 限制:
6975
+ * - 仅支持上传 1 个视频
6976
+ * - 待编辑视频模式时,不能定义首尾帧
6977
+ * - video_url 不能为空
6978
+ */
6979
+ video_list?: Array<{
6980
+ /**
6981
+ * 视频 URL 地址
6982
+ * 支持格式:MP4 / MOV
6983
+ */
6984
+ video_url: string;
6985
+ /**
6986
+ * 参考视频类型
6987
+ * - 'base': 待编辑视频 - 修改该视频内容
6988
+ * - 'feature': 特征参考视频 - 学习该视频的运动特征
6989
+ * @default "base"
6990
+ */
6991
+ refer_type?: 'feature' | 'base';
6992
+ /**
6993
+ * 是否保留视频原声
6994
+ * - 'yes': 保留原音频
6995
+ * - 'no': 不保留音频
6996
+ */
6997
+ keep_original_sound?: 'yes' | 'no';
6998
+ }>;
6999
+ /**
7000
+ * 参考元素列表
7001
+ *
7002
+ * 功能:使用元素库中保存的元素(如角色、物体等)作为参考
7003
+ *
7004
+ * 使用方式:
7005
+ * - 基于元素 ID 配置
7006
+ * - 可以组合多个元素
7007
+ * - 元素需要提前在元素库中创建
7008
+ *
7009
+ * 示例:
7010
+ * ```typescript
7011
+ * element_list: [
7012
+ * { element_id: 123456 }, // 特定角色
7013
+ * { element_id: 789012 } // 特定道具
7014
+ * ]
7015
+ * ```
7016
+ *
7017
+ * 数量限制:
7018
+ * - 有参考视频时:图片数 + 元素数 ≤ 4
7019
+ * - 无参考视频时:图片数 + 元素数 ≤ 7
7020
+ */
7021
+ element_list?: Array<{
7022
+ /**
7023
+ * 元素库中的元素 ID
7024
+ */
7025
+ element_id?: number;
7026
+ }>;
7027
+ /**
7028
+ * 视频生成模式
7029
+ *
7030
+ * 模式说明:
7031
+ * - 'std' (标准模式)
7032
+ * 优点:成本效益高,生成速度快
7033
+ * 适用:一般质量要求的视频、快速迭代测试
7034
+ *
7035
+ * - 'pro' (专业模式)
7036
+ * 优点:质量更高,可生成更长时长,细节更丰富
7037
+ * 适用:高质量需求、商业用途、最终成品
7038
+ *
7039
+ * 选择建议:
7040
+ * - 测试阶段:使用 std 节省成本
7041
+ * - 最终输出:使用 pro 确保质量
7042
+ * - 简单场景:std 已足够
7043
+ * - 复杂场景:建议使用 pro
7044
+ *
7045
+ * @default "pro"
7046
+ */
7047
+ mode?: 'pro' | 'std';
7048
+ /**
7049
+ * 多分镜提示词列表
7050
+ *
7051
+ * 功能:当 multi_shot=true 时,用于定义每个镜头的内容
7052
+ *
7053
+ * 示例:
7054
+ * ```typescript
7055
+ * multi_prompt: [
7056
+ * {
7057
+ * prompt: '镜头1:广角镜头,咖啡店外景,清晨阳光',
7058
+ * duration: 3
7059
+ * },
7060
+ * {
7061
+ * prompt: '镜头2:中景,店内温馨氛围,顾客交谈',
7062
+ * duration: 4
7063
+ * },
7064
+ * {
7065
+ * prompt: '镜头3:特写,咖啡师拉花动作',
7066
+ * duration: 3
7067
+ * }
7068
+ * ]
7069
+ * ```
7070
+ *
7071
+ * 注意:仅在 multi_shot=true 时有效
7072
+ */
7073
+ multi_prompt?: Array<{
7074
+ [key: string]: any;
7075
+ }>;
7076
+ /**
7077
+ * 生成的视频纵横比(宽:高)
7078
+ *
7079
+ * 比例说明及适用场景:
7080
+ *
7081
+ * - '16:9' (横屏)
7082
+ * 适用:YouTube、B站、电影、电视、桌面播放
7083
+ * 特点:最常见的视频比例,视野开阔
7084
+ *
7085
+ * - '9:16' (竖屏)
7086
+ * 适用:抖音、快手、Instagram Stories、TikTok
7087
+ * 特点:移动端全屏显示,沉浸感强
7088
+ *
7089
+ * - '1:1' (方形)
7090
+ * 适用:Instagram 帖子、微信朋友圈、社交媒体
7091
+ * 特点:在各平台显示友好,通用性好
7092
+ *
7093
+ * 选择建议:
7094
+ * - 短视频平台:9:16
7095
+ * - 长视频平台:16:9
7096
+ * - 社交媒体:1:1
7097
+ * - 电影/纪录片:16:9
7098
+ *
7099
+ * 注意:
7100
+ * - 当使用首帧参考时,可以省略此参数(自动从首帧获取比例)
7101
+ * - 使用视频编辑功能时,可以省略此参数(保持原视频比例)
7102
+ */
7103
+ aspect_ratio?: '16:9' | '9:16' | '1:1';
7104
+ /**
7105
+ * 视频时长(秒)
7106
+ *
7107
+ * 可选值:3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
7108
+ *
7109
+ * 时长选择建议:
7110
+ * - 3-5秒:快速展示、产品特写、转场动画
7111
+ * - 5-8秒:常规内容、故事片段、场景展示
7112
+ * - 8-12秒:完整叙事、复杂场景、多个动作
7113
+ * - 12-15秒:深度内容、情节发展、氛围营造
7114
+ *
7115
+ * 注意事项:
7116
+ * - 时长越长,生成时间越久,成本越高
7117
+ * - pro 模式支持更长时长
7118
+ * - 使用视频编辑功能时,可能会保持原视频时长
7119
+ *
7120
+ * @default 5
7121
+ */
7122
+ duration?: 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
7123
+ /**
7124
+ * 外部任务 ID
7125
+ *
7126
+ * 功能:自定义任务标识符,用于任务追踪和管理
7127
+ *
7128
+ * 使用场景:
7129
+ * - 关联业务系统的任务 ID
7130
+ * - 批量任务管理
7131
+ * - 任务去重判断
7132
+ *
7133
+ * 要求:
7134
+ * - 单用户下需保证唯一性
7135
+ * - 建议使用有意义的命名规则
7136
+ *
7137
+ * 示例:
7138
+ * - 'project_001_scene_01'
7139
+ * - 'user_12345_video_20260211'
7140
+ * - `task_${Date.now()}`
7141
+ */
7142
+ external_task_id?: string;
7143
+ }
7144
+ interface KlingV3OmniVideoResource {
7145
+ type: string;
7146
+ url: string;
7147
+ size?: number;
7148
+ jobId?: string;
7149
+ [key: string]: any;
7150
+ }
7151
+ /**
7152
+ * ============================================================================
7153
+ * Kling V3 Omni Video - 多模态视频生成
7154
+ * ============================================================================
7155
+ *
7156
+ * 功能概述:
7157
+ * 这是 Kling AI 的第三代多模态视频生成接口,支持文本、图片、视频和
7158
+ * 自定义元素等多种输入方式的任意组合,能够实现从简单的文生视频到
7159
+ * 复杂的多模态创意视频生成。
7160
+ *
7161
+ * 核心能力:
7162
+ * ✓ 文生视频 - 纯文本描述生成视频
7163
+ * ✓ 图生视频 - 静态图片动态化
7164
+ * ✓ 视频编辑 - 风格迁移、内容修改
7165
+ * ✓ 多模态融合 - 组合多种输入类型
7166
+ * ✓ 多镜头生成 - 自动分镜脚本
7167
+ *
7168
+ * API 文档:
7169
+ * https://docs.qingque.cn/d/home/eZQCedMeoI1MTquS1SFRihz4S?identityId=2Cn18n4EIHT#section=h.eg0di1lnd6n6
7170
+ *
7171
+ * @example
7172
+ * // 示例1: 基础文生视频
7173
+ * ```typescript
7174
+ * import { initSeacloud, klingV3OmniVideo } from 'seacloud-sdk';
7175
+ *
7176
+ * initSeacloud('your-api-key');
7177
+ *
7178
+ * const result = await klingV3OmniVideo({
7179
+ * prompt: "一只可爱的猫咪在花园里追逐蝴蝶",
7180
+ * mode: "pro",
7181
+ * aspect_ratio: "16:9",
7182
+ * duration: 5
7183
+ * });
7184
+ * ```
7185
+ *
7186
+ * @example
7187
+ * // 示例2: 首帧驱动生成
7188
+ * ```typescript
7189
+ * const result = await klingV3OmniVideo({
7190
+ * prompt: "湖面泛起涟漪,云朵缓慢移动",
7191
+ * image_list: [{
7192
+ * image_url: "https://example.com/lake.jpg",
7193
+ * type: "first_frame"
7194
+ * }],
7195
+ * mode: "pro",
7196
+ * duration: 5
7197
+ * });
7198
+ * ```
7199
+ *
7200
+ * @example
7201
+ * // 示例3: 首尾帧驱动
7202
+ * ```typescript
7203
+ * const result = await klingV3OmniVideo({
7204
+ * prompt: "从日出到日落的天空变化",
7205
+ * image_list: [
7206
+ * { image_url: "sunrise.jpg", type: "first_frame" },
7207
+ * { image_url: "sunset.jpg", type: "end_frame" }
7208
+ * ],
7209
+ * mode: "pro",
7210
+ * duration: 8
7211
+ * });
7212
+ * ```
7213
+ *
7214
+ * @example
7215
+ * // 示例4: 视频风格迁移
7216
+ * ```typescript
7217
+ * const result = await klingV3OmniVideo({
7218
+ * prompt: "将现代街道转换为赛博朋克风格",
7219
+ * video_list: [{
7220
+ * video_url: "original-street.mp4",
7221
+ * refer_type: "base",
7222
+ * keep_original_sound: "yes"
7223
+ * }],
7224
+ * mode: "pro"
7225
+ * });
7226
+ * ```
7227
+ *
7228
+ * @example
7229
+ * // 示例5: 多模态组合
7230
+ * ```typescript
7231
+ * const result = await klingV3OmniVideo({
7232
+ * prompt: "结合参考图片风格和视频运动的魔法场景",
7233
+ * image_list: [
7234
+ * { image_url: "magic-style.jpg" },
7235
+ * { image_url: "castle.jpg" }
7236
+ * ],
7237
+ * video_list: [{
7238
+ * video_url: "motion-reference.mp4",
7239
+ * refer_type: "feature"
7240
+ * }],
7241
+ * mode: "pro",
7242
+ * duration: 5
7243
+ * });
7244
+ * ```
7245
+ *
7246
+ * @param params 请求参数,详见 KlingV3OmniVideoParams 接口定义
7247
+ * @returns 生成的资源列表,包含视频 URL、任务 ID 等信息
7248
+ */
7249
+ declare function klingV3OmniVideo(params: KlingV3OmniVideoParams): Promise<KlingV3OmniVideoResource[]>;
7250
+
7251
+ /**
7252
+ * Kling V3 文本生成视频 API(带音频支持)
7253
+ *
7254
+ * 支持通过文本描述生成视频,可添加音色和音频效果
7255
+ */
7256
+ /**
7257
+ * 音色配置
7258
+ */
7259
+ interface VoiceConfig$1 {
7260
+ /** 音色 ID,通过音色定制接口返回,或使用系统预置音色 */
7261
+ voice_id: string;
7262
+ }
7263
+ /**
7264
+ * 分镜配置
7265
+ */
7266
+ interface ShotConfig$1 {
7267
+ /** 分镜序号 */
7268
+ index: number;
7269
+ /** 分镜提示词,最大长度 512 */
7270
+ prompt: string;
7271
+ /** 分镜时长(秒),不小于 1,不大于总时长 */
7272
+ duration: number;
7273
+ }
7274
+ /**
7275
+ * Kling V3 文本生成视频参数
7276
+ */
7277
+ interface KlingV3TextToVideoParams {
7278
+ /**
7279
+ * @property {string} prompt - 文本提示词(条件必填)
7280
+ *
7281
+ * 功能说明:
7282
+ * - 描述期望生成的视频内容、场景、动作、氛围
7283
+ * - 可包含正向描述和负向描述
7284
+ *
7285
+ * 音色支持:
7286
+ * - 使用 <<<voice_1>>> 来指定音色,序号对应 voice_list 数组顺序
7287
+ * - 最多引用 2 个音色
7288
+ * - 指定音色时,sound 参数必须为 "on"
7289
+ * - 语法结构越简单越好,如:男人<<<voice_1>>>说:"你好"
7290
+ *
7291
+ * 使用限制:
7292
+ * - 不能超过 2500 个字符
7293
+ * - 当 multi_shot 为 false 或 shot_type 为 "intelligence" 时,必填
7294
+ * - 当 multi_shot 为 true 时,此参数无效
7295
+ *
7296
+ * @example 基础文生视频
7297
+ * prompt: "科幻城市的霓虹灯街道,赛博朋克风格,雨夜场景"
7298
+ *
7299
+ * @example 带音色的视频
7300
+ * prompt: "一个女孩<<<voice_1>>>说:'你好,欢迎来到未来世界'",
7301
+ * voice_list: [{ voice_id: "voice_123" }],
7302
+ * sound: "on"
7303
+ */
7304
+ prompt?: string;
7305
+ /**
7306
+ * @property {boolean} [multi_shot] - 是否生成多镜头视频
7307
+ *
7308
+ * - true: 生成多镜头视频,shot_type 和 multi_prompt 参数无效
7309
+ * - false: 生成单镜头视频,prompt 参数无效
7310
+ *
7311
+ * @example
7312
+ * multi_shot: false
7313
+ */
7314
+ multi_shot?: boolean;
7315
+ /**
7316
+ * @property {'customize'} [shot_type] - 分镜方式
7317
+ *
7318
+ * - 'customize': 自定义分镜
7319
+ * - 当 multi_shot 为 true 时,此参数必填
7320
+ *
7321
+ * @example
7322
+ * shot_type: "customize"
7323
+ */
7324
+ shot_type?: 'customize';
7325
+ /**
7326
+ * @property {'on' | 'off'} [sound] - 音频开关
7327
+ *
7328
+ * - 'on': 开启音频
7329
+ * - 'off': 关闭音频
7330
+ *
7331
+ * 注意:当使用 voice_list 时,必须设置为 'on'
7332
+ *
7333
+ * @example
7334
+ * sound: "on"
7335
+ */
7336
+ sound?: 'on' | 'off';
7337
+ /**
7338
+ * @property {'pro' | 'std'} [mode] - 生成模式
7339
+ *
7340
+ * - 'std': 标准模式,生成 720P 视频,性价比高,速度快
7341
+ * - 'pro': 专家模式,生成 1080P 视频,视频质量更佳
7342
+ *
7343
+ * @example 快速预览
7344
+ * mode: "std"
7345
+ *
7346
+ * @example 最终输出
7347
+ * mode: "pro"
7348
+ */
7349
+ mode?: 'pro' | 'std';
7350
+ /**
7351
+ * @property {'16:9' | '9:16' | '1:1'} [aspect_ratio] - 视频宽高比
7352
+ *
7353
+ * - '16:9': 横屏视频,适合 YouTube、B站、电视
7354
+ * - '9:16': 竖屏视频,适合抖音、快手、Stories
7355
+ * - '1:1': 方形视频,适合 Instagram、朋友圈
7356
+ *
7357
+ * @example 横屏视频
7358
+ * aspect_ratio: "16:9"
7359
+ *
7360
+ * @example 竖屏短视频
7361
+ * aspect_ratio: "9:16"
7362
+ */
7363
+ aspect_ratio?: '16:9' | '9:16' | '1:1';
7364
+ /**
7365
+ * @property {number} [duration] - 视频时长(秒)
7366
+ *
7367
+ * 支持范围:3-15 秒
7368
+ *
7369
+ * 建议:
7370
+ * - 3-5 秒: 快速展示、转场、特写
7371
+ * - 5-8 秒: 常规内容、故事片段
7372
+ * - 8-12 秒: 完整叙事、复杂场景
7373
+ * - 12-15 秒: 深度内容、氛围营造
7374
+ *
7375
+ * @example
7376
+ * duration: 5
7377
+ */
7378
+ duration?: 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
7379
+ /**
7380
+ * @property {ShotConfig[]} [multi_prompt] - 各分镜提示词配置
7381
+ *
7382
+ * 用于自定义多镜头视频的各个分镜
7383
+ *
7384
+ * 限制条件:
7385
+ * - 最多支持 6 个分镜,最少 1 个分镜
7386
+ * - 每个分镜的 prompt 最大长度 512
7387
+ * - 每个分镜的 duration 不小于 1,不大于总时长
7388
+ * - 所有分镜的 duration 之和必须等于总时长
7389
+ *
7390
+ * @example
7391
+ * multi_prompt: [
7392
+ * { index: 0, prompt: "开场镜头", duration: 3 },
7393
+ * { index: 1, prompt: "主要内容", duration: 5 },
7394
+ * { index: 2, prompt: "结尾镜头", duration: 2 }
7395
+ * ]
7396
+ */
7397
+ multi_prompt?: ShotConfig$1[];
7398
+ /**
7399
+ * @property {string} [negative_prompt] - 负向文本提示词
7400
+ *
7401
+ * 用于描述不希望出现在视频中的内容
7402
+ *
7403
+ * 建议:
7404
+ * - 直接在正向提示词中使用否定句
7405
+ * - 不能超过 2500 个字符
7406
+ *
7407
+ * @example
7408
+ * negative_prompt: "模糊、低质量、变形"
7409
+ */
7410
+ negative_prompt?: string;
7411
+ /**
7412
+ * @property {VoiceConfig[]} [voice_list] - 音色列表
7413
+ *
7414
+ * 功能说明:
7415
+ * - 指定生成视频时使用的音色
7416
+ * - 最多引用 2 个音色
7417
+ * - voice_id 通过音色定制接口返回,或使用系统预置音色
7418
+ *
7419
+ * 计费说明:
7420
+ * - 当 voice_list 不为空且 prompt 中引用音色时,按"有指定音色"计费
7421
+ *
7422
+ * 注意:
7423
+ * - 使用音色时,sound 参数必须为 "on"
7424
+ * - prompt 中使用 <<<voice_1>>> 等标记引用音色
7425
+ *
7426
+ * @example
7427
+ * voice_list: [
7428
+ * { voice_id: "voice_female_01" },
7429
+ * { voice_id: "voice_male_01" }
7430
+ * ],
7431
+ * sound: "on"
7432
+ */
7433
+ voice_list?: VoiceConfig$1[];
7434
+ /**
7435
+ * @property {number} [cfg_scale] - 生成视频的自由度
7436
+ *
7437
+ * 取值范围:[0, 1]
7438
+ *
7439
+ * 说明:
7440
+ * - 值越大,模型自由度越小,与 prompt 相关性越强
7441
+ * - 值越小,模型自由度越大,创意性越强
7442
+ *
7443
+ * @example
7444
+ * cfg_scale: 0.7
7445
+ */
7446
+ cfg_scale?: number;
7447
+ /**
7448
+ * @property {string} [external_task_id] - 外部任务 ID
7449
+ *
7450
+ * 用于关联外部系统的任务标识
7451
+ *
7452
+ * @example
7453
+ * external_task_id: "task_123456"
7454
+ */
7455
+ external_task_id?: string;
7456
+ }
7457
+ /**
7458
+ * Kling V3 视频资源结果
7459
+ */
7460
+ interface KlingV3TextToVideoResource {
7461
+ /** 生成的视频 URL */
7462
+ url: string;
7463
+ /** 视频时长(秒) */
7464
+ duration: number;
7465
+ /** 视频宽度(像素) */
7466
+ width?: number;
7467
+ /** 视频高度(像素) */
7468
+ height?: number;
7469
+ /** 视频大小(字节) */
7470
+ size?: number;
7471
+ /** 任务 ID */
7472
+ task_id?: string;
7473
+ }
7474
+ /**
7475
+ * Kling V3 文本生成视频
7476
+ *
7477
+ * 支持通过文本描述生成视频,可添加音色和音频效果
7478
+ *
7479
+ * @param {KlingV3TextToVideoParams} params - 生成参数
7480
+ * @returns {Promise<KlingV3TextToVideoResource[]>} 生成的视频资源数组
7481
+ *
7482
+ * @example 基础文生视频
7483
+ * const videos = await klingV3TextToVideo({
7484
+ * prompt: "科幻城市的霓虹灯街道,赛博朋克风格,雨夜场景",
7485
+ * mode: "pro",
7486
+ * aspect_ratio: "16:9",
7487
+ * duration: 5
7488
+ * });
7489
+ *
7490
+ * @example 带音色的视频
7491
+ * const videos = await klingV3TextToVideo({
7492
+ * prompt: "一个女孩<<<voice_1>>>说:'欢迎来到未来'",
7493
+ * voice_list: [{ voice_id: "voice_female_01" }],
7494
+ * sound: "on",
7495
+ * mode: "pro",
7496
+ * duration: 5
7497
+ * });
7498
+ *
7499
+ * @example 多镜头视频
7500
+ * const videos = await klingV3TextToVideo({
7501
+ * multi_shot: true,
7502
+ * shot_type: "customize",
7503
+ * multi_prompt: [
7504
+ * { index: 0, prompt: "开场:城市全景", duration: 3 },
7505
+ * { index: 1, prompt: "主要内容:街道特写", duration: 5 },
7506
+ * { index: 2, prompt: "结尾:远景镜头", duration: 2 }
7507
+ * ],
7508
+ * mode: "pro",
7509
+ * aspect_ratio: "16:9",
7510
+ * duration: 10
7511
+ * });
7512
+ */
7513
+ declare function klingV3TextToVideo(params: KlingV3TextToVideoParams): Promise<KlingV3TextToVideoResource[]>;
7514
+
7515
+ /**
7516
+ * Kling V3 图生成视频 API(带音频支持)
7517
+ *
7518
+ * 支持通过图片生成视频,可添加音色和音频效果
7519
+ * 支持首帧参考和首尾帧参考
7520
+ */
7521
+ /**
7522
+ * 音色配置
7523
+ */
7524
+ interface VoiceConfig {
7525
+ /** 音色 ID,通过音色定制接口返回,或使用系统预置音色 */
7526
+ voice_id: string;
7527
+ }
7528
+ /**
7529
+ * 分镜配置
7530
+ */
7531
+ interface ShotConfig {
7532
+ /** 分镜序号 */
7533
+ index: number;
7534
+ /** 分镜提示词,最大长度 512 */
7535
+ prompt: string;
7536
+ /** 分镜时长(秒),不小于 1,不大于总时长 */
7537
+ duration: number;
7538
+ }
7539
+ /**
7540
+ * Kling V3 图生成视频参数
7541
+ */
7542
+ interface KlingV3ImageToVideoParams {
7543
+ /**
7544
+ * @property {string} [prompt] - 文本提示词(条件必填)
7545
+ *
7546
+ * 功能说明:
7547
+ * - 描述期望生成的视频内容、动作、变化
7548
+ * - 可包含正向描述和负向描述
7549
+ *
7550
+ * 音色支持:
7551
+ * - 使用 <<<voice_1>>> 来指定音色,序号对应 voice_list 数组顺序
7552
+ * - 最多引用 2 个音色
7553
+ * - 指定音色时,sound 参数必须为 "on"
7554
+ * - 语法结构越简单越好,如:男人<<<voice_1>>>说:"你好"
7555
+ *
7556
+ * 使用限制:
7557
+ * - 不能超过 2500 个字符
7558
+ * - 当 multi_shot 为 false 时,此参数不能为空
7559
+ * - 当 multi_shot 为 true 时,此参数无效
7560
+ *
7561
+ * @example 基础图生视频
7562
+ * prompt: "微风轻拂,树叶轻轻摇曳,水面泛起涟漪"
7563
+ *
7564
+ * @example 带音色的视频
7565
+ * prompt: "画面中的人物<<<voice_1>>>说:'这是一个美好的早晨'",
7566
+ * voice_list: [{ voice_id: "voice_123" }],
7567
+ * sound: "on"
7568
+ */
7569
+ prompt?: string;
7570
+ /**
7571
+ * @property {string} [image] - 首帧图片 URL(二选一必填)
7572
+ *
7573
+ * 功能说明:
7574
+ * - 作为视频的第一帧(开始画面)
7575
+ * - 视频从该图片开始动态化
7576
+ *
7577
+ * 使用场景:
7578
+ * - 图片动态化(单独使用)
7579
+ * - 首尾帧过渡(与 image_tail 配合使用)
7580
+ *
7581
+ * 限制条件:
7582
+ * - image 和 image_tail 至少提供一个
7583
+ * - 两者都提供时,生成首尾帧过渡视频
7584
+ *
7585
+ * @example 首帧参考
7586
+ * image: "https://example.com/start.jpg"
7587
+ *
7588
+ * @example 首尾帧参考
7589
+ * image: "https://example.com/day.jpg",
7590
+ * image_tail: "https://example.com/night.jpg"
7591
+ */
7592
+ image?: string;
7593
+ /**
7594
+ * @property {string} [image_tail] - 尾帧图片 URL(二选一必填)
7595
+ *
7596
+ * 功能说明:
7597
+ * - 作为视频的最后一帧(结束画面)
7598
+ * - 视频向该图片过渡
7599
+ *
7600
+ * 使用场景:
7601
+ * - 首尾帧过渡(必须与 image 配合使用)
7602
+ *
7603
+ * 限制条件:
7604
+ * - image 和 image_tail 至少提供一个
7605
+ * - 使用 image_tail 时,image 必填
7606
+ *
7607
+ * 建议:
7608
+ * - 时长建议 ≥ 8 秒,给过渡留足空间
7609
+ * - 两张图片的构图应有关联性
7610
+ *
7611
+ * @example 时间变化(白天→夜晚)
7612
+ * image: "https://example.com/day.jpg",
7613
+ * image_tail: "https://example.com/night.jpg",
7614
+ * prompt: "从白天平滑过渡到夜晚,天色逐渐变暗",
7615
+ * duration: 8
7616
+ */
7617
+ image_tail?: string;
7618
+ /**
7619
+ * @property {VoiceConfig[]} [voice_list] - 音色列表
7620
+ *
7621
+ * 功能说明:
7622
+ * - 指定生成视频时使用的音色
7623
+ * - 最多引用 2 个音色
7624
+ * - voice_id 通过音色定制接口返回,或使用系统预置音色
7625
+ *
7626
+ * 计费说明:
7627
+ * - 当 voice_list 不为空且 prompt 中引用音色时,按"有指定音色"计费
7628
+ *
7629
+ * 注意:
7630
+ * - 使用音色时,sound 参数必须为 "on"
7631
+ * - prompt 中使用 <<<voice_1>>> 等标记引用音色
7632
+ *
7633
+ * @example
7634
+ * voice_list: [
7635
+ * { voice_id: "voice_female_01" }
7636
+ * ],
7637
+ * sound: "on"
7638
+ */
7639
+ voice_list?: VoiceConfig[];
7640
+ /**
7641
+ * @property {boolean} [multi_shot] - 是否生成多镜头视频
7642
+ *
7643
+ * - true: 生成多镜头视频,shot_type 和 multi_prompt 参数无效
7644
+ * - false: 生成单镜头视频,prompt 参数无效
7645
+ *
7646
+ * @example
7647
+ * multi_shot: false
7648
+ */
7649
+ multi_shot?: boolean;
7650
+ /**
7651
+ * @property {string} [negative_prompt] - 负向文本提示词
7652
+ *
7653
+ * 用于描述不希望出现在视频中的内容
7654
+ *
7655
+ * 建议:
7656
+ * - 直接在正向提示词中使用否定句
7657
+ * - 不能超过 2500 个字符
7658
+ *
7659
+ * @example
7660
+ * negative_prompt: "抖动、模糊、变形"
7661
+ */
7662
+ negative_prompt?: string;
7663
+ /**
7664
+ * @property {'customize'} [shot_type] - 分镜方式
7665
+ *
7666
+ * - 'customize': 自定义分镜
7667
+ * - 当 multi_shot 为 true 时,此参数必填
7668
+ *
7669
+ * @example
7670
+ * shot_type: "customize"
7671
+ */
7672
+ shot_type?: 'customize';
7673
+ /**
7674
+ * @property {'on' | 'off'} [sound] - 音频开关
7675
+ *
7676
+ * - 'on': 开启音频
7677
+ * - 'off': 关闭音频
7678
+ *
7679
+ * 注意:当使用 voice_list 时,必须设置为 'on'
7680
+ *
7681
+ * @example
7682
+ * sound: "on"
7683
+ */
7684
+ sound?: 'on' | 'off';
7685
+ /**
7686
+ * @property {'pro' | 'std'} [mode] - 生成模式
7687
+ *
7688
+ * - 'std': 标准模式,生成 720P 视频,性价比高,速度快
7689
+ * - 'pro': 专家模式,生成 1080P 视频,视频质量更佳
7690
+ *
7691
+ * @example 快速预览
7692
+ * mode: "std"
7693
+ *
7694
+ * @example 最终输出
7695
+ * mode: "pro"
7696
+ */
7697
+ mode?: 'pro' | 'std';
7698
+ /**
7699
+ * @property {'16:9' | '9:16' | '1:1'} [aspect_ratio] - 视频宽高比
7700
+ *
7701
+ * - '16:9': 横屏视频,适合 YouTube、B站、电视
7702
+ * - '9:16': 竖屏视频,适合抖音、快手、Stories
7703
+ * - '1:1': 方形视频,适合 Instagram、朋友圈
7704
+ *
7705
+ * @example 横屏视频
7706
+ * aspect_ratio: "16:9"
7707
+ *
7708
+ * @example 竖屏短视频
7709
+ * aspect_ratio: "9:16"
7710
+ */
7711
+ aspect_ratio?: '16:9' | '9:16' | '1:1';
7712
+ /**
7713
+ * @property {number} [duration] - 视频时长(秒)
7714
+ *
7715
+ * 支持范围:3-15 秒
7716
+ *
7717
+ * 建议:
7718
+ * - 3-5 秒: 快速展示、简单动作
7719
+ * - 5-8 秒: 常规动态化
7720
+ * - 8-12 秒: 首尾帧过渡(推荐)
7721
+ * - 12-15 秒: 复杂过渡、长时间变化
7722
+ *
7723
+ * @example
7724
+ * duration: 8
7725
+ */
7726
+ duration?: 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
7727
+ /**
7728
+ * @property {ShotConfig[]} [multi_prompt] - 各分镜提示词配置
7729
+ *
7730
+ * 用于自定义多镜头视频的各个分镜
7731
+ *
7732
+ * 限制条件:
7733
+ * - 最多支持 6 个分镜,最少 1 个分镜
7734
+ * - 每个分镜的 prompt 最大长度 512
7735
+ * - 每个分镜的 duration 不小于 1,不大于总时长
7736
+ * - 所有分镜的 duration 之和必须等于总时长
7737
+ *
7738
+ * @example
7739
+ * multi_prompt: [
7740
+ * { index: 0, prompt: "图片逐渐放大", duration: 3 },
7741
+ * { index: 1, prompt: "元素开始移动", duration: 5 }
7742
+ * ]
7743
+ */
7744
+ multi_prompt?: ShotConfig[];
7745
+ /**
7746
+ * @property {number} [cfg_scale] - 生成视频的自由度
7747
+ *
7748
+ * 取值范围:[0, 1]
7749
+ *
7750
+ * 说明:
7751
+ * - 值越大,模型自由度越小,与 prompt 相关性越强
7752
+ * - 值越小,模型自由度越大,创意性越强
7753
+ *
7754
+ * @example
7755
+ * cfg_scale: 0.7
7756
+ */
7757
+ cfg_scale?: number;
7758
+ /**
7759
+ * @property {string} [external_task_id] - 外部任务 ID
7760
+ *
7761
+ * 用于关联外部系统的任务标识
7762
+ *
7763
+ * @example
7764
+ * external_task_id: "task_123456"
7765
+ */
7766
+ external_task_id?: string;
7767
+ }
7768
+ /**
7769
+ * Kling V3 视频资源结果
7770
+ */
7771
+ interface KlingV3ImageToVideoResource {
7772
+ /** 生成的视频 URL */
7773
+ url: string;
7774
+ /** 视频时长(秒) */
7775
+ duration: number;
7776
+ /** 视频宽度(像素) */
7777
+ width?: number;
7778
+ /** 视频高度(像素) */
7779
+ height?: number;
7780
+ /** 视频大小(字节) */
7781
+ size?: number;
7782
+ /** 任务 ID */
7783
+ task_id?: string;
7784
+ }
7785
+ /**
7786
+ * Kling V3 图生成视频
7787
+ *
7788
+ * 支持通过图片生成视频,可添加音色和音频效果
7789
+ *
7790
+ * @param {KlingV3ImageToVideoParams} params - 生成参数
7791
+ * @returns {Promise<KlingV3ImageToVideoResource[]>} 生成的视频资源数组
7792
+ *
7793
+ * @example 基础图生视频(首帧参考)
7794
+ * const videos = await klingV3ImageToVideo({
7795
+ * image: "https://example.com/image.jpg",
7796
+ * prompt: "微风轻拂,树叶轻轻摇曳,花瓣飘落",
7797
+ * mode: "pro",
7798
+ * duration: 5
7799
+ * });
7800
+ *
7801
+ * @example 首尾帧过渡(时间变化)
7802
+ * const videos = await klingV3ImageToVideo({
7803
+ * image: "https://example.com/day.jpg",
7804
+ * image_tail: "https://example.com/night.jpg",
7805
+ * prompt: "从白天平滑过渡到夜晚,天色逐渐变暗,灯光逐渐亮起",
7806
+ * mode: "pro",
7807
+ * duration: 8,
7808
+ * aspect_ratio: "16:9"
7809
+ * });
7810
+ *
7811
+ * @example 带音色的图生视频
7812
+ * const videos = await klingV3ImageToVideo({
7813
+ * image: "https://example.com/character.jpg",
7814
+ * prompt: "画面中的人物<<<voice_1>>>说:'欢迎来到这个世界'",
7815
+ * voice_list: [{ voice_id: "voice_female_01" }],
7816
+ * sound: "on",
7817
+ * mode: "pro",
7818
+ * duration: 5
7819
+ * });
7820
+ */
7821
+ declare function klingV3ImageToVideo(params: KlingV3ImageToVideoParams): Promise<KlingV3ImageToVideoResource[]>;
7822
+
6428
7823
  /**
6429
7824
  * 参数示例:
6430
7825
  * ```typescript
@@ -15276,4 +16671,4 @@ declare function validateResourceUrl(resource: Resource, resourceType?: string):
15276
16671
  */
15277
16672
  declare function validateResources(resources: Resource[], resourceType?: string): void;
15278
16673
 
15279
- export { type AgentArtifact, type AgentChatCompletionChoice, type AgentChatCompletionChunk, type AgentChatCompletionChunkChoice, type AgentChatCompletionDelta, type AgentChatCompletionResponse, type AgentChatCompletionsParams, type AgentContentFilterResult, type AgentMessage, type AgentMessageContent, type AgentMessageContentType, type AgentMessageRole, type AgentResponseMessage, type AgentTool, type AgentToolCall, type AgentToolFunction, type AgentUsage, type AlibabaAnimateAnyoneDetectParams, type AlibabaAnimateAnyoneDetectResource, type AlibabaAnimateAnyoneTemplateParams, type AlibabaAnimateAnyoneTemplateResource, type AlibabaAnimateAnyoneVideoParams, type AlibabaAnimateAnyoneVideoResource, type AlibabaQianwenImageParams, type AlibabaQianwenImageResource, type AlibabaWan22T2iFlashParams, type AlibabaWan22T2iFlashResource, type AlibabaWan22T2iPlusParams, type AlibabaWan22T2iPlusResource, type AlibabaWan25I2iPreviewParams, type AlibabaWan25I2iPreviewResource, type AlibabaWan25T2iPreviewParams, type AlibabaWan25T2iPreviewResource, type AlibabaWanx20T2iTurboParams, type AlibabaWanx20T2iTurboResource, type AlibabaWanx21I2vPlusParams, type AlibabaWanx21I2vPlusResource, type AlibabaWanx21I2vTurboParams, type AlibabaWanx21I2vTurboResource, type AlibabaWanx21T2iPlusParams, type AlibabaWanx21T2iPlusResource, type AlibabaWanx21T2iTurboParams, type AlibabaWanx21T2iTurboResource, type AlibabaWanx21T2vPlusParams, type AlibabaWanx21T2vPlusResource, type AlibabaWanx21T2vTurboParams, type AlibabaWanx21T2vTurboResource, type AlibabaWanx22I2vFlashParams, type AlibabaWanx22I2vFlashResource, type AlibabaWanx22I2vPlusParams, type AlibabaWanx22I2vPlusResource, type AlibabaWanx22T2vPlusParams, type AlibabaWanx22T2vPlusResource, type AlibabaWanx25I2vPreviewParams, type AlibabaWanx25I2vPreviewResource, type AlibabaWanx25T2vPreviewParams, type AlibabaWanx25T2vPreviewResource, type AlibabaWanx26I2vParams, type AlibabaWanx26I2vResource, type AlibabaWanx26ReferenceParams, type AlibabaWanx26ReferenceResource, type AlibabaWanx26T2vParams, type AlibabaWanx26T2vResource, type AppGenerationInput, type AppGenerationParams, type AppGenerationResource, type AppGenerationResult, type AppSearchParams, type AppSearchResponse, type BlackforestlabsFlux11ProParams, type BlackforestlabsFlux11ProResource, type BlackforestlabsFlux1ProParams, type BlackforestlabsFlux1ProResource, type BlackforestlabsFlux2FlexEditParams, type BlackforestlabsFlux2FlexEditResource, type BlackforestlabsFlux2FlexParams, type BlackforestlabsFlux2FlexResource, type BlackforestlabsFlux2ProEditParams, type BlackforestlabsFlux2ProEditResource, type BlackforestlabsFlux2ProParams, type BlackforestlabsFlux2ProResource, type BlackforestlabsFluxKontextMaxParams, type BlackforestlabsFluxKontextMaxResource, type BlackforestlabsFluxKontextProParams, type BlackforestlabsFluxKontextProResource, type ChatCompletionChoice, type ChatCompletionChunk, type ChatCompletionChunkChoice, type ChatCompletionChunkDelta, type ChatCompletionResponse, type ChatCompletionUsage, type ChatMessage, type ChatMessageRole, type ElevenlabsTtsGeneratorParams, type ElevenlabsTtsGeneratorResource, type FrameResult, type GoogleGemini3ProImageParams, type GoogleGemini3ProImageResource, type GoogleGeminiImageParams, type GoogleGeminiImageResource, type GoogleImagen4FastGenerateParams, type GoogleImagen4FastGenerateResource, type GoogleImagen4GenerateParams, type GoogleImagen4GenerateResource, type GoogleImagen4UltraGenerateParams, type GoogleImagen4UltraGenerateResource, type GoogleVeo20Generate001Params, type GoogleVeo20Generate001Resource, type GoogleVeo20GenerateExpParams, type GoogleVeo20GenerateExpResource, type GoogleVeo20GeneratePreviewParams, type GoogleVeo20GeneratePreviewResource, type GoogleVeo30FastGenerate001Params, type GoogleVeo30FastGenerate001Resource, type GoogleVeo30Generate001Params, type GoogleVeo30Generate001Resource, type GoogleVeo31Params, type GoogleVeo31Resource, type InitOptions, type KlingAvatarParams, type KlingAvatarResource, type KlingDurationExtensionParams, type KlingDurationExtensionResource, type KlingEffectsMultiV15Params, type KlingEffectsMultiV15Resource, type KlingEffectsMultiV16Params, type KlingEffectsMultiV16Resource, type KlingEffectsMultiV1Params, type KlingEffectsMultiV1Resource, type KlingEffectsSingleParams, type KlingEffectsSingleResource, type KlingLipsyncParams, type KlingLipsyncResource, type KlingOmniImageParams, type KlingOmniImageResource, type KlingOmniVideoParams, type KlingOmniVideoResource, type KlingV15I2vParams, type KlingV15I2vResource, type KlingV15Params, type KlingV15Resource, type KlingV16I2vParams, type KlingV16I2vResource, type KlingV16Params, type KlingV16Resource, type KlingV1I2vParams, type KlingV1I2vResource, type KlingV1Params, type KlingV1Resource, type KlingV21I2vParams, type KlingV21I2vResource, type KlingV21MasterI2vParams, type KlingV21MasterI2vResource, type KlingV21MasterParams, type KlingV21MasterResource, type KlingV25TurboI2vParams, type KlingV25TurboI2vResource, type KlingV25TurboParams, type KlingV25TurboResource, type KlingV26I2vParams, type KlingV26I2vResource, type KlingV26Params, type KlingV26Resource, type KlingV2MasterI2vParams, type KlingV2MasterI2vResource, type KlingV2MasterParams, type KlingV2MasterResource, type LabelItem, type LlmChatCompletionsParams, type MicrosoftGptImage15Params, type MicrosoftGptImage15Resource, type MicrosoftGptImage1Params, type MicrosoftGptImage1Resource, type MicrosoftSora2Params, type MicrosoftSora2Resource, type MinimaxHailuo02I2vParams, type MinimaxHailuo02I2vResource, type MinimaxHailuo02Params, type MinimaxHailuo02Resource, type MinimaxHailuo23FastI2vParams, type MinimaxHailuo23FastI2vResource, type MinimaxHailuo23I2vParams, type MinimaxHailuo23I2vResource, type MinimaxI2v01DirectorParams, type MinimaxI2v01DirectorResource, type MinimaxI2v01LiveParams, type MinimaxI2v01LiveResource, type MinimaxI2v01Params, type MinimaxI2v01Resource, type MinimaxT2aParams, type MinimaxT2aResource, type MinimaxT2v01DirectorParams, type MinimaxT2v01DirectorResource, type MinimaxT2v01Params, type MinimaxT2v01Resource, type MurekaFileUploadGeneratorParams, type MurekaFileUploadGeneratorResource, type MurekaInstrumentalGeneratorParams, type MurekaInstrumentalGeneratorResource, type MurekaInstrumentalGeneratorResult, type MurekaSongGeneratorParams, type MurekaSongGeneratorResource, type MurekaSongGeneratorResult, type MurekaSongRecognizeParams, type MurekaSongRecognizeResource, type MurekaSongRecognizeResult, type PixverseV35I2vParams, type PixverseV35I2vResource, type PixverseV35T2vParams, type PixverseV35T2vResource, type PixverseV35TransitionParams, type PixverseV35TransitionResource, type PixverseV45I2vParams, type PixverseV45I2vResource, type PixverseV45T2vParams, type PixverseV45T2vResource, type PixverseV45TransitionParams, type PixverseV45TransitionResource, type PixverseV4I2vParams, type PixverseV4I2vResource, type PixverseV4T2vParams, type PixverseV4T2vResource, type PixverseV4TransitionParams, type PixverseV4TransitionResource, type PixverseV55I2vParams, type PixverseV55I2vResource, type PixverseV55T2vParams, type PixverseV55T2vResource, type PixverseV55TransitionParams, type PixverseV55TransitionResource, type PixverseV5I2vParams, type PixverseV5I2vResource, type PixverseV5T2vParams, type PixverseV5T2vResource, type PixverseV5TransitionParams, type PixverseV5TransitionResource, type PollingOptions, type QuickAppBackgroundRemoverStandardParams, type QuickAppBackgroundRemoverStandardResource, type RiskType, type RunwayGen3aTurboI2vParams, type RunwayGen3aTurboI2vResource, type ScanParams, type ScanResponse, SeacloudClient, type SeacloudConfig, SeacloudError, type TaskError, type TaskResult, type TaskStatus, type TemplateSpec, type TemplateSpecConstraint, type TemplateSpecInput, type TemplateSpecOutput, type TemplateSpecsParams, type TemplateSpecsResponse, type TencentHunyuan3dParams, type TencentHunyuan3dProParams, type TencentHunyuan3dProResource, type TencentHunyuan3dRapidParams, type TencentHunyuan3dRapidResource, type TencentHunyuan3dResource, type TencentImageCreation3Params, type TencentImageCreation3Resource, type TencentMpsSuperResolutionParams, type TencentMpsSuperResolutionResource, type Vidu15I2vParams, type Vidu15I2vResource, type Vidu15Params, type Vidu15Resource, type Vidu20I2vParams, type Vidu20I2vResource, type ViduQ1I2vParams, type ViduQ1I2vResource, type ViduQ1Params, type ViduQ1Resource, type ViduQ2I2vReferenceParams, type ViduQ2I2vReferenceResource, type ViduQ2Params, type ViduQ2ReferenceSubject, type ViduQ2Resource, type ViduQ3ProI2VParams, type ViduQ3ProI2VResource, type ViduQ3ProParams, type ViduQ3ProResource, type ViduTemplateParams, type ViduTemplateResource, type ViduTemplateV2Params, type ViduTemplateV2Resource, type VolcesJimeng30Params, type VolcesJimeng30Resource, type VolcesJimeng31Params, type VolcesJimeng31Resource, type VolcesJimengDreamActorM1Params, type VolcesJimengDreamActorM1Resource, type VolcesJimengI2i30Params, type VolcesJimengI2i30Resource, type VolcesRealmanAvatarImitatorV2vParams, type VolcesRealmanAvatarImitatorV2vResource, type VolcesRealmanAvatarPictureOmniV15Params, type VolcesRealmanAvatarPictureOmniV15Resource, type VolcesRealmanAvatarPictureOmniV2Params, type VolcesRealmanAvatarPictureOmniV2Resource, type VolcesSeed3dParams, type VolcesSeed3dResource, type VolcesSeedance15ProParams, type VolcesSeedance15ProResource, type VolcesSeedance30I2vParams, type VolcesSeedance30I2vResource, type VolcesSeedance30Params, type VolcesSeedance30ProParams, type VolcesSeedance30ProResource, type VolcesSeedance30Resource, type VolcesSeedanceProFastParams, type VolcesSeedanceProFastResource, type VolcesSeededit20Params, type VolcesSeededit20Resource, type VolcesSeededit30I2iParams, type VolcesSeededit30I2iResource, type VolcesSeededit30Params, type VolcesSeededit30Resource, type VolcesSeededit3dStyleParams, type VolcesSeededit3dStyleResource, type VolcesSeededitMultiIpParams, type VolcesSeededitMultiIpResource, type VolcesSeededitMultiStyleParams, type VolcesSeededitMultiStyleResource, type VolcesSeededitPortraitParams, type VolcesSeededitPortraitResource, type VolcesSeededitSingleIpParams, type VolcesSeededitSingleIpResource, type VolcesSeedream30Params, type VolcesSeedream30Resource, type VolcesSeedream40Params, type VolcesSeedream40Resource, type VolcesSeedream45I2iParams, type VolcesSeedream45I2iResource, type VolcesSeedream45MultiBlendParams, type VolcesSeedream45MultiBlendResource, type VolcesSeedream45Params, type VolcesSeedream45Resource, type VolcesSubjectDetectionParams, type VolcesSubjectDetectionResource, type VolcesSubjectRecognitionParams, type VolcesSubjectRecognitionResource, type YouchuanDiffusionParams, type YouchuanDiffusionResource, type YouchuanEditParams, type YouchuanEditResource, type YouchuanEnhanceParams, type YouchuanEnhanceResource, type YouchuanExtendVideoParams, type YouchuanExtendVideoResource, type YouchuanInpaintArea, type YouchuanInpaintMask, type YouchuanInpaintParams, type YouchuanInpaintResource, type YouchuanOutpaintParams, type YouchuanOutpaintResource, type YouchuanPanParams, type YouchuanPanResource, type YouchuanRemixParams, type YouchuanRemixResource, type YouchuanRemoveBackgroundParams, type YouchuanRemoveBackgroundResource, type YouchuanRetextureParams, type YouchuanRetextureResource, type YouchuanUploadpaintParams, type YouchuanUploadpaintResource, type YouchuanUpscaleParams, type YouchuanUpscaleResource, type YouchuanVariationParams, type YouchuanVariationResource, type YouchuanVideoDiffusionParams, type YouchuanVideoDiffusionResource, type YouchuanVideoUpscaleParams, type YouchuanVideoUpscaleResource, agentChatCompletions, alibabaAnimateAnyoneDetect, alibabaAnimateAnyoneTemplate, alibabaAnimateAnyoneVideo, alibabaQianwenImage, alibabaWan22T2iFlash, alibabaWan22T2iPlus, alibabaWan25I2iPreview, alibabaWan25T2iPreview, alibabaWanx20T2iTurbo, alibabaWanx21I2vPlus, alibabaWanx21I2vTurbo, alibabaWanx21T2iPlus, alibabaWanx21T2iTurbo, alibabaWanx21T2vPlus, alibabaWanx21T2vTurbo, alibabaWanx22I2vFlash, alibabaWanx22I2vPlus, alibabaWanx22T2vPlus, alibabaWanx25I2vPreview, alibabaWanx25T2vPreview, alibabaWanx26I2v, alibabaWanx26Reference, alibabaWanx26T2v, appGeneration, appSearch, blackforestlabsFlux11Pro, blackforestlabsFlux1Pro, blackforestlabsFlux2Flex, blackforestlabsFlux2FlexEdit, blackforestlabsFlux2Pro, blackforestlabsFlux2ProEdit, blackforestlabsFluxKontextMax, blackforestlabsFluxKontextPro, clearCustomHeaders, createAndWaitTask, createAudioMessage, createConfig, createImageMessage, createTextMessage, createTool, createVideoMessage, elevenlabsTtsGenerator, getAppId, getClient, getCustomHeaders, getDefaultPollingOptions, getHostFromParent, getTaskStatus, googleGemini3ProImage, googleGeminiImage, googleImagen4FastGenerate, googleImagen4Generate, googleImagen4UltraGenerate, googleVeo20Generate001, googleVeo20GenerateExp, googleVeo20GeneratePreview, googleVeo30FastGenerate001, googleVeo30Generate001, googleVeo31, initSeacloud, klingAvatar, klingDurationExtension, klingEffectsMultiV1, klingEffectsMultiV15, klingEffectsMultiV16, klingEffectsSingle, klingLipsync, klingOmniImage, klingOmniVideo, klingV1, klingV15, klingV15I2v, klingV16, klingV16I2v, klingV1I2v, klingV21I2v, klingV21Master, klingV21MasterI2v, klingV25Turbo, klingV25TurboI2v, klingV26, klingV26I2v, klingV2Master, klingV2MasterI2v, llmChatCompletions, microsoftGptImage1, microsoftGptImage15, microsoftSora2, minimaxHailuo02, minimaxHailuo02I2v, minimaxHailuo23FastI2v, minimaxHailuo23I2v, minimaxI2v01, minimaxI2v01Director, minimaxI2v01Live, minimaxT2a, minimaxT2v01, minimaxT2v01Director, murekaFileUploadGenerator, murekaInstrumentalGenerator, murekaSongGenerator, murekaSongRecognize, pixverseV35I2v, pixverseV35T2v, pixverseV35Transition, pixverseV45I2v, pixverseV45T2v, pixverseV45Transition, pixverseV4I2v, pixverseV4T2v, pixverseV4Transition, pixverseV55I2v, pixverseV55T2v, pixverseV55Transition, pixverseV5I2v, pixverseV5T2v, pixverseV5Transition, pollTaskUntilComplete, quickAppBackgroundRemoverStandard, resetConfig, runwayGen3aTurboI2v, scan, setCustomHeaders, setDefaultPollingOptions, templateSpecs, tencentHunyuan3d, tencentHunyuan3dPro, tencentHunyuan3dRapid, tencentImageCreation3, tencentMpsSuperResolution, validateConfig, validateResourceUrl, validateResources, vidu15, vidu15I2v, vidu20I2v, viduQ1, viduQ1I2v, viduQ2, viduQ2I2vReference, viduQ3Pro, viduQ3ProI2V, viduTemplate, viduTemplateV2, volcesJimeng30, volcesJimeng31, volcesJimengDreamActorM1, volcesJimengI2i30, volcesRealmanAvatarImitatorV2v, volcesRealmanAvatarPictureOmniV15, volcesRealmanAvatarPictureOmniV2, volcesSeed3d, volcesSeedance15Pro, volcesSeedance30, volcesSeedance30I2v, volcesSeedance30Pro, volcesSeedanceProFast, volcesSeededit20, volcesSeededit30, volcesSeededit30I2i, volcesSeededit3dStyle, volcesSeededitMultiIp, volcesSeededitMultiStyle, volcesSeededitPortrait, volcesSeededitSingleIp, volcesSeedream30, volcesSeedream40, volcesSeedream45, volcesSeedream45I2i, volcesSeedream45MultiBlend, volcesSubjectDetection, volcesSubjectRecognition, youchuanDiffusion, youchuanEdit, youchuanEnhance, youchuanExtendVideo, youchuanInpaint, youchuanOutpaint, youchuanPan, youchuanRemix, youchuanRemoveBackground, youchuanRetexture, youchuanUploadpaint, youchuanUpscale, youchuanVariation, youchuanVideoDiffusion, youchuanVideoUpscale };
16674
+ export { type AgentArtifact, type AgentChatCompletionChoice, type AgentChatCompletionChunk, type AgentChatCompletionChunkChoice, type AgentChatCompletionDelta, type AgentChatCompletionResponse, type AgentChatCompletionsParams, type AgentContentFilterResult, type AgentMessage, type AgentMessageContent, type AgentMessageContentType, type AgentMessageRole, type AgentResponseMessage, type AgentTool, type AgentToolCall, type AgentToolFunction, type AgentUsage, type AlibabaAnimateAnyoneDetectParams, type AlibabaAnimateAnyoneDetectResource, type AlibabaAnimateAnyoneTemplateParams, type AlibabaAnimateAnyoneTemplateResource, type AlibabaAnimateAnyoneVideoParams, type AlibabaAnimateAnyoneVideoResource, type AlibabaQianwenImageParams, type AlibabaQianwenImageResource, type AlibabaWan22T2iFlashParams, type AlibabaWan22T2iFlashResource, type AlibabaWan22T2iPlusParams, type AlibabaWan22T2iPlusResource, type AlibabaWan25I2iPreviewParams, type AlibabaWan25I2iPreviewResource, type AlibabaWan25T2iPreviewParams, type AlibabaWan25T2iPreviewResource, type AlibabaWanx20T2iTurboParams, type AlibabaWanx20T2iTurboResource, type AlibabaWanx21I2vPlusParams, type AlibabaWanx21I2vPlusResource, type AlibabaWanx21I2vTurboParams, type AlibabaWanx21I2vTurboResource, type AlibabaWanx21T2iPlusParams, type AlibabaWanx21T2iPlusResource, type AlibabaWanx21T2iTurboParams, type AlibabaWanx21T2iTurboResource, type AlibabaWanx21T2vPlusParams, type AlibabaWanx21T2vPlusResource, type AlibabaWanx21T2vTurboParams, type AlibabaWanx21T2vTurboResource, type AlibabaWanx22I2vFlashParams, type AlibabaWanx22I2vFlashResource, type AlibabaWanx22I2vPlusParams, type AlibabaWanx22I2vPlusResource, type AlibabaWanx22T2vPlusParams, type AlibabaWanx22T2vPlusResource, type AlibabaWanx25I2vPreviewParams, type AlibabaWanx25I2vPreviewResource, type AlibabaWanx25T2vPreviewParams, type AlibabaWanx25T2vPreviewResource, type AlibabaWanx26I2vParams, type AlibabaWanx26I2vResource, type AlibabaWanx26ReferenceParams, type AlibabaWanx26ReferenceResource, type AlibabaWanx26T2vParams, type AlibabaWanx26T2vResource, type AppGenerationInput, type AppGenerationParams, type AppGenerationResource, type AppGenerationResult, type AppSearchParams, type AppSearchResponse, type BlackforestlabsFlux11ProParams, type BlackforestlabsFlux11ProResource, type BlackforestlabsFlux1ProParams, type BlackforestlabsFlux1ProResource, type BlackforestlabsFlux2FlexEditParams, type BlackforestlabsFlux2FlexEditResource, type BlackforestlabsFlux2FlexParams, type BlackforestlabsFlux2FlexResource, type BlackforestlabsFlux2ProEditParams, type BlackforestlabsFlux2ProEditResource, type BlackforestlabsFlux2ProParams, type BlackforestlabsFlux2ProResource, type BlackforestlabsFluxKontextMaxParams, type BlackforestlabsFluxKontextMaxResource, type BlackforestlabsFluxKontextProParams, type BlackforestlabsFluxKontextProResource, type ChatCompletionChoice, type ChatCompletionChunk, type ChatCompletionChunkChoice, type ChatCompletionChunkDelta, type ChatCompletionResponse, type ChatCompletionUsage, type ChatMessage, type ChatMessageRole, type ElevenlabsTtsGeneratorParams, type ElevenlabsTtsGeneratorResource, type FrameResult, type GoogleGemini3ProImageParams, type GoogleGemini3ProImageResource, type GoogleGeminiImageParams, type GoogleGeminiImageResource, type GoogleImagen4FastGenerateParams, type GoogleImagen4FastGenerateResource, type GoogleImagen4GenerateParams, type GoogleImagen4GenerateResource, type GoogleImagen4UltraGenerateParams, type GoogleImagen4UltraGenerateResource, type GoogleVeo20Generate001Params, type GoogleVeo20Generate001Resource, type GoogleVeo20GenerateExpParams, type GoogleVeo20GenerateExpResource, type GoogleVeo20GeneratePreviewParams, type GoogleVeo20GeneratePreviewResource, type GoogleVeo30FastGenerate001Params, type GoogleVeo30FastGenerate001Resource, type GoogleVeo30Generate001Params, type GoogleVeo30Generate001Resource, type GoogleVeo31Params, type GoogleVeo31Resource, type InitOptions, type KlingAvatarParams, type KlingAvatarResource, type KlingDurationExtensionParams, type KlingDurationExtensionResource, type KlingEffectsMultiV15Params, type KlingEffectsMultiV15Resource, type KlingEffectsMultiV16Params, type KlingEffectsMultiV16Resource, type KlingEffectsMultiV1Params, type KlingEffectsMultiV1Resource, type KlingEffectsSingleParams, type KlingEffectsSingleResource, type KlingLipsyncParams, type KlingLipsyncResource, type KlingOmniImageParams, type KlingOmniImageResource, type KlingOmniVideoParams, type KlingOmniVideoResource, type KlingV15I2vParams, type KlingV15I2vResource, type KlingV15Params, type KlingV15Resource, type KlingV16I2vParams, type KlingV16I2vResource, type KlingV16Params, type KlingV16Resource, type KlingV1I2vParams, type KlingV1I2vResource, type KlingV1Params, type KlingV1Resource, type KlingV21I2vParams, type KlingV21I2vResource, type KlingV21MasterI2vParams, type KlingV21MasterI2vResource, type KlingV21MasterParams, type KlingV21MasterResource, type KlingV25TurboI2vParams, type KlingV25TurboI2vResource, type KlingV25TurboParams, type KlingV25TurboResource, type KlingV26I2vParams, type KlingV26I2vResource, type KlingV26Params, type KlingV26Resource, type KlingV2MasterI2vParams, type KlingV2MasterI2vResource, type KlingV2MasterParams, type KlingV2MasterResource, type KlingV3ImageToVideoParams, type KlingV3ImageToVideoResource, type KlingV3OmniImageParams, type KlingV3OmniImageResource, type KlingV3OmniVideoParams, type KlingV3OmniVideoResource, type KlingV3TextToVideoParams, type KlingV3TextToVideoResource, type LabelItem, type LlmChatCompletionsParams, type MicrosoftGptImage15Params, type MicrosoftGptImage15Resource, type MicrosoftGptImage1Params, type MicrosoftGptImage1Resource, type MicrosoftSora2Params, type MicrosoftSora2Resource, type MinimaxHailuo02I2vParams, type MinimaxHailuo02I2vResource, type MinimaxHailuo02Params, type MinimaxHailuo02Resource, type MinimaxHailuo23FastI2vParams, type MinimaxHailuo23FastI2vResource, type MinimaxHailuo23I2vParams, type MinimaxHailuo23I2vResource, type MinimaxI2v01DirectorParams, type MinimaxI2v01DirectorResource, type MinimaxI2v01LiveParams, type MinimaxI2v01LiveResource, type MinimaxI2v01Params, type MinimaxI2v01Resource, type MinimaxT2aParams, type MinimaxT2aResource, type MinimaxT2v01DirectorParams, type MinimaxT2v01DirectorResource, type MinimaxT2v01Params, type MinimaxT2v01Resource, type MurekaFileUploadGeneratorParams, type MurekaFileUploadGeneratorResource, type MurekaInstrumentalGeneratorParams, type MurekaInstrumentalGeneratorResource, type MurekaInstrumentalGeneratorResult, type MurekaSongGeneratorParams, type MurekaSongGeneratorResource, type MurekaSongGeneratorResult, type MurekaSongRecognizeParams, type MurekaSongRecognizeResource, type MurekaSongRecognizeResult, type PixverseV35I2vParams, type PixverseV35I2vResource, type PixverseV35T2vParams, type PixverseV35T2vResource, type PixverseV35TransitionParams, type PixverseV35TransitionResource, type PixverseV45I2vParams, type PixverseV45I2vResource, type PixverseV45T2vParams, type PixverseV45T2vResource, type PixverseV45TransitionParams, type PixverseV45TransitionResource, type PixverseV4I2vParams, type PixverseV4I2vResource, type PixverseV4T2vParams, type PixverseV4T2vResource, type PixverseV4TransitionParams, type PixverseV4TransitionResource, type PixverseV55I2vParams, type PixverseV55I2vResource, type PixverseV55T2vParams, type PixverseV55T2vResource, type PixverseV55TransitionParams, type PixverseV55TransitionResource, type PixverseV5I2vParams, type PixverseV5I2vResource, type PixverseV5T2vParams, type PixverseV5T2vResource, type PixverseV5TransitionParams, type PixverseV5TransitionResource, type PollingOptions, type QuickAppBackgroundRemoverStandardParams, type QuickAppBackgroundRemoverStandardResource, type RiskType, type RunwayGen3aTurboI2vParams, type RunwayGen3aTurboI2vResource, type ScanParams, type ScanResponse, SeacloudClient, type SeacloudConfig, SeacloudError, type TaskError, type TaskResult, type TaskStatus, type TemplateSpec, type TemplateSpecConstraint, type TemplateSpecInput, type TemplateSpecOutput, type TemplateSpecsParams, type TemplateSpecsResponse, type TencentHunyuan3dParams, type TencentHunyuan3dProParams, type TencentHunyuan3dProResource, type TencentHunyuan3dRapidParams, type TencentHunyuan3dRapidResource, type TencentHunyuan3dResource, type TencentImageCreation3Params, type TencentImageCreation3Resource, type TencentMpsSuperResolutionParams, type TencentMpsSuperResolutionResource, type Vidu15I2vParams, type Vidu15I2vResource, type Vidu15Params, type Vidu15Resource, type Vidu20I2vParams, type Vidu20I2vResource, type ViduQ1I2vParams, type ViduQ1I2vResource, type ViduQ1Params, type ViduQ1Resource, type ViduQ2I2vReferenceParams, type ViduQ2I2vReferenceResource, type ViduQ2Params, type ViduQ2ReferenceSubject, type ViduQ2Resource, type ViduQ3ProI2VParams, type ViduQ3ProI2VResource, type ViduQ3ProParams, type ViduQ3ProResource, type ViduTemplateParams, type ViduTemplateResource, type ViduTemplateV2Params, type ViduTemplateV2Resource, type VolcesJimeng30Params, type VolcesJimeng30Resource, type VolcesJimeng31Params, type VolcesJimeng31Resource, type VolcesJimengDreamActorM1Params, type VolcesJimengDreamActorM1Resource, type VolcesJimengI2i30Params, type VolcesJimengI2i30Resource, type VolcesRealmanAvatarImitatorV2vParams, type VolcesRealmanAvatarImitatorV2vResource, type VolcesRealmanAvatarPictureOmniV15Params, type VolcesRealmanAvatarPictureOmniV15Resource, type VolcesRealmanAvatarPictureOmniV2Params, type VolcesRealmanAvatarPictureOmniV2Resource, type VolcesSeed3dParams, type VolcesSeed3dResource, type VolcesSeedance15ProParams, type VolcesSeedance15ProResource, type VolcesSeedance30I2vParams, type VolcesSeedance30I2vResource, type VolcesSeedance30Params, type VolcesSeedance30ProParams, type VolcesSeedance30ProResource, type VolcesSeedance30Resource, type VolcesSeedanceProFastParams, type VolcesSeedanceProFastResource, type VolcesSeededit20Params, type VolcesSeededit20Resource, type VolcesSeededit30I2iParams, type VolcesSeededit30I2iResource, type VolcesSeededit30Params, type VolcesSeededit30Resource, type VolcesSeededit3dStyleParams, type VolcesSeededit3dStyleResource, type VolcesSeededitMultiIpParams, type VolcesSeededitMultiIpResource, type VolcesSeededitMultiStyleParams, type VolcesSeededitMultiStyleResource, type VolcesSeededitPortraitParams, type VolcesSeededitPortraitResource, type VolcesSeededitSingleIpParams, type VolcesSeededitSingleIpResource, type VolcesSeedream30Params, type VolcesSeedream30Resource, type VolcesSeedream40Params, type VolcesSeedream40Resource, type VolcesSeedream45I2iParams, type VolcesSeedream45I2iResource, type VolcesSeedream45MultiBlendParams, type VolcesSeedream45MultiBlendResource, type VolcesSeedream45Params, type VolcesSeedream45Resource, type VolcesSubjectDetectionParams, type VolcesSubjectDetectionResource, type VolcesSubjectRecognitionParams, type VolcesSubjectRecognitionResource, type YouchuanDiffusionParams, type YouchuanDiffusionResource, type YouchuanEditParams, type YouchuanEditResource, type YouchuanEnhanceParams, type YouchuanEnhanceResource, type YouchuanExtendVideoParams, type YouchuanExtendVideoResource, type YouchuanInpaintArea, type YouchuanInpaintMask, type YouchuanInpaintParams, type YouchuanInpaintResource, type YouchuanOutpaintParams, type YouchuanOutpaintResource, type YouchuanPanParams, type YouchuanPanResource, type YouchuanRemixParams, type YouchuanRemixResource, type YouchuanRemoveBackgroundParams, type YouchuanRemoveBackgroundResource, type YouchuanRetextureParams, type YouchuanRetextureResource, type YouchuanUploadpaintParams, type YouchuanUploadpaintResource, type YouchuanUpscaleParams, type YouchuanUpscaleResource, type YouchuanVariationParams, type YouchuanVariationResource, type YouchuanVideoDiffusionParams, type YouchuanVideoDiffusionResource, type YouchuanVideoUpscaleParams, type YouchuanVideoUpscaleResource, agentChatCompletions, alibabaAnimateAnyoneDetect, alibabaAnimateAnyoneTemplate, alibabaAnimateAnyoneVideo, alibabaQianwenImage, alibabaWan22T2iFlash, alibabaWan22T2iPlus, alibabaWan25I2iPreview, alibabaWan25T2iPreview, alibabaWanx20T2iTurbo, alibabaWanx21I2vPlus, alibabaWanx21I2vTurbo, alibabaWanx21T2iPlus, alibabaWanx21T2iTurbo, alibabaWanx21T2vPlus, alibabaWanx21T2vTurbo, alibabaWanx22I2vFlash, alibabaWanx22I2vPlus, alibabaWanx22T2vPlus, alibabaWanx25I2vPreview, alibabaWanx25T2vPreview, alibabaWanx26I2v, alibabaWanx26Reference, alibabaWanx26T2v, appGeneration, appSearch, blackforestlabsFlux11Pro, blackforestlabsFlux1Pro, blackforestlabsFlux2Flex, blackforestlabsFlux2FlexEdit, blackforestlabsFlux2Pro, blackforestlabsFlux2ProEdit, blackforestlabsFluxKontextMax, blackforestlabsFluxKontextPro, clearCustomHeaders, createAndWaitTask, createAudioMessage, createConfig, createImageMessage, createTextMessage, createTool, createVideoMessage, elevenlabsTtsGenerator, getAppId, getClient, getCustomHeaders, getDefaultPollingOptions, getHostFromParent, getTaskStatus, googleGemini3ProImage, googleGeminiImage, googleImagen4FastGenerate, googleImagen4Generate, googleImagen4UltraGenerate, googleVeo20Generate001, googleVeo20GenerateExp, googleVeo20GeneratePreview, googleVeo30FastGenerate001, googleVeo30Generate001, googleVeo31, initSeacloud, klingAvatar, klingDurationExtension, klingEffectsMultiV1, klingEffectsMultiV15, klingEffectsMultiV16, klingEffectsSingle, klingLipsync, klingOmniImage, klingOmniVideo, klingV1, klingV15, klingV15I2v, klingV16, klingV16I2v, klingV1I2v, klingV21I2v, klingV21Master, klingV21MasterI2v, klingV25Turbo, klingV25TurboI2v, klingV26, klingV26I2v, klingV2Master, klingV2MasterI2v, klingV3ImageToVideo, klingV3OmniImage, klingV3OmniVideo, klingV3TextToVideo, llmChatCompletions, microsoftGptImage1, microsoftGptImage15, microsoftSora2, minimaxHailuo02, minimaxHailuo02I2v, minimaxHailuo23FastI2v, minimaxHailuo23I2v, minimaxI2v01, minimaxI2v01Director, minimaxI2v01Live, minimaxT2a, minimaxT2v01, minimaxT2v01Director, murekaFileUploadGenerator, murekaInstrumentalGenerator, murekaSongGenerator, murekaSongRecognize, pixverseV35I2v, pixverseV35T2v, pixverseV35Transition, pixverseV45I2v, pixverseV45T2v, pixverseV45Transition, pixverseV4I2v, pixverseV4T2v, pixverseV4Transition, pixverseV55I2v, pixverseV55T2v, pixverseV55Transition, pixverseV5I2v, pixverseV5T2v, pixverseV5Transition, pollTaskUntilComplete, quickAppBackgroundRemoverStandard, resetConfig, runwayGen3aTurboI2v, scan, setCustomHeaders, setDefaultPollingOptions, templateSpecs, tencentHunyuan3d, tencentHunyuan3dPro, tencentHunyuan3dRapid, tencentImageCreation3, tencentMpsSuperResolution, validateConfig, validateResourceUrl, validateResources, vidu15, vidu15I2v, vidu20I2v, viduQ1, viduQ1I2v, viduQ2, viduQ2I2vReference, viduQ3Pro, viduQ3ProI2V, viduTemplate, viduTemplateV2, volcesJimeng30, volcesJimeng31, volcesJimengDreamActorM1, volcesJimengI2i30, volcesRealmanAvatarImitatorV2v, volcesRealmanAvatarPictureOmniV15, volcesRealmanAvatarPictureOmniV2, volcesSeed3d, volcesSeedance15Pro, volcesSeedance30, volcesSeedance30I2v, volcesSeedance30Pro, volcesSeedanceProFast, volcesSeededit20, volcesSeededit30, volcesSeededit30I2i, volcesSeededit3dStyle, volcesSeededitMultiIp, volcesSeededitMultiStyle, volcesSeededitPortrait, volcesSeededitSingleIp, volcesSeedream30, volcesSeedream40, volcesSeedream45, volcesSeedream45I2i, volcesSeedream45MultiBlend, volcesSubjectDetection, volcesSubjectRecognition, youchuanDiffusion, youchuanEdit, youchuanEnhance, youchuanExtendVideo, youchuanInpaint, youchuanOutpaint, youchuanPan, youchuanRemix, youchuanRemoveBackground, youchuanRetexture, youchuanUploadpaint, youchuanUpscale, youchuanVariation, youchuanVideoDiffusion, youchuanVideoUpscale };