mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-15 13:58:20 +00:00
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:
@@ -46,7 +46,7 @@
|
||||
"files": 10
|
||||
},
|
||||
"media-use": {
|
||||
"hash": "ea061d942d97f2c2",
|
||||
"hash": "7a51f53cf615fe97",
|
||||
"files": 124
|
||||
},
|
||||
"motion-graphics": {
|
||||
|
||||
@@ -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.",
|
||||
|
||||
Reference in New Issue
Block a user