Prompt Recommendation


POST https://api.vidu.cn/ent/v2/img2video-prompt-recommendation

Request Headers

Field	Value	Description
Content-Type	application/json	Data exchange format
Authorization	Token {your api key}	Replace {token} with your token

Request Body

Parameter	Type	Required	Description
images	Array[String]	Yes	Input image(s) - Currently supports only one image - Supports Base64 or accessible image URL - Formats: JPG / PNG / WEBP - Max size: 50MB
type	Array[String]	Yes	Prompt recommendation type(s) Enum values: template , img2video You may pass both types together
resolution	String	Optional	Target output resolution Default: 360p Enum: 360p - Only applicable when different templates support different resolutions
count	Int	Optional	Number of recommended prompts to return Default: 5 Range: 1~10 If type=["img2video", "template"] and count=5, you will receive 10 prompts (5 for each type)


curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
    "images": ["your_image_url"],
    "type": ["img2video"，"template"],
    "count": "5"
}' https://api.vidu.com/ent/v2/img2video-prompt-recommendation

Response Body

Field	Subfield	Type	Description
task_id		String	Unique task ID generated by Vidu
images		Array[String]	The image(s) submitted for this request
count		Int	Number of prompts requested
prompts		Array	List of recommended prompts (structure detailed below)
	type	String	Prompt type: template or img2video
	content	String	Recommendation prompts
	prompt	String	Actual API prompt to call (only for type=template)
	template	String	Template enum value (only for type=template)
	resolution	String	Recommended resolution (only for type=template)
created_at		String	Timestamp of task creation

Example Response:


{
  "id": "your_task_id",
  "images": ["your_input_images"],
  "count": 2,
  "prompts": [
    {
      "type": "template",
      "content": "Two people kissing",
      "prompt": "Video content\\nThe two subjects in the frame turn toward each other and begin to kiss, creating a romantic atmosphere.\\n# Requirements\\n1. Lips must touch and move naturally.\\n2. Set Motion Level to 'Large'.",
      "template": "kissing",
      "resolution": "360p"
    },
    {
      "type": "template",
      "content": "Dragon Boat Festival: Racing together",
      "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": "Magical Undersea Adventure"
    },
    {
      "type": "img2video",
      "content": "A Cute Little Puppy"
    }
  ],
  "created_at": "string"
}