Once processing completes, retrieve your clips either through periodic polling or automated webhook notifications.

• Polling: Continuously check project status until clips are ready.
• Webhook: Receive automatic notifications to your server.

Polling Clips

After submitting a long video for clipping, you can retrieve the generated short clips by polling the project using the projectId. Each clip includes its title, download URL, transcript, related topics, and an AI-generated viral score and reason.

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