Discussions

Ask a Question
Back to all

Which endpoint should be used to retrieve video status for generated videos

Hello, I’m using the HeyGen API to create talking photo videos.
The video creation request (POST /v2/video/generate) succeeds and returns a valid video_id,
but when I query the status endpoint, it always returns 404 Not Found — even after several minutes.

Here are the details:

Account plan: Creator (1080p support)

API key: (valid, tested with /v2/avatars)

Talking photo ID: 951c3dcf837c4264a5a9d549e68d8e12

Sample video_id returned: bc817499034040f78b76248c23807aa2

Endpoints tried:

GET https://api.heygen.com/v2/videos/{video_id}

GET https://api.heygen.com/v3/videos/{video_id}
Both return 404.

Request audio_url: A public Dropbox link (ending with ?dl=1)

Error log sample:

[status] 아직 등록 안됨(404). 재시도… (1/40)
[status] 아직 등록 안됨(404). 재시도… (20/40)
RuntimeError: 상태 조회용 엔드포인트를 찾지 못했습니다. (모든 후보 404)

The same API key works fine with /v2/avatars, so authentication seems OK.

The generated video briefly appears in the HeyGen dashboard under “Projects,” but shows an Error or “URL invalid” message.

Can you please confirm:

Which endpoint should be used to retrieve video status for generated videos (is /v2/videos/{id} still valid)?

Are there any additional permissions or restrictions for Creator plan accounts using talking_photo + external audio_url?

Could my account be missing API access to the correct video status endpoint?

Thank you for your help — I’ve been testing for several days and would really appreciate your clarification.

Best regards,