实时数仓Hologres：AI Function生成图片或视频

ai_gen

ai_gen 的基本函数语法如下：

SELECT ai_gen('<model>', <prompt>::TEXT, <file>);

参数说明：

返回值：JSON 格式的 TEXT，包含生成结果的 URL、使用量等信息。

to_file()

工具函数，将 OSS 路径转换为 FILE 类型，用于 OSS 访问权限传递。语法如下：

to_file('<oss_path>', '<oss_endpoint>', '<role_arn>')

参数说明：

返回值：FILE 类型。如果 URL 文件路径非法或文件不存在，则报错。

文生图

根据文字描述生成图片。

支持的模型：qwen-image-2.0-pro、qwen-image-2.0-pro-2026-03-03、qwen-image-2.0、qwen-image-2.0-2026-03-03、qwen-image-max、qwen-image-plus、qwen-image。模型的详细使用方法请参见百炼文档。

prompt 参数：

示例一：文生图，直接预览不保存至 OSS。

--文生图，不保留结果至oss，直接预览，部署qwen-image-2.0-pro模型
SELECT
    ai_gen('qwen_image_2_pro',
    json_build_object(
        'prompt', '生成一个 Q 版刘备人物',
        'parameters', json_build_object(
            'n', 1,
            'size', '1024*1024',
            'watermark', FALSE
            )
        )::TEXT,
    to_file('oss://xxxx/holo_ai_powered_marketing_content/xxx', 'oss-cn-hangzhou-internal.aliyuncs.com', 'acs:ram::186xxx:role/xxx')--需要用to_file来鉴权
    );

返回结果为 JSON 格式，示例如下：

{
  "requestId": "xxx",--响应ID
  "usage": {...},--图片的相关参数，长和宽以及数据量
  "image_urls": ["https://..."], --图片的地址，百炼默认给的公网地址，有访问时效性
  "image_oss_paths": ["oss://bucket/output/xxx.png"]  没有指定OSS的目录时，返回为空
}

返回字段说明：

• requestId：请求 ID。

• usage：图片参数，包括宽度、高度和数量。

• image_urls：百炼返回的图片公网地址，有访问时效性。

• image_oss_paths：未指定 output_dir 时为空；指定后返回保存至 OSS 的文件路径。

示例二：文生图并将图片保存至 OSS。

--文生图，并将图片保存在用户的OSS中
SELECT
    ai_gen('qwen_image_2_pro',
    json_build_object(
        'prompt', '生成一个 Q 版刘备人物',
        'parameters', json_build_object(
            'n', 1,
            'size', '1024*1024',
            'watermark', FALSE
            ),
        'output_dir', 'oss://xxx/holo_ai_powered_marketing_content/'--oss的文件路径
        )::TEXT,
    to_file('oss://xxx/holo_ai_powered_marketing_content/xxx', 'oss-cn-hangzhou-internal.aliyuncs.com', 'acs:ram::186xxx:role/xxx')
    );

执行成功后，即可前往 OSS 文件目录查看结果：

图片编辑

基于参考图片，根据提示词进行编辑，生成新的图片。

支持的模型：qwen-image-2.0-pro、qwen-image-edit、qwen-image-edit-plus、qwen-image-edit-max。详细使用方法请参见图像编辑-千问。

prompt 参数：

SQL 示例：对图片进行编辑并生成新的图片。

--图片编辑
SELECT ai_gen('qwen_image_edit', json_build_object(
    'prompt', '保持原图Q版刘备角色和国风漫画风格，刘备骑在高大骏马上巡视前方，姿态从容威严，背景为古风城池与未来数据之城融合的场景，建筑上漂浮数据图表、仪表盘、蓝色发光网格和信息流，刘备手持象征命令与决策的卷轴或令牌，上面出现"Hologres"标识，整体构图大气、品牌感强，突出"掌控全局、实时洞察、运筹帷幄"的广告气质',
    'reference_urls', array['oss://xxx/holo_ai_powered_marketing_content/c8403238-3c88-44a6-ac85-2e5447e987b2.png'],
    'parameters', json_build_object(
        'n', 2,
        'size', '1024*1024',
        'watermark', FALSE
    )
)::TEXT, to_file('oss://xxx/holo_ai_powered_marketing_content/xx', 'oss-cn-hangzhou-internal.aliyuncs.com', 'acs:ram::xxx:role/xxx'));

生成的新图片结果示例如下：

多图融合

基于多张参考图片，融合生成新的图片。

支持的模型：qwen-image-2.0-pro。

prompt 参数：

SQL 示例：基于两张图片融合生成新的图片。

SELECT ai_gen('qwen_image_2_pro', json_build_object(
    'prompt', '保持第一张图中的Q版刘备形象和服装设定一致，人物站在画面中央，手持"Hologres"卷轴，脚下出现发光的数据法阵或蓝色科技圆环，身后逐渐浮现一匹骏马。画面左侧仍保留国风祥云、宣纸质感和古代氛围，右侧逐渐过渡为蓝色未来数据城市、悬浮大屏、实时图表和数字光流。刘备的神态从平静转为坚定，表现出即将踏入科技世界、推广实时数仓的使命感。',
    'reference_urls', array['oss://hm-ai-hangzhou/holo_ai_powered_marketing_content/c8403238-3c88-44a6-ac85-2e5447e987b2.png', 'oss://hm-ai-hangzhou/holo_ai_powered_marketing_content/bde5d500-5efc-4d77-9651-6d6bd81906fe-1.png'],
    'parameters', json_build_object(
        'n', 1,
        'size', '1024*1024',
        'watermark', FALSE
    )
)::TEXT,
to_file('oss://xxxx/holo_ai_powered_marketing_content/xxx', 'oss-cn-hangzhou-internal.aliyuncs.com', 'acs:ram::xxxx:role/xxxx')
);

输出结果示例如下：

文生视频

根据文字描述生成视频，可选配背景音频。

支持的模型：wan2.6-t2v。详细使用方法请参见视频生成。

prompt 参数：

SQL 示例：根据文字描述生成视频。

--文生视频
select ai_gen('wan26_t2v', json_build_object(
    'prompt', 'Q版刘备骑乘骏马从远方快速而来，头戴金冠，身穿蓝色古风长袍和红色腰带，神情坚定，自带领袖气质。战马奔跑时步伐有力，蹄下扬起轻微尘土，刘备衣摆翻动，整体动作流畅自然。背景是古风城门、祥云和晨光，画面充满史诗感与卡通可爱感结合的风格。镜头先远景展示整体，再快速推进到中近景，强化角色登场冲击力，适合作为短视频开头画面',
   -- 'audio_url', 'oss://bucket/path/background.mp3',
    'parameters', json_build_object(
        'size', '1280*720',
        'prompt_extend', TRUE,
        'duration', 5,
        'shot_type', 'multi'
        )
    )::TEXT, 
to_file ('oss://xx/holo_ai_powered_marketing_content/xxx', 'oss-cn-hangzhou-internal.aliyuncs.com', 'acs:ram::xxx:role/xxx')
);

返回结果为 JSON 格式，包含以下信息：

{"request_id": 
"output": 
    {"task_id": , 
    "task_status": , 
    "submit_time": , 
    "scheduled_time": , 
    "end_time": , 
    "orig_prompt": , 
    "video_url": "https://xxxx"}, 
    "usage":{
        "duration": 5, 
        "size": "1280*720", 
        "input_video_duration": 0, 
        "output_video_duration": 5,
        "video_count": 1, 
        "SR": 720
        }
    }

最终结果示例如下：

基于首帧生成视频

提供首帧图片，根据文字描述生成视频，可选配背景音频。

支持的模型：wan2.6-i2v-flash、wan2.6-i2v。详细使用方法请参见百炼文档。

prompt 参数：

SQL 示例：基于首帧图片生成视频。

SELECT ai_gen('wan26_i2v', json_build_object(
    'prompt', '以这张图为首帧，生成5秒角色登场视频。Q版刘备骑着骏马缓缓向镜头走来，人物保持可爱精致的国风漫画形象，蓝色古装和红色腰带轻微摆动，手举"Hologres"卷轴稳定上扬。马匹自然迈步前进，马头轻轻抬动，尾巴和鬃毛随风摆动。周围悬浮的数据图表和科技屏幕动态闪烁，蓝色光效流动，地面网格向前延展发光，背景古风楼阁与未来数据城融合，镜头缓慢推进，营造品牌IP登场和科技广告氛围，画面稳定流畅，细节清晰。',
    'img_url', 'oss://xxx/holo_ai_powered_marketing_content/bde5d500-5efc-4d77-9651-6d6bd81906fe-1.png',
    --'audio_url', 'oss://bucket/path/background.mp3',
    'parameters', json_build_object(
        'resolution', '720P',
        'prompt_extend', TRUE,
        'duration', 5,
        'shot_type', 'multi'
    )
)::TEXT,
    to_file('oss://xxx/holo_ai_powered_marketing_content/39dd0230-5260-48b7-98cd-17c2a58b5052-1.png', 'oss-cn-hangzhou-internal.aliyuncs.com', 'acs:ram::xxx:role/xxx'));

基于首尾帧生成视频

提供首帧和尾帧图片，生成两帧之间的过渡视频。

支持的模型：wan2.2-kf2v-flash。详细使用方法请参见百炼文档。

prompt 参数：

SQL 示例：基于首尾帧图片生成过渡视频。

--图片生成视频，首尾图生视频
SELECT ai_gen('wan22_kf2v_flash', json_build_object(
  'prompt', '第一张图为首帧，第二张图为尾帧，生成5秒平滑过渡视频。Q版刘备骑在马上，手持"Hologres"卷轴，背景为科技数据面板和蓝色网格地面，马匹轻微迈步，人物微微起伏。随后科技屏幕、蓝色光效和城市背景逐渐淡出，卷轴收起，马匹缓慢消失，人物自然落地并转为站立姿态，手中出现青绿色短刀，背景变为简洁宣纸和祥云，最终平滑过渡到第二张图的原始状态。保持人物服装、发冠、Q版比例和画风一致，动作自然，转场丝滑，镜头稳定。',
  'first_frame_url', 'oss://xxx/holo_ai_powered_marketing_content/xxx',
  'last_frame_url', 'oss://xxx/holo_ai_powered_marketing_content/yyyy',
  'parameters', json_build_object(
    'resolution', '720P',
    'prompt_extend', TRUE
    -- 'duration', 5
          )
   )::TEXT,
  to_file('oss://hm-ai-xxx/holo_ai_powered_marketing_content/xxx', 'oss-cn-hangzhou-internal.aliyuncs.com', 'acs:ram::xxx:role/xxx'));

参考生成视频

基于参考图片生成视频，支持多张参考图，可选配音频和水印。

支持的模型：wan2.6-r2v-flash、wan2.6-r2v。详细使用方法请参见百炼文档。

prompt 参数：

SQL 示例：基于参考图片生成视频。

SELECT ai_gen('wan26_r2v', json_build_object(
  'prompt', '让 oss://bucket/path/golden_man.png 和 oss://bucket/path/stone_man.png 融合在一个图里并生成握手微笑的视频。',
  'reference_urls', array['oss://bucket/path/golden_man.png', 'oss://bucket/path/stone_man.png'],
  'parameters', json_build_object(
    'size', '1280*720',
    'duration', 5,
    'shot_type', 'multi',
    'audio', TRUE,
    'watermark', FALSE
  ),
  'output_dir', 'oss://bucket/output/'
)::TEXT, to_file('oss://bucket/path/golden_man.png', 'oss-cn-hangzhou-internal.aliyuncs.com', '****role'));