该接口可以根据图片返回推荐提示词。

请求信息

请求 URL

POST /hub/vidu/v2/img2video-prompt-recommendation

请求头

Header	必填	示例值
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json; charset=utf-8

请求体

字段	类型	必填	说明
images	string[]	是	输入图片，当前仅支持 1 张。支持 URL 或 Base64，常见支持格式为 JPG、PNG、WEBP
type	string[]	是	推荐类型数组。常见值：template、img2video、start_end2video、e_commerce
resolution	string	否	目标分辨率，默认通常为 360p。常见值：360p、720p
count	int	否	返回推荐条数，默认通常为 5，常见可选范围：1-10

请求示例

{
  "images": [
    "https://example.com/input.png"
  ],
  "type": [
    "img2video",
    "template"
  ],
  "count": 5
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
images	string[]	输入图片
count	int	推荐条数
- prompts	object[]	推荐结果列表
type	string	推荐类型
content	string	展示用提示词
prompt	string	实际调用提示词，模板类结果常见
template	string	推荐模板标识，模板类结果常见
resolution	string	推荐分辨率，模板类结果常见
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567905",
  "images": [
    "https://example.com/input.png"
  ],
  "count": 2,
  "prompts": [
    {
      "type": "template",
      "content": "两个人亲吻",
      "prompt": "画面中的两个主体开始转向彼此并拥抱接吻，嘴唇动作自然贴合。",
      "template": "kissing",
      "resolution": "360p"
    },
    {
      "type": "img2video",
      "content": "梦幻海底奇缘"
    }
  ],
  "created_at": "2026-04-16T09:45:00Z"
}

错误码

完整列表请参考客户端 API 错误码。