No Read me document is available for this model yet.

Vidu Q4 Preview
Vidu Q4 Preview
- 99.9% SLA
- Official Discounts
- Pay-as-you-go
- Fast & Low Latency
Brand:
Price: From $0.056 / sec
API DOCS / SIMPLIFIED
Integrate this model with one task-based API flow
Vidu Q4 Preview The examples below are rendered from Vidu Q4 Preview, the current gateway base URL, and the selected public model contract.
Input mode
X-API-Key on every request
POST /api/v1/openapi/task
GET /api/v1/openapi/task/status/{task_id}
Async task workflow
Single code window
Switch language once. Each example already includes both the task creation request and the task status polling request.
Unified Example
API_KEY="<API_KEY>"
BASE_URL="https://api.musespark.ai"
REQUEST_BODY='{
"model_id": "vidu-q4-preview",
"parameters": {
"prompt": "A cinematic drone shot over a futuristic city at sunrise, volumetric light, realistic motion",
"images": [
"<IMAGE_URL>"
],
"generation_type": "frame",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9",
"batch_size": 1
}
}'
CREATE_RESPONSE=$(curl --request POST "$BASE_URL/api/v1/openapi/task" \
--header "X-API-Key: $API_KEY" \
--header "Content-Type: application/json" \
--data-raw "$REQUEST_BODY")
TASK_ID="<TASK_ID_FROM_CREATE_RESPONSE>"
curl "$BASE_URL/api/v1/openapi/task/status/$TASK_ID" \
--header "X-API-Key: $API_KEY"Request and response JSON become the documentation
Keep the payload and task status envelope as the primary contract. Field descriptions, optionality, and enum hints now live inline as JSON comments.
Request Body
Caller payload
This is the request envelope accepted by the public gateway for the selected model contract.
Field comments and caller parameters come directly from the current item's model schema.
{ "model_id": "vidu-q4-preview",// target model "parameters": { "prompt": "A cinematic drone shot over a futuristic city at sunrise, volumetric light, realistic motion",// optional for image-to-video generation; required for reference mode. Maximum 20,000 characters · max 20000 · max length 20000 "images": [// provide one first-frame image in Frame mode, or 1-15 reference images in Reference mode. The total image limit is 15 · min 1 · max 1 · min items 1 · max items 1 · accept image/* "<IMAGE_URL>" ], "generation_type": "frame",// enum: frame "resolution": "720p",// default 720p · enum: 540p | 540P | 720p | 720P | 1080p | 1080P | 2K | 2k | 4K | 4k "duration": 5,// output seconds; default 5 · min 3 · max 16 "aspect_ratio": "16:9",// output aspect ratio for reference generation. First-frame generation follows the source image aspect ratio · enum: 1:1 | 9:16 | 16:9 | 3:4 | 4:3 "batch_size": 1// museSpark batch count; each child task requests one provider output · min 1 · max 15 }}Response Body
Gateway response
This is the task status response you will query with task_id until the task reaches a terminal state.
Poll every 2-5 seconds and stop once status becomes completed, failed, cancelled.
{ "code": 200,// 200 on success "msg": "success", "data": { "task_id": "task_01HQX8N2QJ0YQ8Q0T7G6N4V6K2",// use for status polling "status": "completed",// enum: queued | running | completed | failed | cancelled "progress": 100,// 0-100 if available "completed_at": 1760000000,// unix timestamp "expires_at": 1760001800,// unix timestamp "result": { "output_urls": [// generated files "https://cdn.example.com/output.png" ] } }}Why Choose MuseSpark?
| Model & Modality | Credits / sec | Our Price (USD) / sec |
|---|---|---|
| 540PResolution: 540p / 720p / 1080p / 2K / 4K · Any of: Resolution: 540p or Resolution: 540p · Duration: Provided | 5.6 credits / sec | $0.056 / sec |
| 720PResolution: 540p / 720p / 1080p / 2K / 4K · Any of: Resolution: 720p or Resolution: 720p · Duration: Provided | 11.4 credits / sec | $0.114 / sec |
| 1080PResolution: 540p / 720p / 1080p / 2K / 4K · Any of: Resolution: 1080p or Resolution: 1080p · Duration: Provided | 12.8 credits / sec | $0.128 / sec |
| 2KResolution: 540p / 720p / 1080p / 2K / 4K · Any of: Resolution: 2K or Resolution: 2K · Duration: Provided | 20.3 credits / sec | $0.203 / sec |
| 4KResolution: 540p / 720p / 1080p / 2K / 4K · Any of: Resolution: 4K or Resolution: 4K · Duration: Provided | 41.6 credits / sec | $0.416 / sec |
Examples
No examples yet.
FAQ
No FAQs are available for this item yet.



