Authentication
authorization string required
All APIs require authentication via Bearer Token.
Get API Key:
Visit API Key Management Page to get your API Key.
Usage:
Add to request header:
Authorization: Bearer YOUR_API_KEY
Parameters
model string required
Customer-facing model ID used for the request.
Value: vidu-cn-img2video-prompt-recommendation
images array[string] required
Input image URLs or supported Base64 data URIs.
type string
Prompt recommendation type. Use the image-to-video type for I2V workflows.
count integer
Number of prompts to return.
Synchronous Response
This is a synchronous endpoint. On success, the result is returned directly in the create response.
Response Format
error object
Error information, only present when status is failed.
code
stringError code
message
stringDetailed error message
output array
Generation results, present when the request succeeds.
content
arrayList of generated resource content
type
stringResource type.
Value:
texturl
stringGenerated resource URL when the result is a media file.
text
stringRecommended prompt text when the result is text.
jobId
stringUpstream task ID.
usage object
Usage statistics, present when the request succeeds.
cost
stringTotal cost in USD.
discount
numberDiscount amount.
metadata object
Metadata information.