Générer
Chemins : ${CLAUDE_SKILL_DIR} désigne le dossier contenant ce SKILL.md, et ${CLAUDE_SKILL_DIR}/../.. le dossier du montage (le .claude/ de ce dépôt) deux niveaux au-dessus.
Chaque question à l'utilisateur va dans la boîte de question : appelez l'outil AskUserQuestion (2 à 4 options, la recommandée en premier). Uniquement dans un agent sans cet outil, posez des questions numérotées en texte.
G="${CLAUDE_SKILL_DIR}/../../lib/ai_editor/gen/gen.py". Exécutez-le avec python3 (py sous Windows). Chaque
modèle, ses entrées et ses limites sont dans gen.py models (depuis lib/ai_editor/gen/models.json) ; ne devinez jamais un identifiant
ni un paramètre. Faits sur l'API et ce qui n'est pas vérifié : references/higgsfield-api.md.
Règles
- L'argent ne est dépensé qu'après un oui à ce prix. Toujours faire
estimated'abord, demander avec le montant en dollars qu'il a affiché (sa ligneASK:), et exécutersubmit --confirm <id_estimation>seulement après que l'utilisateur a répondu oui. Un nouveau prix (l'estimation a plus de 30 minutes, ousubmitindique que le prix a changé) nécessite une nouvelle question. - Les séquences de l'utilisateur ne quittent son ordinateur qu'avec son consentement. Un clip ou une image de sa vidéo est téléchargé
vers Higgsfield lors du
submit. Mentionnez-le dans la même question que le prix. - Ne demandez jamais la clé dans le chat. Pas de clé : dites-lui d'exécuter
python3 "$G" setkeydans son propre terminal (cela demande l'identifiant et le secret depuis console.higgsfield.ai, joints sous la formeid:secret, et masque ce qu'il tape). profile.jsongen_budget_usdplafonne les dépenses mensuelles ;submitrefuse au-delà. Dites ce qu'il reste et arrêtez.- Les résultats échoués et
nsfwne sont pas facturés. Mentionnez-le si l'un échoue, et proposez de modifier le prompt.
Étapes
- Quoi et où. À partir des mots de l'utilisateur et du montage (
edits/<nom>/) : le type (motion transfer, b-roll à partir de mots, animation d'une image fixe, image pour une carte), l'instant qu'il couvre (secondes sur la timeline, d'après la transcription danswords.json), et pour le motion transfer l'étendue de leur vidéo (4 s ou plus ; le modèle conserve au maximum 30 s). Choisissez le modèle avecpython3 "$G" models --kind <type>. - Le prompt. Rédigez-le vous-même à partir du texte dit : le sujet, le décor, la caméra, la lumière,
en moins de 40 mots. Le b-roll correspond au format de la vidéo (un montage vertical reçoit un plan d'ambiance vertical).
Le motion transfer prend 1 à 8 images de référence (
--image, fichiers ou URL) : l'apparence sur laquelle appliquer les mouvements. - Estimez le prix.
python3 "$G" estimate edits/<nom> --model <id> --prompt "<prompt>" [--video raw.mp4 --from 12.0 --to 18.0] \ [--image ref.png] [--param duration=5] --at <secondes_timeline>generated/inputs/, estime la requête sans rien télécharger, et affiche l'identifiant d'estimation,usd,credits,over_budgetet une ligneASK:. - Demandez. Une seule boîte de question : la ligne
ASK:comme question (prix, modèle et ce qui est téléchargé), options "Oui, générez-le (Recommandé)" / "Modifier le prompt" / "Non". En cas de dépassement de budget : dites-le et arrêtez. - Soumettez seulement après un oui :
python3 "$G" submit edits/<nom> --confirm <id_estimation>. Cela télécharge les entrées, ré-estime avec elles, soumet et affiche l'identifiant du travail. - Attendez en arrière-plan (les générations prennent des minutes) :
python3 "$G" wait edits/<nom> <travail>. Cela interroge avec backoff, télécharge le résultat dansedits/<nom>/generated/, le sonde et l'ajoute à la piste Généré de la timeline à--atcomme modification de Claude (viaproject.py apply; sans le document projet encore, il écritgenerated/<travail>.ops.jsonet l'affiche).status/listmontrent la progression ;cancelfonctionne uniquement tant que le travail est encore en file d'attente. - Passez la main. Dites ce qui a été ajouté, où, et combien cela a coûté. L'utilisateur déplace, coupe ou supprime le résultat sur la
timeline comme n'importe quel clip. Une correction sur l'apparence des générations va dans
taste.
Si une commande s'arrête
| message | à faire |
|---|---|
No Higgsfield key | demandez à l'utilisateur d'exécuter python3 "$G" setkey dans son terminal, puis continuez |
needs at least 4 s | élargissez --from/--to, ou choisissez un modèle texte ou image |
over this month's generation budget | dites-lui ce qu'il reste ; il peut augmenter gen_budget_usd |
the price is $X, not $Y | demandez à nouveau avec le nouveau prix, puis submit --confirm le nouvel identifiant affiché |
Maximum number of concurrent requests | le client a déjà réessayé ; attendez la fin d'un travail en cours, puis soumettez |
ended failed / ended nsfw | non facturé ; proposez un prompt modifié (nouvelle estimation et question) |
Fichiers
lib/ai_editor/gen/gen.py: les commandes ci-dessus,demoauto-test (un Higgsfield factice, sans réseau).lib/ai_editor/gen/higgsfield.py: le client API.base.py: l'interface et le catalogue du fournisseur.lib/ai_editor/gen/jobs.py:edits/<nom>/generated/jobs.jsonet les dépenses mensuelles.references/higgsfield-api.md: l'API telle que documentée, avec sources.