Subjects

Replace <YOUR_API_KEY> with the token provided to you

Subject name (recommended to be unique)

• Subject images; at least 1 subject image is required
• Note 1: Accepts Base64-encoded images or image URLs (must be accessible);
• Note 2: Up to 3 images are supported;
• Note 3: Supported image formats: png, jpeg, jpg, webp;
• Note 4: Image aspect ratio must be within 1:4 to 4:1;
• Note 5: The decoded Base64 byte length must be less than 20MB, and the encoding must include an appropriate content-type string, for example:
• data:image/png;base64,{base64_encode}

• Video reference; supports uploading 1 subject video
• Note 1: Video subjects are only supported by the viduq2-pro model for reference-to-video
• Note 2: Up to 1 video of 5 seconds is supported
  Note 3: Supported video formats: mp4, avi, mov
  Note 4: Video resolution must be at least 128\*128, and the aspect ratio must be within 1:4 to 4:1
  Note 5: The decoded Base64 byte length must be less than 20MB, and the encoding must include an appropriate content-type string, for example:
• data:video/mp4;base64,{base64_encode}

• Subject voice ID; only used when creating audio-video generation tasks
• Note 1: If no voice ID is provided for an audio-video generation task, the system will recommend a voice automatically
• Note 2: q2-pro and q3、q4 series models do not support voice IDs

Replace <YOUR_API_KEY> with the token provided to you

• Subject ownership. Enum values:
  • system: official subjects
  • private: personal subjects (default)

Query by specific subject IDs; multiple IDs are supported

Number of results; default 20, maximum 100

Can be left empty on the first request. If there are more pages, a next_page_token is returned; use it to request the next page

Replace <YOUR_API_KEY> with the token provided to you

Subject ID generated by Vidu (server_id)

New subject name, up to 64 characters

• Subject images; directly overwrites the original subject images
• Note 1: Accepts Base64-encoded images or image URLs (must be accessible);
• Note 2: Up to 3 images are supported;
• Note 3: Supported image formats: png, jpeg, jpg, webp;
• Note 4: Image aspect ratio must be within 1:4 to 4:1;
• Note 5: The decoded Base64 byte length must be less than 20MB, and the encoding must include an appropriate content-type string, for example:
• data:image/png;base64,{base64_encode}

• Video reference; supports uploading 1 subject video. Directly overwrites the original subject video; if both images and video are present, only the video takes effect
• Note 1: This parameter only applies to subjects that were created with a reference video
• Note 2: Video subjects are only supported by the viduq2-pro model for reference-to-video
• Note 3: Up to 1 video of 5 seconds is supported
• Note 4: Supported video formats: mp4, avi, mov
• Note 5: Video resolution must be at least 128*128, and the aspect ratio must be within 1:4 to 4:1
• Note 6: The decoded Base64 byte length must be less than 20MB, and the encoding must include an appropriate content-type string, for example:
• data:video/mp4;base64,{base64_encode}

New subject style description, up to 100 characters

New detailed subject description, up to 2000 characters

• New subject voice ID