openclip-ugc-ads

OpenClip : Génération de publicités UGC

generate_ugc génère un clip vertical court de type UGC (environ 7 à 12 secondes) à partir d'un brief créatif. Les comptes gratuits ont droit à UNE génération par jour. Les comptes payants sont facturés en crédits selon les secondes rendues.

Les rendus sont lourds. Attendez-vous à quelques minutes par clip, pas quelques secondes.

Configuration (une fois)

OpenClip est un serveur MCP distant à l'adresse https://openclip.app/mcp. Connectez-vous avec votre compte OpenClip lorsque l'invite OAuth apparaît, il n'y a pas de clé API à copier.

• Claude Code : claude mcp add --transport http openclip https://openclip.app/mcp, puis /mcp pour autoriser.
• Claude Desktop / Web : Paramètres, Connecteurs, "Ajouter un connecteur personnalisé", collez l'URL, connectez-vous.
• Cursor (.cursor/mcp.json) : { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clients uniquement en-tête : générez un jeton MCP sur openclip.app/settings/connect et connectez-vous à https://openclip.app/mcp/key avec Authorization: Bearer <jeton>.

Vérification : appelez get_account.

La boucle

1. Découvrez le catalogue EN PREMIER. list_ugc_creators renvoie les valeurs valides de creator et start_frame pour cette équipe : un catalogue soigneusement sélectionné plus les propres créateurs sauvegardés de l'équipe, regroupés par niche. Ne devinez jamais le nom d'un créateur, choisissez-en un à partir de cet appel.
2. Générez. generate_ugc(...) avec soit :
   • brief_name - un préréglage côté serveur, le chemin rapide, ou
   • brief - un objet en ligne de champs créatifs structurés (character et autres).
3. Interrogez. Renvoie un hachage ugc_job. Interrogez get_ugc_job_status(ugc_job) toutes les 10 à 15 secondes. queued / rendering sont en cours. completed renvoie video_url plus result_meta (durée, dimensions, fps, seed). failed renvoie error.
4. Consultez les travaux passés. list_ugc_jobs liste les clips UGC précédents d'une équipe, et c'est ainsi que vous retrouvez un identifiant ugc_job à interroger si vous l'avez perdu.

Le brief est structuré, pas un prompt

C'est ce que les agents comprennent le plus mal. brief n'est pas un prompt en prose. C'est un objet de champs créatifs discrets (character, et les autres champs que l'API accepte). Écrire un paragraphe dans un seul champ gaspille la structure et produit un résultat brouillon.

Écrivez chaque champ comme un détail concret, physique, filmable :

• Nommez ce qui est dans le cadre, pas ce que cela doit inspirer. "Tient la bouteille à hauteur de poitrine, plan de travail de cuisine derrière" est meilleur que "ambiance énergique et inspirante".
• Une idée par champ. N'empilez pas trois concepts dans character.
• Les contraintes produisent un meilleur résultat que les adjectifs. Un cadre spécifique, un accessoire spécifique et une action spécifique surpassent "haute qualité, professionnel, engageant".

Tester les angles publicitaires

Lorsque l'utilisateur souhaite des variations plutôt qu'un seul clip, modifiez UNE variable par rendu pour que la comparaison ait du sens :

• Même créateur, accroche différente.
• Même accroche, créateur différent, lorsque vous testez qui fait passer le message.
• Mêmes paramètres, start_frame différent, lorsque vous testez le moment de la miniature.

Les comptes gratuits ont droit à une génération par jour. Donc, sur un compte gratuit, utilisez-la pour l'angle le plus différent plutôt qu'une copie quasi-identique. Vérifiez get_account avant de promettre un lot.

Règles

• list_ugc_creators avant chaque première génération d'une session. Le catalogue est propre à chaque équipe et change.
• Interrogez toujours. Les rendus prennent des minutes, generate_ugc renvoie le résultat immédiatement.
• Les clips sont courts par conception, environ 7 à 12 secondes. Ne promettez pas une publicité de 60 secondes.
• Le niveau gratuit est d'UNE génération par jour. Dites-le avant que l'utilisateur ne planifie un lot sur un compte gratuit.
• result_meta inclut le seed. Gardez-le lorsque l'utilisateur a aimé un rendu et souhaite une variante proche.

Erreurs

Les échecs d'outil reviennent comme un résultat d'outil avec isError: true et un message en texte brut, pas un code HTTP. "Non authentifié. Reconnectez votre jeton OpenClip." signifie reconnectez-vous ou regénérez le jeton. Les messages de validation (un créateur inconnu, un brief mal formé) reviennent comme le texte du message, corrigez l'argument et réessayez.

Exemples de prompts en actions

• "Crée une publicité UGC pour mon appli" - list_ugc_creators, choisissez un créateur adapté, generate_ugc(brief={...}), interrogez get_ugc_job_status, renvoyez video_url.
• "Donne-moi trois angles à tester" - un rendu par angle, une variable changée à chaque fois, interrogez chaque. Vérifiez d'abord la limite quotidienne sur un compte gratuit.
• "Utilise la même fille que la dernière fois" - list_ugc_jobs pour trouver le travail précédent, lisez son créateur, réutilisez-le.
• "Quels créateurs puis-je utiliser ?" - list_ugc_creators, affichez-les regroupés par niche.

Associé

Le découpage de séquences longues en format court est openclip-clipping. Le rognage, le recadrage et la compression gratuits du clip généré sont openclip-video-editing.