Discussions
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,