Hologres:AI 関数による画像と動画の生成

ai_gen

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

パラメーター

戻り値：出力 URL、使用量情報、その他の詳細を含む JSON 形式の TEXT。

to_file()

to_file() は、OSS パスを OSS アクセス権限付与のための FILE タイプに変換するヘルパー関数です。

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

パラメーター

戻り値：FILE タイプ。ファイルパスが無効であるか、ファイルが存在しない場合はエラーを返します。

Text-to-Image

テキスト記述から画像を生成します。

サポートされているモデル: 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。モデルの詳細については、「Model Studio ドキュメント」をご参照ください。

プロンプトパラメーター

例 1：画像を生成し、OSS には保存しない

-- Text-to-Image：プレビューのみ、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') -- OSS 認証に必要
    );

応答は JSON オブジェクトです：

{
  "requestId": "xxx",
  "usage": {...},
  "image_urls": ["https://..."],
  "image_oss_paths": ["oss://bucket/output/xxx.png"]
}

応答フィールド

• requestId：リクエスト ID。

• usage：幅、高さ、数などの画像メタデータ。

• image_urls：Model Studio から返されるパブリック画像 URL。アクセスは時間制限があります。

• image_oss_paths：OSS 内のファイルパス。output_dir が指定されていない場合は空になり、画像が保存された後に値が設定されます。

例 2：画像を生成して OSS に保存する

-- Text-to-Image：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。詳細については、「Qwen 画像編集」をご参照ください。

プロンプトパラメーター

例：画像を編集して新しい画像を生成する

-- 画像編集
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'));

出力例：

複数画像の融合

複数のリファレンス画像をマージして、1 つの新しい画像を生成します。

サポートされているモデル：qwen-image-2.0-pro。

プロンプトパラメーター

例：2 つのリファレンス画像をマージして新しい画像を生成する

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

出力例：

Text-to-Video

テキスト記述から動画を生成します。オプションでバックグラウンド音声を追加できます。

サポートされているモデル：wan2.6-t2v。詳細については、「動画生成」をご参照ください。

プロンプトパラメーター

例：テキスト記述から動画を生成する

-- テキスト動画生成
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
  }
}

出力例：

42a5c0e4-d8d1-4335-9d7a-183039baa050.mp4

Image-to-Video

開始フレームの画像とテキスト記述から動画を生成します。オプションでバックグラウンド音声を追加できます。

対応モデル: wan2.6-i2v-flash、wan2.6-i2v。詳細については、「Model Studio ドキュメント」をご参照ください。

プロンプトパラメーター

例：開始フレームから動画を生成する

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。詳細については、「Model Studio ドキュメント」をご参照ください。

プロンプトパラメーター

例：開始フレームと終了フレームからトランジション動画を生成する

-- キーフレーム動画
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'));

リファレンス動画

1 つ以上のリファレンス画像から動画を生成します。オプションで音声とウォーターマークを追加できます。

対応モデル： wan2.6-r2v-flash、wan2.6-r2v。 詳細については、「Model Studio ドキュメント」をご参照ください。

プロンプトパラメーター

例：リファレンス画像から動画を生成する

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