Once your project finishes processing, you can retrieve the output videos — whether they were generated in Clipping Mode (multiple short clips extracted from a long video) or Editing Mode (send a short video for clipping).

You can access finished results in two ways:

• Polling: Periodically check project status until output videos are ready.
• Webhook: Have Vizard automatically notify your server when processing completes.

Both modes use the same retrieval API endpoint and return structure. The only difference is:

• Clipping Mode → the videos array will contain multiple clips
• Editing Mode → the videos array will typically contain a single edited video

Polling Output Videos

After submitting a video (for either editing or clipping), you can retrieve the generated output by polling the project using the projectId returned during submission.

Each output includes:

• Video download URL
• Video duration
• Transcript (if available)
• Title (AI-generated or inherited)
• Additional metadata such as viral score (Clipping Mode only)

Example Request

curl -X GET "https://elb-api.vizard.ai/hvizard-server-front/open-api/v1/project/query/{projectId}" \
     -H "VIZARDAI_API_KEY: YOUR_API_KEY"

Please replace parameter projectId in request URL with the actual projectId returned in previous step.

Example Response

{
  "code": 2000,
  "shareLink": "https://vizard.ai/project?invite=BW77vF&susId=1862&utm_source=project_share&utm_medium=project_share_email&utm_campaign=project_share_email",
  "videos": [
    {
      "videoId": 14015572,
      "videoUrl": "https://cdn-video.vizard.ai/vizard/video/export/...",
      "videoMsDuration": 80400,
      "title": "Transform Content Creation with Spark 1.0's AI Video Editing",
      "transcript": "Hi, we're here with Vizard...",
      "viralScore": "10",
      "viralReason": "This clip leverages the appeal of AI technology...",
      "relatedTopic": "[]",
      "clipEditorUrl": "https://vizard.ai/editor?id=99058552&type=clip"
    },
    ...
  ],
    "projectId": 17861706,
    "projectName" : "My first project"
}

Top-level Fields

videos Object Fields

⚠️ videoUrl is a temporary download link for the clip, valid for 7 days. If it expires, simply re-query the API to obtain a new link.

Retry Behavior

If your video is still processing, the videos array may be empty. Poll the endpoint again after a few seconds. You can safely retry every 30 seconds until clips appear.

Common Status Codes