XPlor3
Model reference

Vidu Q4

ShengShu's Vidu video model for 3 to 16-second clips up to 4K, from one first frame or up to 15 reference images, with built-in dialogue and sound effects.

PropertyValue
modelSlugvidu-q4
KindVideo
MakerShengShu
Copies per request (variations)1 to 5
How the cost is countedper second of output (from duration), at a rate that depends on mode and resolution
Over MCPyes, with the generate tool

Credit amounts are left out because they change. The lowest price is creditCost on GET /v1/models, and POST /v1/jobs answers with the exact creditCost of a request.

input fields

Send the fields below inside the input object. A field you leave out takes its Default. Unknown field names are dropped without an error, so check the spelling if a setting seems to have no effect.

FieldTypeRequiredDefaultRules
promptstring––Up to 20,000 characters
modestring (one of)–imageimage, reference
imagestring[] (image upload ids)––First frame. One file at most
reference_imagesstring[] (image upload ids)––Reference images. Up to 15 files
reference_audiosstring[] (audio upload ids)––Reference audio. Up to 3 files
aspect_ratiostring (one of)–16:916:9, 9:16, 1:1, 4:3, 3:4
resolutionstring (one of)–720p540p, 720p, 1080p, 2k, 4k
durationinteger–53 to 16
generate_audioboolean–true–

Rules by setting

This model runs a different version depending on what you send. The rules below are checked before any credits move; a request that breaks one is refused with 400 and a message naming the field.

mode = image

  • aspect_ratio is not used; any value sent is ignored.
  • Takes no files in reference_images and reference_audios; a request that fills one is refused.
  • image: required; one file; at most 50 MB per file; JPG, PNG or WebP.

mode = reference

  • Takes no files in image; a request that fills one is refused.
  • reference_images: required; up to 15 files; JPG, PNG or WebP.
  • reference_audios: up to 3 files; at most 50 MB per file; MP3; each clip 3 to 12 seconds long.
  • prompt at least 1 characters.

Example request

POST /v1/jobs
{
  "modelSlug": "vidu-q4",
  "input": {
    "prompt": "The camera circles slowly around a steaming cup of coffee on a wooden table",
    "image": [
      "<upload-id>"
    ]
  }
}

Fill media fields with the id from POST /v1/uploads, not a URL.

On this page