VIvivideo
Videos

Render a free preview after upgrading

Renders a status: "preview" video for real once the account is premium. The first video after upgrading is free (comped); later renders charge the normal credit price. Idempotent — if the video is already rendering or done, the current state is returned without a second charge.

post/v1/videos/{video_id}/render

Request

Path parameters

video_idstring required

Response

Render started (or current state if already rendered).

idstring
objectstring
mode'auto' | 'manual'
modelstring
status'queued' | 'processing' | 'completed' | 'failed' | 'preview'
namestring
folder_idstring
created_atstring
credits_chargednumber
poll_interval_secondsinteger
video_urlstring

Present when status=completed.

video_url_no_captionsstring
caption_urlstring
thumbnail_urlstring
duration_secondsnumber

Example response

{
  "object": "video",
  "model": "veo31_fast",
  "poll_interval_seconds": 5,
  "error": {
    "code": "generation_failed"
  },
  "preview": {
    "upgrade_url": "https://app.vivideo.ai/upgrade"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.