推荐提示词接口

当前页面

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token {your api key}	将 {your api key} 替换为您的 token

字段

值

描述

Content-Type

application/json

数据交换格式

Authorization

Token {your api key}

将 {your api key} 替换为您的 token

参数名称	类型	必填	参数描述
images	Array[String]	是	输入图片 - 当前仅支持一张图片 - 支持传入 Base64 编码或图片 URL（需确保可以访问） - 支持 JPG/PNG/WEBP - 图片大小不超过 50 MB
type	Array[String]	是	推荐提示词类型可选枚举值：template(特效）、img2video（图生视频）、start_end2video（首尾帧）、e_commerce（参考生视频-电商场景），也可以两个参数一起传
resolution	String	可选	目标分辨率默认：360p 可选枚举值：360p，720p - 该参数仅适用于输出不同 template 模版支持的分辨率不同
count	Int	可选	返回推荐提示词的数量默认值为 5，支持范围：1~10 当type=["img2video"，"template"]，如count=5，会输出10个prompt。即img2video和template各5条

参数名称

类型

必填

参数描述

images

Array[String]

是

输入图片
- 当前仅支持一张图片
- 支持传入 Base64 编码或图片 URL（需确保可以访问）
- 支持 JPG/PNG/WEBP
- 图片大小不超过 50 MB

type

Array[String]

是

推荐提示词类型
可选枚举值：template(特效）、img2video（图生视频）、start_end2video（首尾帧）、e_commerce（参考生视频-电商场景），也可以两个参数一起传

resolution

String

可选

目标分辨率
默认：360p
可选枚举值：360p，720p
- 该参数仅适用于输出不同 template 模版支持的分辨率不同

count

Int

可选

返回推荐提示词的数量
默认值为 5，支持范围：1~10
当type=["img2video"，"template"]，如count=5，会输出10个prompt。即img2video和template各5条

字段	子字段	类型	描述
task_id		String	Vidu 生成的任务ID
images		Array[String]	本次调用的图像参数
count		Int	本次调用的推荐提示词的数量参数
prompts		Array	提示词推荐结果（结构如下）
	type	String	template(特效）、img2video（图生视频）
	content	String	推荐的提示词文本，适用于给用户展示
	prompt	String	实际调用的提示词文本仅当type=template时返回
	template	String	推荐提示词所关联的模板枚举值仅当 type=template 时返回
	resolution	String	推荐输出分辨率仅当 type=template 时返回
created_at		String	任务创建时间

字段

子字段

类型

描述

task_id

String

Vidu 生成的任务ID

images

Array[String]

本次调用的图像参数

count

Int

本次调用的推荐提示词的数量参数

prompts

Array

提示词推荐结果（结构如下）

type

String

template(特效）、img2video（图生视频）

content

String

推荐的提示词文本，适用于给用户展示

prompt

String

实际调用的提示词文本
仅当type=template时返回

template

String

推荐提示词所关联的模板枚举值
仅当 type=template 时返回

resolution

String

推荐输出分辨率
仅当 type=template 时返回

created_at

String

任务创建时间

{
  "id": "your_task_id",
  "images": ["your_input_images"],
  "count": 2,
  "prompts": [
    {
      "type": "template",
      "content": "两个人亲吻",
      "prompt": "视频内容\\n画面中的两个主体开始转向彼此，开始接吻，画面呈现充满爱意的氛围。\\n# 要求\\n1.亲吻时候，嘴唇的动作要彼此贴合。\\n2.将Motion Level的值设置为“Large”."
      "template": "kissing",
      "resolution": "360p"
    },
    {
        "type": "template",
        "content": "端午节，一起赛龙舟",
        "prompt": "The characters open their mouths and laugh happily, eyes blinking softly and naturally. \nThe hand holding the instant photo remains rigidly fixed in a stable position, ensuring the photo stays centered  within the frame at all times.\nThe unauthorized appearance of other characters is strictly prohibited."
        "template": "dragonboat_shot",
        "resolution": "360p"
      },
      {
        "type": "img2video",
        "content": "梦幻海底奇缘"
      },
      {
        "type": "img2video",
        "content": "一只可爱的小狗"
      }
  ],
  "created_at": "2025-01-01T10:00:00.000Z"
}

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token {your api key}	将 {your api key} 替换为您的 token

字段

值

描述

Content-Type

application/json

数据交换格式

Authorization

Token {your api key}

将 {your api key} 替换为您的 token

参数名称	类型	必填	参数描述
images	Array[String]	是	输入图片 - 当前仅支持一张图片 - 支持传入 Base64 编码或图片 URL（需确保可以访问） - 支持 JPG/PNG/WEBP - 图片大小不超过 50 MB
type	Array[String]	是	推荐提示词类型可选枚举值：template(特效）、img2video（图生视频）、start_end2video（首尾帧）、e_commerce（参考生视频-电商场景），也可以两个参数一起传
resolution	String	可选	目标分辨率默认：360p 可选枚举值：360p，720p - 该参数仅适用于输出不同 template 模版支持的分辨率不同
count	Int	可选	返回推荐提示词的数量默认值为 5，支持范围：1~10 当type=["img2video"，"template"]，如count=5，会输出10个prompt。即img2video和template各5条

参数名称

类型

必填

参数描述

images

Array[String]

是

输入图片
- 当前仅支持一张图片
- 支持传入 Base64 编码或图片 URL（需确保可以访问）
- 支持 JPG/PNG/WEBP
- 图片大小不超过 50 MB

type

Array[String]

是

推荐提示词类型
可选枚举值：template(特效）、img2video（图生视频）、start_end2video（首尾帧）、e_commerce（参考生视频-电商场景），也可以两个参数一起传

resolution

String

可选

目标分辨率
默认：360p
可选枚举值：360p，720p
- 该参数仅适用于输出不同 template 模版支持的分辨率不同

count

Int

可选

返回推荐提示词的数量
默认值为 5，支持范围：1~10
当type=["img2video"，"template"]，如count=5，会输出10个prompt。即img2video和template各5条

字段	子字段	类型	描述
task_id		String	Vidu 生成的任务ID
images		Array[String]	本次调用的图像参数
count		Int	本次调用的推荐提示词的数量参数
prompts		Array	提示词推荐结果（结构如下）
	type	String	template(特效）、img2video（图生视频）
	content	String	推荐的提示词文本，适用于给用户展示
	prompt	String	实际调用的提示词文本仅当type=template时返回
	template	String	推荐提示词所关联的模板枚举值仅当 type=template 时返回
	resolution	String	推荐输出分辨率仅当 type=template 时返回
created_at		String	任务创建时间

字段

子字段

类型

描述

task_id

String

Vidu 生成的任务ID

images

Array[String]

本次调用的图像参数

count

Int

本次调用的推荐提示词的数量参数

prompts

Array

提示词推荐结果（结构如下）

type

String

template(特效）、img2video（图生视频）

content

String

推荐的提示词文本，适用于给用户展示

prompt

String

实际调用的提示词文本
仅当type=template时返回

template

String

推荐提示词所关联的模板枚举值
仅当 type=template 时返回

resolution

String

推荐输出分辨率
仅当 type=template 时返回

created_at

String

任务创建时间

{
  "id": "your_task_id",
  "images": ["your_input_images"],
  "count": 2,
  "prompts": [
    {
      "type": "template",
      "content": "两个人亲吻",
      "prompt": "视频内容\\n画面中的两个主体开始转向彼此，开始接吻，画面呈现充满爱意的氛围。\\n# 要求\\n1.亲吻时候，嘴唇的动作要彼此贴合。\\n2.将Motion Level的值设置为“Large”."
      "template": "kissing",
      "resolution": "360p"
    },
    {
        "type": "template",
        "content": "端午节，一起赛龙舟",
        "prompt": "The characters open their mouths and laugh happily, eyes blinking softly and naturally. \nThe hand holding the instant photo remains rigidly fixed in a stable position, ensuring the photo stays centered  within the frame at all times.\nThe unauthorized appearance of other characters is strictly prohibited."
        "template": "dragonboat_shot",
        "resolution": "360p"
      },
      {
        "type": "img2video",
        "content": "梦幻海底奇缘"
      },
      {
        "type": "img2video",
        "content": "一只可爱的小狗"
      }
  ],
  "created_at": "2025-01-01T10:00:00.000Z"
}

接口文档

接口文档

创建其他任务

创建其他任务