fix(media-use): tag avatar-video heygen recipes with X-HeyGen-Client-Source (#2391)

The agent-driven video recipes (heygen video create) went out untagged, so
media-use avatar / image-to-video usage landed as generic cli traffic and
wasn't attributable to media-use. Add --headers "X-HeyGen-Client-Source:
media-use" to the generating recipes (persistent flag, allowlisted by the
CLI) so those videos carry client_source in master_video_table meta and show
up in the API dashboards alongside the TTS path (#2365) and CLI (#2368).
This commit is contained in:
Miguel Ángel
2026-07-13 22:43:58 -04:00
committed by GitHub
parent 852d1891d3
commit ca7c017e49
2 changed files with 9 additions and 4 deletions
+1 -1
View File
@@ -46,7 +46,7 @@
"files": 10
},
"media-use": {
"hash": "ea061d942d97f2c2",
"hash": "7a51f53cf615fe97",
"files": 124
},
"motion-graphics": {
+8 -3
View File
@@ -209,13 +209,18 @@ avatar upsell (decision X3).
raw API. For a talking-head / avatar video, `heygen video create` (avatar
engine IV by default) beats a generative clip when you want a real presenter.
Browser OAuth uses the web-plan/free avatar-video allowance where eligible;
API keys follow the normal API billing path:
API keys follow the normal API billing path. Always pass
`--headers "X-HeyGen-Client-Source: media-use"` on any generating `heygen`
command (`video create`, `avatar create`, `video-translate`) — it's the
allowlisted attribution header (persistent flag, works on every subcommand) that
tags the usage as media-use in billing/resource meta so it shows up in the API
dashboards. Read-only discovery (`avatar list`, `voice list`) doesn't need it.
```bash
# discover an avatar + a starfish voice, then create + wait
heygen avatar list --ownership public --limit 5
heygen voice list --engine starfish --limit 5
heygen video create --wait -d '{
heygen video create --headers "X-HeyGen-Client-Source: media-use" --wait -d '{
"type": "avatar",
"avatar_id": "<avatar-id>",
"script": "Your narration here.",
@@ -236,7 +241,7 @@ public URL or an uploaded `asset_id`, and drive speech with a `script`+`voice_id
or a pre-recorded `audio_url`:
```bash
heygen video create --wait -d '{
heygen video create --headers "X-HeyGen-Client-Source: media-use" --wait -d '{
"type": "image",
"image": { "type": "url", "url": "https://example.com/person.jpg" },
"script": "Your narration here.",