video

Check Heygen Avatar Video

Check the status of a HeyGen avatar video generation task (single check)

This endpoint:

  1. Retrieves the task from the database
  2. Checks the current status with HeyGen API (single check, no polling)
  3. Updates the task status based on the response
  4. Returns video URLs (video_url, thumbnail_url, video_url_caption) when completed

Args: task_id: The internal task ID (UUID) returned from the create endpoint

Returns: dict with status and data: - status: "In Progress", "Done", or "Error" - data: Contains video_url, thumbnail_url, video_url_caption when completed

Note: This endpoint checks the status once and returns immediately. The client should poll this endpoint if they need to wait for completion.

get/api/v1/video/check-heygen-avatar-video/{task_id}

Request

  • Base URL
    https://api.brandbooster.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.brandbooster.ai/api/v1/video/check-heygen-avatar-video/{task_id}
  • Auth
    HTTP bearer

Path parameters

task_idstring required

Response

Successful Response

unknown required

Changes

No operation changes recorded.