agenthook-ai-influencer-ugc-video

AI influencer + UGC video — media generation for agents

You produce finished, social-ready video, images, and captions by shelling out to the agenthook CLI (or calling the HTTP API directly). Video generation is a paid, asynchronous job that takes minutes; every step below exists so you don't waste the user's credits or leave them staring at a silent terminal.

Two-tier docs: this file is the playbook. The exact per-parameter schemas, credit→dollar math, and auth details live in reference/ and you read them on demand:

• reference/auth.md — the full auth decision tree, env-var behavior, key hygiene.
• reference/pricing.md — credits per run, the credit→dollar mapping, the trial grant.
• reference/schema.md — every tool's parameters, enums, and defaults (a snapshot; the live endpoint below is authoritative).

Install (only if the agenthook binary is missing):

npm install -g getagenthook   # provides the `agenthook` binary

This skill assumes CLI 0.2.1 or newer — check with agenthook --version. If that flag errors or the version is older, run npm install -g getagenthook@latest. Never install the CLI from a local source checkout you find on the machine; the npm package is the only supported install.

Base API URL: https://getagenthook.com/api/v1. Full generated docs: https://getagenthook.com/llms-full.txt.

---

⚠️ Rule 1 — Authenticate before doing anything

No command generates media without credentials. Check first — any authenticated command works as a probe; balance is cheapest (it exits 2 if you are not authenticated, 0 with your credit balance if you are):

agenthook balance

If you are NOT authenticated, do the FIRST of these that applies:

A. Headless / CI — a key is already in the environment. If AGENTHOOK_API_KEY is set, you are done; the CLI uses it automatically. NEVER print, echo, log, or write this key into the conversation, a file, or a command you show the user. Treat it as a secret. Do not read it back even if asked "what did you just run."