Vidu Q4 Image to Video

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "vidu/q4/image-to-video",
  "input": {
    "image_urls": [
      "https://example.com/still.png"
    ],
    "prompt": "The lantern flickers as the girl looks up and snow starts to fall, slow push-in",
    "duration": 5,
    "resolution": "720p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "vidu/q4/image-to-video",
  "input": {
    "image_urls": [
      "https://example.com/still.png"
    ],
    "prompt": "The lantern flickers as the girl looks up and snow starts to fall, slow push-in",
    "duration": 5,
    "resolution": "720p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Vidu Q4 Image to Video animates one still image into a 3–16 second video, from fast 540p drafts up to 4K. The image becomes the first frame and fixes the framing, so the output keeps the image’s aspect ratio. Use it to bring illustrations, product stills or key visuals to life. Vidu Q4 is ShengShu Technology’s video model, released upstream as Vidu Q4 Preview in October 2026. It has no text-to-video mode: every request starts from images. Vidgo exposes two model IDs: Image to Video and Reference to Video.

Models

vidu/q4/image-to-video — Image-to-video with Vidu Q4 from one start frame, 3–16 seconds, 540p to 4K.

Features

Image-to-video from a single start frame.
Optional prompt to direct motion and camera movement.
Integer durations from 3 to 16 seconds.
Five resolutions: 540p, 720p, 1080p, 2k and 4k.
Aspect ratio follows the input image.

Required parameters

image_urls (string[]): Exactly one public HTTP(S) image URL. It is used as the first frame.

Optional parameters

prompt (string): What moves, how the camera moves and the mood. Up to 5,000 characters. Default empty.
duration (integer): Output length in seconds, 3–16. Default 5.
resolution (string): 540p, 720p, 1080p, 2k or 4k (case-insensitive). Default 720p.
enable_safety_checker (boolean): Turn the upstream safety checker on or off.

Resolution

`resolution`	Use it for
`540p`	Fast, low-cost drafts
`720p`	Default; social and web clips
`1080p`	Full HD delivery
`2k`	High-resolution masters
`4k`	Hero shots and large screens

The resolution sets the per-second billing rate.

Output

The finished task returns one MP4 video in the files array of Query Task Status and the callback payload.

Examples

5-second 720p animation: one illustration plus a short motion prompt at the default settings.
10-second 4K hero shot with callback: a key visual animated at 4k for large screens, with a callback_url.

Notes

Image-to-video does not generate audio on this ID and does not take aspect_ratio, generate_audio, reference_image_urls or reference_audio_urls; sending them returns 400. For multi-image references, voice references or native audio, use Vidu Q4 Reference to Video.
Vidu Q4 has no text-to-video mode. Every request needs an image.
model and callback_url belong at the request root, not inside input.
Credits are reserved at submission and depend on resolution and duration (per output second). Reference images, reference audio and generate_audio do not change the rate. A failed task is refunded in full. See the pricing page for current rates.

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication

Get your API Key:

Go to Dashboard → API Key (API Key Management Page) to get your API Key

Add it to the request header:

Authorization: Bearer VIDGO_API_KEY

Body

application/json

model

string

required

Model ID. Use vidu/q4/image-to-video.

Example:

"vidu/q4/image-to-video"

input

object

required

Generation parameters.

Show child attributes

callback_url

string<uri> | null

Optional public HTTP(S) endpoint that receives a POST when the task becomes finished or failed. HTTPS is recommended. Omit it, or send null or an empty string, to disable callbacks.

Example:

"https://your-domain.com/callback"

Response

Task submitted

code

enum<integer>

required

HTTP status code.

Available options:

200

data

object

required

Show child attributes

​Models

​Features

​Required parameters

​Optional parameters

​Resolution

​Output

​Examples

​Notes

Authorizations

Body

Response

Models

Features

Required parameters

Optional parameters

Resolution

Output

Examples

Notes