Create Filler Word Removal
Submit a video and return a job id immediately. The job runs asynchronously: it transcribes the audio, detects filler words (‘um’, ‘uh’, …), removes them along with overlong silences, and renders one cleaned video — no review step. If the run changes nothing at all, the job completes with the original video as output and the charge is automatically refunded. Pricing: $0.60 per source minute, 1-minute minimum. Poll GET /v3/filler-word-removals/ or subscribe to filler_word_removal.success / filler_word_removal.fail webhooks.
Authorizations
HeyGen API key. Obtain from your HeyGen dashboard.
Headers
Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 request_in_progress. Keys must be 1–255 characters from [A-Za-z0-9_:.-]; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.
1 - 255^[A-Za-z0-9_\-:.]{1,255}$Body
Request body for POST /v3/filler-word-removals.
Asset input via publicly accessible HTTPS URL.
- AssetUrl
- AssetId
Display title for the job. Defaults to 'Filler Removal' if omitted.
255HTTPS URL to receive per-job webhook callbacks (filler_word_removal.success / filler_word_removal.fail). Delivery is best-effort with limited retries — poll GET /v3/filler-word-removals/{id} as the source of truth (a terminal GET may precede its webhook). Per-job callback_url deliveries are NOT HMAC-signed: authenticate them by verifying TLS and matching the echoed callback_id, and do not trust an unverified body. To receive a signed payload, register a webhook endpoint with a secret via /v3/webhooks/endpoints.
Opaque client identifier echoed verbatim in webhook payloads.
128Response
Accepted — submission acknowledged; poll for completion.
Response for POST /v3/filler-word-removals. Mirrors the v3 single-ID create shape.

