mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-10 22:20:14 +00:00
Miguel Ángel
0a66671fc5
* fix(media-use): tag HeyGen TTS generation with attribution header
Centralizes the X-HeyGen-Client-Source header into HEYGEN_CLIENT_SOURCE_ARGV
in heygen-cli.mjs and reuses it in heygen-search.mjs (dropping the duplicated
inline literal) so voice-provider's `voice speech create` call carries it too.
The generation call was previously untagged, making media-use TTS usage
invisible in HeyGen's billing/analytics warehouse; the read-only `voice list`
discovery call intentionally stays untagged.
* feat(media-use): add local LTX video generate provider
* feat(media-use): add HeyGen avatar-video generate provider
* feat(media-use): register video as a real provider type
* docs(media-use): document the wired video type and full HeyGen tagging coverage
resolve --type video is now the default path (HeyGen avatar video first,
local LTX fallback, sign-in nudge on auth failure) instead of a manual
recipe; correct the claim that only search requests are tagged now that
TTS and avatar-video generation carry the attribution header too.
* fix(media-use): wire --avatar-id/--voice-id CLI flags and close video-provider auth/cache gaps
- resolve.mjs never implemented the --avatar-id/--voice-id override that
operations.md documented, so following the docs crashed with
ERR_PARSE_ARGS_UNKNOWN_OPTION; wire the flags through to ctx.
- defaultAvatarId/defaultStarfishVoiceId cached a failed discovery lookup
as a permanent null, disabling heygen.video after one transient miss;
cache only a truthy id, matching the same fix in voice-provider.mjs's
defaultVoiceId.
- the avatar-video onboarding nudge only fired on a video-create failure,
never when avatar/voice discovery itself was unauthenticated (the
common unauthenticated case) -- propagate the discovery failure reason
so onboarding fires either way.
- dedupe the CLI-shelling JSON helper (heygen-cli.mjs's new runHeygenJson)
and the local-model argv-template builder (local-models.mjs's new
buildArgv) instead of leaving byte-identical copies in each provider.
* fix(media-use): address avatar-video PR review feedback
- heygenVideoGenerate short-circuits after the first discovery-call
failure instead of always attempting both avatar list and voice list,
so an unauthenticated caller gets one onboarding message and one
provider-error telemetry ping instead of a double-fire.
- runHeygenJson logs a diagnostic when a CLI call succeeds but returns
unparseable JSON, instead of silently returning null.
- dedupe the "avatar video is free" onboarding string into one constant
(was duplicated across three call sites).
* fix(media-use): match review-requested naming and message conventions
- export AVATAR_VIDEO_SIGNIN_MESSAGE from heygen-video-provider.mjs so
the test imports the canonical string instead of redeclaring it.
- runHeygenJson's non-JSON diagnostic now matches heygen-search.mjs's
existing wording ("returned non-JSON output").
71 lines
1.9 KiB
JavaScript
71 lines
1.9 KiB
JavaScript
import { execFileSync } from "node:child_process";
|
|
import { existsSync } from "node:fs";
|
|
import { tmpdir } from "node:os";
|
|
import { join } from "node:path";
|
|
import { probeSpecs } from "./specs.mjs";
|
|
import { buildArgv, selectModel } from "./local-models.mjs";
|
|
|
|
export async function ltxVideoGenerate(
|
|
intent,
|
|
ctx,
|
|
execFn = execFileSync,
|
|
pathExists = existsSync,
|
|
) {
|
|
const specs = ctx?.specs || probeSpecs();
|
|
const sel = selectModel("videogen", specs, { preferTier: ctx?.preferTier });
|
|
if (sel.recommend) {
|
|
console.error(
|
|
`media-use: local video gen not enabled (${sel.reason}). Enable a fitting free on-device LTX model to use this provider.`,
|
|
);
|
|
return null;
|
|
}
|
|
|
|
const { model } = sel;
|
|
const bin = model.invoke.trim().split(/\s+/)[0];
|
|
try {
|
|
execFn("which", [bin], { stdio: ["ignore", "ignore", "ignore"] });
|
|
} catch {
|
|
console.error(
|
|
`media-use: local video gen not enabled (\`${bin}\` not on PATH). Install for free on-device LTX: ${model.install}`,
|
|
);
|
|
return null;
|
|
}
|
|
|
|
const outPath = join(tmpdir(), `media-use-ltx-${process.pid}-${Date.now()}.mp4`);
|
|
const width = ctx?.width || 512;
|
|
const height = ctx?.height || 320;
|
|
const frames = ctx?.frames || 33;
|
|
const argv = buildArgv(model.invoke, {
|
|
prompt: intent,
|
|
w: width,
|
|
h: height,
|
|
frames,
|
|
out: outPath,
|
|
});
|
|
argv.shift();
|
|
|
|
try {
|
|
execFn(bin, argv, {
|
|
encoding: "utf8",
|
|
timeout: 1_800_000,
|
|
stdio: ["ignore", "pipe", "pipe"],
|
|
});
|
|
} catch (err) {
|
|
console.error(
|
|
`media-use: local video gen (${model.id}) failed: ${err.stderr?.toString().trim().slice(-200) || err.message}`,
|
|
);
|
|
return null;
|
|
}
|
|
if (!pathExists(outPath)) return null;
|
|
return {
|
|
localPath: outPath,
|
|
ext: ".mp4",
|
|
source: "generated",
|
|
metadata: {
|
|
description: intent,
|
|
provider: "ltx.local",
|
|
provenance: { prompt: intent },
|
|
},
|
|
};
|
|
}
|