Vidu Q4 API 参数文档

# Image-to-video: one first frame; the clip keeps the image's aspect ratio (prompt optional)
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-q4",
    "first_frame_url": "https://example.com/astronaut.png",
    "prompt": "The astronaut waves at the camera, then the camera rises to reveal the station",
    "duration": 5,
    "resolution": "1080p"
  }'

# Reference-to-video: 1-15 reference images (+ up to 3 MP3 voice clips); prompt required
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-q4",
    "prompt": "Reference image 1 walks into the cafe from reference image 2, holds up the cup from reference image 3 and says: Morning! Voice from reference audio 1.",
    "reference_image_urls": [
      "https://example.com/character.png",
      "https://example.com/cafe.jpg",
      "https://example.com/cup.png"
    ],
    "reference_audio_urls": ["https://example.com/voice.mp3"],
    "aspect_ratio": "9:16",
    "duration": 8,
    "resolution": "720p"
  }'

# Response (async — a task is created):
# { "code": 200, "msg": "success", "data": { "taskId": "clxxx", "state": "pending" } }

# Poll until completed (result files are kept 30 days)
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
# { "code": 200, "data": { "state": "completed",
#     "resultUrls": ["https://r2.apimodels.app/videos/clxxx.mp4"] } }