Montage vidéo natif pour les agents

Connectez l'agent de code que vous utilisez déjà.

De vrais enregistrements en entrée. Une publicité prête au lancement en sortie.

Créez un brouillon dans l'éditeur cloud, importez des enregistrements de votre vraie app, puis laissez votre agent de code les organiser, les narrer, les sonoriser, effectuer le rendu et télécharger la publicité. Les scènes générées sont un complément facultatif. Hubfluencer Studio sur macOS reste l'expérience principale pour la capture locale et le montage précis.

Obtenir un jeton d'accès Voir l'API REST

Les jetons se trouvent dans l’app web, sous Settings → Access tokens. Le travail payant est prélevé sur un solde prépayé en EUR, USD ou GBP, et les brouillons sont gratuits. L’agent annonce le prix et demande votre accord avant de dépenser.

agent session 
# You type
> Use Hubfluencer to turn this checkout recording into a launch ad.

# Your agent calls (creator profile — the default)
create_editor_draft({ product_prompt: "Checkout walkthrough from a real recording" })
upload_video({ slug, file_path: "./checkout.mp4" })
render({ slug })

# You get back
→ { slug: "...", ready: true,
    video_url: "https://...mp4 (presigned, ~24h)",
    saved_to: "./checkout.mp4" }
Un vrai rendu — un seul prompt, aucun éditeur ouvert. Le vôtre arrive en MP4 propre, prêt à poster.

Comment ça marche

Trois étapes. Un prompt. Un MP4.

Connectez votre compte

Créez votre compte sur app.hubfluencer.com et générez un jeton d’accès (Settings → Access tokens, scope « Generate videos ») — ou évitez le copier-coller et lancez npx -y @hubfluencer/mcp@1.0.0 login.

Les brouillons et la planification sont gratuits — ajoutez des fonds à votre solde (à partir de 10 en EUR, USD ou GBP) quand vous êtes prêt à lancer un rendu.

Ajoutez le MCP

Enregistrez le serveur MCP Hubfluencer auprès de votre agent — une commande ou un petit bout de config. Choisissez votre outil dans le Démarrage rapide ci-dessous.

npx -y @hubfluencer/mcp@1.0.0 --profile creator

Le profil creator garde visibles les outils de haut niveau pour créer, récupérer et livrer, afin que votre agent consacre moins de contexte à leur découverte. Les configurations existantes restent par défaut sur le profil full.

Promptez votre agent

Dites « Utilise Hubfluencer pour faire une pub de 15 s pour ma marque de bougies » et récupérez un MP4.

Les brouillons sont gratuits. Le rendu d’un short coûte 1,60 dans la devise de votre compte (EUR, USD ou GBP) ; une pub editor est facturée par scène générée, plus la voix et la musique — votre agent confirme d’abord le prix avec vous, et la plupart des rendus se terminent en quelques minutes.

Démarrage rapide

Branchez-le sur votre agent.

Choisissez votre outil. Chaque kit enregistre le même serveur @hubfluencer/mcp et fournit un skill concis chargé à la demande. Le MCP donne les outils à votre agent ; le skill lui apprend l'approbation des dépenses et les règles du cycle de vie, puis ne charge son guide avancé qu'en cas de besoin.

Une fois connecté, lancez npx -y @hubfluencer/mcp@1.0.0 doctor --profile creator. La commande vérifie les identifiants, l’origine sécurisée de l’API, l’accès au solde, le profil d’outils et les limites d’accès aux fichiers locaux, sans rien dépenser.

Ajoutez le MCP — une seule commande

terminal 
claude mcp add --transport stdio --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN hubfluencer -- npx -y @hubfluencer/mcp@1.0.0 --profile creator

Collez-la dans votre shell — pas dans une session Claude en cours, où elle serait lue comme un prompt au lieu d'être exécutée. Tous les flags vont avant le nom du serveur ; -- le sépare de la commande que Claude Code lance. Utilisez --scope project pour écrire le serveur dans .mcp.json à la racine du repo.

…ou un fichier de config

.mcp.json 
{
  "mcpServers": {
    "hubfluencer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@hubfluencer/mcp@1.0.0", "--profile", "creator"],
      "env": {
        "HUBFLUENCER_API_TOKEN": "${HUBFLUENCER_API_TOKEN}"
      }
    }
  }
}

Formez l'agent

Installez le skill complet à la demande en une commande. Ajoutez --project pour utiliser .claude/skills au lieu de votre répertoire de skills personnel.

npx -y @hubfluencer/mcp@1.0.0 install-skill --client claude-code

Télécharger le kit

SKILL.md API.md advanced guide README.md
Connectez-vous d’abord : créez dans l’app un jeton au scope « Generate videos » et exportez-le en tant que HUBFLUENCER_API_TOKEN, ou lancez npx -y @hubfluencer/mcp@1.0.0 login. Ne collez jamais de jeton dans un fichier commité — utilisez l’expansion ${HUBFLUENCER_API_TOKEN}.

Ajoutez le MCP — une seule commande

terminal 
codex mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hubfluencer/mcp@1.0.0 --profile creator

…ou un fichier de config

~/.codex/config.toml 
[mcp_servers.hubfluencer]
command = "npx"
args = ["-y", "@hubfluencer/mcp@1.0.0", "--profile", "creator"]

[mcp_servers.hubfluencer.env]
HUBFLUENCER_API_TOKEN = "YOUR_TOKEN"
# Optional:
# HUBFLUENCER_BASE_URL = "https://hubfluencer.com"
# HUBFLUENCER_OUTPUT_DIR = "/absolute/path/where/mp4s/may/be/written"

Redémarrez Codex après avoir modifié config.toml. Gérez avec codex mcp list / get / remove.

Formez l'agent

Installez le skill complet dans le répertoire natif partagé de Codex ~/.agents/skills/hubfluencer-create. Ajoutez --project pour utiliser .agents/skills/hubfluencer-create dans le projet courant. AGENTS.md n'est désormais qu'un court pointeur facultatif.

npx -y @hubfluencer/mcp@1.0.0 install-skill --client codex

Télécharger le kit

SKILL.md AGENTS.md advanced guide README.md
Connectez-vous d’abord : créez dans l’app un jeton au scope « Generate videos », ou lancez npx -y @hubfluencer/mcp@1.0.0 login. Si vous vous êtes connecté avec login, omettez entièrement le bloc env — le serveur lit automatiquement le jeton enregistré.

Ajoutez le MCP — config uniquement

OpenCode n'a pas de commande mcp add. Éditez la config JSON à la main. Attention : type vaut local (pas stdio), et la clé est environment (pas env).

opencode.json 
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hubfluencer": {
      "type": "local",
      "command": ["npx", "-y", "@hubfluencer/mcp@1.0.0", "--profile", "creator"],
      "enabled": true,
      "environment": {
        "HUBFLUENCER_API_TOKEN": "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

À placer dans opencode.json (racine du projet) ou ~/.config/opencode/opencode.json. Redémarrez OpenCode après modification.

Formez l'agent

Utilisez le répertoire natif de skills à la demande d'OpenCode au lieu de placer tout le workflow dans AGENTS.md chargé en permanence. Ajoutez --project pour .opencode/skills.

npx -y @hubfluencer/mcp@1.0.0 install-skill --client opencode

Télécharger le kit

SKILL.md AGENTS.md advanced guide README.md
Connectez-vous d’abord : collez un jeton au scope « Generate videos » comme HUBFLUENCER_API_TOKEN dans le bloc environment, ou lancez npx -y @hubfluencer/mcp@1.0.0 login et supprimez entièrement le bloc.

Ajoutez le support MCP, puis le serveur

Pi n'a pas de MCP natif — installez l'extension pi-mcp-adapter, puis déposez une config mcp.json.

terminal 
pi install npm:pi-mcp-adapter
~/.pi/agent/mcp.json 
{
  "mcpServers": {
    "hubfluencer": {
      "command": "npx",
      "args": ["-y", "@hubfluencer/mcp@1.0.0", "--profile", "creator"],
      "env": {
        "HUBFLUENCER_API_TOKEN": "${HUBFLUENCER_API_TOKEN}"
      }
    }
  }
}
Attention : le support MCP de Pi vient d'une extension communautaire, pas d'une fonctionnalité officielle — les noms de champs de l'adaptateur peuvent bouger d'une version à l'autre, vérifiez donc le README de pi-mcp-adapter. L'alternative 100 % native : livrer une Skill Pi qui pilote l'API REST en bash + curl.

Formez l'agent

Installez ensemble le skill concis et sa référence avancée. Ajoutez --project pour .pi/skills ; AGENTS.md n'est qu'un court pointeur facultatif.

npx -y @hubfluencer/mcp@1.0.0 install-skill --client pi

Télécharger le kit

SKILL.md AGENTS.md advanced guide mcp.json README.md

Une même config, plein de clients

Cursor, Windsurf, Claude Desktop et la plupart des autres clients MCP acceptent le même bloc mcpServers :

mcp servers config 
{
  "mcpServers": {
    "hubfluencer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@hubfluencer/mcp@1.0.0", "--profile", "creator"],
      "env": {
        "HUBFLUENCER_API_TOKEN": "${HUBFLUENCER_API_TOKEN}"
      }
    }
  }
}
  • Cursor — .cursor/mcp.json dans le projet, ou ~/.cursor/mcp.json en global.
  • Windsurf — ~/.codeium/windsurf/mcp_config.json
  • Claude Desktop — claude_desktop_config.json via Réglages → Développeur → Modifier la config.

Les noms de champs varient parfois selon les clients (env vs environment) — consultez la doc MCP de votre outil si le serveur n'apparaît pas.

Formez l'agent

Récupérez les instructions en Markdown brut et déposez-les là où votre outil lit ses consignes — fichier de règles, notes de projet ou prompt système. API.md est la même référence que consultent les skills.

Télécharger le kit

AGENTS.md API.md
Connectez-vous d’abord : créez dans l’app un jeton au scope « Generate videos » et référencez-le sous la forme ${HUBFLUENCER_API_TOKEN}, ou lancez npx -y @hubfluencer/mcp@1.0.0 login et supprimez entièrement le bloc env.

Référence des outils

Ce que l'agent peut appeler.

Outil Ce que ça fait Prix
create_editor_draft Créer une timeline editor vide pour de vrais enregistrements. Point de départ par défaut du profil creator. gratuit
upload_video Uploadez votre propre clip vidéo et déposez-le sur la timeline comme scène. gratuit
render Lancer le rendu de la timeline. Les projets composés uniquement de rushes sont rendus gratuitement ; les scènes IA non générées sont facturées au rendu. export gratuit
make_video Profil complet uniquement : crée un brouillon synthétique, le chiffre, le génère, suit son état et le télécharge. 1.60+
create_short Créer un brouillon de short à partir d'un prompt. gratuit
generate_short Générer un brouillon de short. 1.60
create_editor_ad Créer un brouillon de pub editor multi-scènes pour les prompts narratifs. gratuit
cancel_autopilot Arrêter exactement la tentative Autopilot observée dans generation_summary ; l’outil transmet sa barrière run/start et conserve le travail terminé. gratuit
cancel_segment_generation Annuler une scène générée individuellement avec son jeton d’attribution et rembourser son coût. refund
set_product Associer une photo produit comme référence d’identité pour chaque scène IA générée ; sa description ancre l’histoire et l’image exacte devient le plan de fin, sauf si vous en définissez un autre. gratuit
set_logo Incruster votre logo sur la vidéo finie. gratuit
set_closing_image Définir une image de fin personnalisée — uploadez-en une ou réutilisez la photo produit. gratuit
get_status Vérifier le statut actuel, y compris la progression réelle par clip pendant le rendu d’un short payant. gratuit
wait_for_completion Poller jusqu'à la fin du rendu ; rappelez-le s'il expire en cours d'attente. gratuit
download_result Télécharger le MP4 fini depuis son URL présignée (~24 h). gratuit
list_renders Lister chaque version de rendu avec statut, URL de téléchargement et de miniature, durée, fraîcheur et possibilité de relance. gratuit
retry_render Relancer un rendu échoué depuis son instantané sauvegardé. gratuit
list_voices Lister les voix off et leurs langues vérifiées. gratuit
get_balance Lire le solde du compte, dans sa devise, avant de dépenser. gratuit
list_projects Lister les projets vidéo récents du compte. gratuit

Le profil creator par défaut part de vrais rushes : create_editor_draft, upload_video, puis render. make_video et les shorts sont disponibles avec --profile full. Un rendu composé uniquement de rushes est gratuit ; les scènes générées et le rendu d’un short sont prélevés sur votre solde, dans la devise de votre compte (EUR, USD ou GBP) — chiffrez d’abord.

Apporter vos propres médias est gratuit : upload_video dépose vos rushes sur la timeline, et set_product / set_logo / set_closing_image ajoutent votre marque. Au-delà de cette sélection, le MCP expose aussi l'éditeur granulaire complet — scénario, prompts par scène, narration, voix et musique — pour que l'agent dirige une pub de bout en bout. Voir la liste des outils @hubfluencer/mcp pour tout le détail.

Comment ça marche

Enregistrez la vraie app. Laissez votre agent de code faire le montage.

Hubfluencer Studio capture un écran, une fenêtre, une zone ou le simulateur iOS. Connectez l’agent de code que vous utilisez déjà. Les pubs editor et les shorts dans le cloud restent disponibles avec --profile full, comme solution de repli sans Mac.

Capturer

Enregistrez le vrai produit sur un Mac. Le montage local est gratuit ; votre solde ne paie que les ingrédients tiers (voix, musique, compléments IA).

Connecter

Device-link ou jeton « Generate videos ». Les jetons d’agent ont video:read + video:generate — jamais account:admin.

Editer

create_editor_draft → upload_video → voix/musique optionnelles → render. C’est le profil creator par défaut.

Livrer

wait_for_completion puis download_result. Les liens de relecture et le calendrier de rappels restent disponibles quand vous avez besoin d’une validation client ou d’une date de publication.

Les packs de campagne, les séries, le tracking et make_video restent disponibles dans l’API et avec --profile full. Ils ne font pas partie du parcours par défaut « Connectez votre agent ».

Auth & solde

Un solde prépayé, des jetons à portée limitée.

Vous ajoutez des fonds et créez des jetons d’accès dans l’app — un solde prépayé en EUR, USD ou GBP, avec la même grille tarifaire dans chaque devise. Rien de crypto ici — juste un solde et un jeton Bearer. L’agent annonce le prix et demande votre accord avant de dépenser ; vous gardez la main.

Jetons d'accès

Créés dans l'app sous Settings → Access tokens. Le scope agent s'appelle « Generate videos » = video:generate + video:read. Les jetons d'agent n'obtiennent jamais account:admin.

Variables d'environnement lues par le serveur :

  • HUBFLUENCER_API_TOKEN — requis (sauf connexion via login)
  • HUBFLUENCER_BASE_URL — optionnel, par défaut https://hubfluencer.com
  • HUBFLUENCER_OUTPUT_DIR — optionnel, restreint où les MP4 peuvent être écrits

Connexion sans copier-coller

Lancez npx -y @hubfluencer/mcp@1.0.0 login. La commande affiche une URL et un code court ; vous approuvez la connexion dans l’app, en étant connecté. Un jeton à portée limitée est enregistré dans ~/.hubfluencer/credentials.json et le serveur le récupère automatiquement — vous pouvez donc omettre complètement HUBFLUENCER_API_TOKEN.

terminal 
npx -y @hubfluencer/mcp@1.0.0 login

L'agent n'invente jamais de jeton et n'en affiche jamais dans sa sortie.

Gestion des échecs

  • 402 — balance_insufficient : indiquez required et available, puis arrêtez-vous (pas de boucle).
  • 409 — déjà en cours : continuez de poller, ne relancez pas.
  • 403 — insufficient_scope : le jeton n'a pas video:generate.
  • Relances : envoyez une Idempotency-Key sur les appels generate pour qu'une relance ne facture pas deux fois.

Prix

  • Brouillons & planification — gratuits (plus 20 assists IA/jour)
  • Générer un short — 1,60
  • Pub editor — par scène générée, plus la voix (0,15 par 1 000 caractères de script) et la musique (0,25 par minute) — vérifiez le coût exact en amont

Les prix sont exprimés dans la devise de votre compte (EUR, USD ou GBP) et sont prélevés sur un solde que vous rechargez dans l’app. Les skills font annoncer le prix par l’agent et obtenir votre feu vert avant toute dépense.

Hors périmètre

Publier sur TikTok / Instagram exige un compte social lié par un humain. L'agent ne publie jamais tout seul — il rend le MP4 fini plus une légende prête à coller, et vous postez vous-même.

REST direct — sans MCP

Vous préférez du HTTP brut ? Allez-y.

L'URL de base est https://hubfluencer.com, tout vit sous /api, et vous vous authentifiez avec Authorization: Bearer <token>. Trois requêtes font passer un short du prompt au MP4 : créez le brouillon, lancez le rendu, puis suivez le timing et les actions disponibles de generation_summary jusqu'à ce que download_result soit proposé.

Lire la référence API.

Chaque endpoint externe, avec paramètres et exemples de réponses — aucun jeton requis pour la lire. La spec OpenAPI brute y est aussi liée.

Pour Editor et Short, generation_summary fait autorité sur le cycle de vie : suivez generation_summary.timing.poll_after_ms, n'invoquez que generation_summary.available_actions et n'utilisez les projections produit que comme affichage ou barrières de route explicites. Ne récupérez l'asset que lorsque download_result est proposé.

shorts.sh 
# 1. Create an editor draft (free) — language is required; response includes the slug
curl -X POST https://hubfluencer.com/api/editor \
  -H "Authorization: Bearer $HUBFLUENCER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: editor-draft:checkout" \
  -d '{"language": "en", "product_prompt": "Checkout walkthrough from a real recording"}'

# 2. Upload recordings (free) via MCP upload_video, or POST /api/editor/SLUG/uploads/presign → PUT → confirm.
# 3. Render (free when every scene is already footage).
curl -X POST https://hubfluencer.com/api/editor/SLUG/render \
  -H "Authorization: Bearer $HUBFLUENCER_API_TOKEN" \
  -H "Idempotency-Key: editor-render:SLUG"

FAQ

Questions, réponses.

Combien de temps prend un rendu ?

Quelques minutes pour la plupart des shorts ; les runs autopilot multi-scènes peuvent durer plus longtemps. Ne pollez que tant que generation_summary.timing.poll_after_ms est positif, en respectant exactement la cadence du serveur ; null signifie qu'il faut arrêter et suivre une action proposée.

Combien coûte une vidéo en argent réel ?

Les prix sont en argent réel, dans la devise de votre compte — EUR, USD ou GBP, avec le même montant dans chacune. Un short coûte 1,60, une scène générée 1,15 sur le modèle par défaut à sa durée par défaut, la voix 0,15 par 1 000 caractères de script et la musique 0,25 par minute — les brouillons, la planification et 20 assists IA par jour sont gratuits, et les skills font confirmer le prix par votre agent avec vous avant tout rendu.

Filigranes ou restrictions d'usage ?

Aucun filigrane — le MP4 téléchargé est l'asset final, prêt à poster. Vous gardez les droits sur tout ce que vous uploadez.

Puis-je le lancer en headless — CI, cron, un bot ?

Oui. L'auth est un simple jeton Bearer en variable d'environnement, tout est du REST en dessous, et le serveur MCP est un process npx sans état — tout ce qui parle MCP ou HTTP fonctionne.

Où trouver de l'aide ?

Le Discord est le canal le plus rapide — sinon, écrivez à contact@hubfluencer.com. Les rapports de bugs et demandes de fonctionnalités sur les kits MCP sont particulièrement bienvenus.