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'));