Aller au contenu
ModelflareModelflareModelflare
Ouvrir CastalyConsole

Images et vidéo

Modelflare Media Skill

Installez une compétence d'agent afin que Claude Code, Codex ou tout agent compatible SKILL.md puisse choisir une image ou un modèle vidéo Modelflare, tarifer l'appel, le soumettre et enregistrer le résultat.

Le Modelflare Media Skill est une compétence d’agent installable : un dossier avec un SKILL.md, une référence de modèle générée et un script d’assistance. Une fois dans le répertoire de compétences de votre agent, Claude Code, Codex ou tout agent qui lit SKILL.md sait choisir un modèle d’image ou de vidéo Modelflare, citer son prix, envoyer la bonne demande, attendre les vidéos et enregistrer le résultat.

Le package est généré à partir du catalogue de modèles en direct toutes les quelques minutes, de sorte que la liste des modèles et les prix qu’elle contient ne deviennent jamais obsolètes. Les modèles de texte sont volontairement hors de portée : votre agent en possède déjà un. Le script d’assistance n’a besoin que de Node.js 18 ou plus récent, dont Claude Code et Codex ont déjà besoin, et se comporte de la même manière sur macOS, Windows et Linux.

1. Installer

Section intitulée « 1. Installer »

Vous n’avez pas besoin de savoir où votre agent conserve ses compétences ; l’agent le fait. Envoyez-lui ce message, le même pour chaque agent :

Text
Install this skill: https://modelflare.dev/skills/modelflare-media/modelflare-media.zip (or use the attached zip), then read its SKILL.md. If you do not support skills, extract it anywhere and follow SKILL.md. My key is in the environment variable MODELFLARE_API_KEY.

Si l’agent ne parvient pas à télécharger les fichiers, téléchargez le zip vous-même et joignez-le au message. Les agents qui prennent en charge les compétences (Claude Code, Codex et autres) l’installent dans leur propre emplacement de compétences ; un agent sans mécanisme de compétences peut toujours lire SKILL.md depuis l’endroit où il a extrait le package.

Installation manuelle (facultatif)

Section intitulée « Installation manuelle (facultatif) »

Uniquement nécessaire si vous préférez placer les fichiers vous-même, par exemple sur une machine partagée ou en CI.

Fenêtre de terminalbash
curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

Vous pouvez également lire directement SKILL.md pour voir ce que l’agent suivra.

2. Donnez une clé à votre agent

Section intitulée « 2. Donnez une clé à votre agent »

Créez une clé API dans la console et définissez-la dans l’environnement dans lequel votre agent s’exécute. Sous macOS et Linux, ajoutez l’exportation à votre profil shell pour la conserver ; sous Windows, la deuxième ligne le rend persistant.

Fenêtre de terminalbash
export MODELFLARE_API_KEY="sk-..."

Si vous n’êtes pas à l’aise pour définir vous-même les variables d’environnement, vous pouvez envoyer la clé à votre propre agent de confiance lors d’une session privée et lui demander de configurer l’environnement pour vous. Traitez la clé comme un mot de passe : confirmez ce que l’agent va écrire et où, ne l’envoyez jamais à un service non fiable ou à un chat, un problème, un référentiel ou un ticket public/partagé. Demandez à l’agent de ne pas répéter la clé, d’en enregistrer une copie, de la placer dans le code source, les invites, les journaux ou l’historique du shell, ou de la valider. Révoquez la clé et créez-en une nouvelle immédiatement si vous pensez qu’elle a pu être exposée.

La compétence n’écrit jamais la clé dans des fichiers ou des invites et ne l’imprime jamais. Les comptes créés via Castaly ont déjà une clé nommée Castaly qui traverse chaque groupe déverrouillé ; toute autre clé avec des groupes d’images ou de vidéos fonctionne également.

3. Demandez des médias

Section intitulée « 3. Demandez des médias »

Parlez à votre agent comme d’habitude :

  • “Générer une affiche 16:9 d’un observatoire côtier au crépuscule avec gpt-image-2.”
  • “Transformez cette image de départ en une vidéo 1080p de 5 secondes avec Seedance.”
  • « Quels modèles vidéo de moins de 0,10 USD par seconde peuvent effectuer une conversion image-vidéo ? »

L’agent lit SKILL.md, récupère le catalogue en direct de https://modelflare.dev/api/pricing pour voir quels modèles la clé peut utiliser et ce qu’ils coûtent, puis ouvre la propre page de ce modèle sur le site de documentation pour le corps exact de la requête, la table des paramètres et les limites, et appelle l’API avec son propre client HTTP. Chaque appel porte l’en-tête X-Modelflare-Skill: modelflare-media/1.0, de sorte que les journaux d’utilisation montrent quelles requêtes proviennent de la compétence.

4. Depuis l’établi Castaly

Section intitulée « 4. Depuis l’établi Castaly »

Chaque génération dans Castaly workbench dispose d’un panneau “Reproduire ceci dans votre propre agent” avec le message d’installation, le zip et un résumé de tâche. Envoyez le message d’installation une fois, puis collez le brief, et l’agent reproduit le même modèle et les mêmes paramètres par rapport à votre propre clé.

Ce que la compétence ne fait pas

Section intitulée « Ce que la compétence ne fait pas »
  • Il n’indique pas à votre agent comment travailler. Les tentatives, le traitement par lots et les éléments à signaler dépendent de vous et de votre agent ; la compétence documente uniquement l’API.
  • Il ne comporte aucune liste de modèles propre. Le catalogue et chaque contrat de demande sont lus en direct, un modèle publié aujourd’hui est donc utilisable aujourd’hui.
  • Il ne télécharge les fichiers sur aucun stockage : les images de référence locales sont intégrées dans la requête en tant qu’URL de données, donc gardez-les petites (quelques Mo).
  • Il ne peut pas déverrouiller les groupes de modèles. Si l’API répond model_unavailable, ce modèle n’est pas disponible pour ce compte.

Disposition du package

Section intitulée « Disposition du package »
Text
modelflare-media/
  SKILL.md   authentication, where the live catalog is, how to find each model's
             request contract on the docs site, and what the error codes mean

Le package ne contient aucune donnée de modèle, il ne devient donc pas obsolète ; réinstallez uniquement pour récupérer une nouvelle version de compétence.