VPro Video · Video

Reference to VideoNEW

📌 What is this：Generate a new video based on the subjects / style in reference images (some models also accept a reference video).

💡 When to use：Use to put a given character, product or style into a new scene. Reference materials cannot be combined with first/last frames.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/vpro
Query Result	GET	/api/cqt/info/vpro?id={taskId}

⏱ Recommended polling interval：Generation takes ~1-3 min; poll every 10-15s until status = succeeded / failed.

Sub-models

Sub-models that support this mode. The tiers column is credits/sec (generateAudio → = audio tier, videoUrls → = with-reference-video tier). Resolutions / durations not listed are rejected at submit (no charge).

model	Usage	Materials	Duration (sec)	Tier price (credits/sec)
minimax-h3-v	MiniMax H3 V; from 480P, cheapest; first 5 reference images free	≤7 reference images (first 5 free, then +15 credits each)	4~15	480P=29.7 / 720P=37.5 / 1080P=50 / 2K=62.5 / 4K=75
seedance-2.0	Seedance 2.0; quality first	≤7 reference images	4~15	720P=79.5 / 1080P=173 / 2K=430 / 4K=490
seedance-2.0-fast	Seedance 2.0 Fast; faster and cheaper	≤7 reference images	4~15	720P=64.5 / 1080P=140 / 2K=154 / 4K=169.4
seedance-2.5	Seedance 2.5; up to 30 s	≤7 reference images	4~30	720P=118.8 / 1080P=258.7 / 2K=637 / 4K=700.7

Request Parameters

Param	Type	Required	Description
model	string	Required	Sub-model: minimax-h3-v / seedance-2.0 / seedance-2.0-fast / seedance-2.5 (see the sub-model table below)
prompt	string	—	Video description (optional; materials can drive generation)
imageUrls	array	—	Reference image URL array (≤7, publicly reachable); send at least one of imageUrls / videoUrls
negativePrompt	string	—	Negative prompt (optional)
duration	integer	—	Duration (sec), range depends on the sub-model (see table), default 5
resolution	string	—	540P / 720P / 1080P / 2K / 4K (available tiers depend on the sub-model), default 720P (or the lowest tier if 720P is unavailable); 2K / 4K are upscaled
aspectRatio	string	—	Aspect ratio, e.g. 16:9 / 9:16 / 1:1
enhancePrompt	boolean	—	Whether to auto-enhance the prompt (optional)
seed	integer	—	Random seed (optional)
returnFirstFrame / returnLastFrame / returnFrameAtSecond	boolean / boolean / number	—	Also return the first / last / given-second frame image of the result video (optional), 1 credit per frame

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/vpro \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0",
    "prompt": "the red vintage car from the reference image drifts around a corner on a wet neon street at night, cinematic",
    "duration": 4,
    "resolution": "720P",
    "aspectRatio": "16:9",
    "imageUrls": [
      "https://cdn.novapi.ai/seedream/1791950778488_c22c4d053b2a41fbb28193cd319473b1.jpg"
    ]
  }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "c489b6d0384c467baa7ff9a3e7a81f95",
    "resultUrl": "https://cdn.novapi.ai/vega/1791952678122_a779677a9d944c02b20a37f065c6a03d.mp4",
    "status": "succeeded",
    "errorMsg": null,
    "createTime": "2026-10-14 12:33:37",
    "completeTime": "2026-10-14 12:37:59"
  }
}

Response Fields

Field	Type	Description
code	number	Status code; 200 means success
msg	string	Status message; "success" on success
data.id	string	Task ID (taskId); use it to poll GET /api/cqt/info
data.status	string	Task status: succeeded / failed / otherwise still processing
data.resultUrl	string	URL of the generated video; returned when status = succeeded, null otherwise
data.errorMsg	string \| null	Failure reason; null on success
data.createTime	string	Task creation time
data.completeTime	string \| null	Task completion time; null until finished