Modelflare Media Skill

Der Modelflare Media Skill ist ein installierbarer Agenten-Skill: ein Ordner mit einem SKILL.md, einer generierten Modellreferenz und einem Hilfsskript. Sobald es sich im Skills-Verzeichnis Ihres Agenten befindet, weiß Claude Code, Codex oder jeder Agent, der SKILL.md liest, wie man ein Modelflare-Bild- oder Videomodell auswählt, den Preis angibt, die richtige Anfrage sendet, auf Videos wartet und das Ergebnis speichert.

Das Paket wird alle paar Minuten aus dem Live-Modellkatalog generiert, sodass die Modellliste und die darin enthaltenen Preise nie veraltet sind. Textmodelle liegen absichtlich außerhalb des Geltungsbereichs: Ihr Agent verfügt bereits über eines. Das Hilfsskript benötigt nur Node.js 18 oder neuer, was Claude Code und Codex bereits benötigen, und verhält sich unter macOS, Windows und Linux gleich.

1. Installieren

Sie müssen nicht wissen, wo Ihr Agent seine Fähigkeiten aufbewahrt; Der Agent tut es. Senden Sie ihm diese Nachricht, die gleiche für jeden Agenten:

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.

Wenn der Agent keine Dateien herunterladen kann, laden Sie die Zip-Datei selbst herunter und hängen Sie sie an die Nachricht an. Agenten, die Skills unterstützen (Claude Code, Codex und andere), installieren es an ihrem eigenen Skills-Speicherort; Ein Agent ohne Skills-Mechanismus kann SKILL.md immer noch von überall aus lesen, wo er das Paket extrahiert hat.

Manuelle Installation (optional)

Wird nur benötigt, wenn Sie die Dateien lieber selbst platzieren möchten, beispielsweise auf einem gemeinsam genutzten Computer oder in CI.

curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Beide werden in ~/.claude/skills/modelflare-media installiert (unter Windows ist das %USERPROFILE%\.claude\skills), was Claude Code als Fähigkeit auf Benutzerebene liest; Eine Kopie auf Projektebene wird in .claude/skills/ im Repository gespeichert. Legen Sie für einen anderen Agenten zunächst SKILL_DIR auf seinen Skills-Ordner fest (den genauen Pfad finden Sie in der Dokumentation dieses Agenten).

SKILL_DIR=~/.codex/skills curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

$env:SKILL_DIR = "$HOME\.codex\skills"; irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Sie können SKILL.md auch direkt lesen, um zu sehen, was der Agent befolgen wird.

2. Geben Sie Ihrem Agenten einen Schlüssel

Erstellen Sie einen API-Schlüssel in der Konsole und legen Sie ihn in der Umgebung fest, in der Ihr Agent ausgeführt wird. Fügen Sie unter macOS und Linux den Export zu Ihrem Shell-Profil hinzu, um ihn beizubehalten; Unter Windows sorgt die zweite Zeile dafür, dass es dauerhaft bleibt.

macOS oder Linux
Windows PowerShell

export MODELFLARE_API_KEY="sk-..."

$env:MODELFLARE_API_KEY = "sk-..."
setx MODELFLARE_API_KEY "sk-..."

Wenn Sie Umgebungsvariablen nicht selbst festlegen möchten, können Sie den Schlüssel in einer privaten Sitzung an Ihren eigenen vertrauenswürdigen Agenten senden und ihn bitten, die Umgebung für Sie zu konfigurieren. Behandeln Sie den Schlüssel wie ein Passwort: Bestätigen Sie, was der Agent schreiben wird und wo, und senden Sie ihn niemals an einen nicht vertrauenswürdigen Dienst oder einen öffentlichen/geteilten Chat, ein Problem, ein Repository oder ein Ticket. Bitten Sie den Agenten, den Schlüssel nicht zu wiederholen, keine Kopie zu speichern, ihn nicht in Quellcode, Eingabeaufforderungen, Protokolle oder Shell-Verlauf einzufügen oder ihn festzuschreiben. Widerrufen Sie den Schlüssel und erstellen Sie sofort einen neuen, wenn Sie glauben, dass er offengelegt wurde.

Der Skill schreibt den Schlüssel niemals in Dateien oder Eingabeaufforderungen und druckt ihn niemals aus. Über Castaly erstellte Konten verfügen bereits über einen Schlüssel namens Castaly, der über alle freigeschalteten Gruppen weitergeleitet wird. Jede andere Taste mit Bild- oder Videogruppen funktioniert auch.

3. Fragen Sie nach Medien

Sprechen Sie wie gewohnt mit Ihrem Agenten:

„Erstellen Sie mit gpt-image-2. ein 16:9-Poster eines Küstenobservatoriums in der Abenddämmerung.“
„Verwandeln Sie dieses Startbild mit Seedance in ein 5-sekündiges 1080p-Video.“
„Welche Videomodelle unter 0,10 USD pro Sekunde können Bild-zu-Video konvertieren?“

Der Agent liest SKILL.md, ruft den Live-Katalog von https://modelflare.dev/api/pricing ab, um zu sehen, welche Modelle der Schlüssel verwenden kann und was sie kosten, öffnet dann die eigene Seite dieses Modells auf der Dokumentationsseite für den genauen Anforderungstext, die Parametertabelle und die Grenzwerte und ruft die API mit ihrem eigenen HTTP-Client auf. Jeder Aufruf trägt den Header X-Modelflare-Skill: modelflare-media/1.0, sodass die Nutzungsprotokolle zeigen, welche Anfragen vom Skill kamen.

4. Von der Castaly-Werkbank

Jede Generation in der Castaly-Workbench verfügt über ein „Reproduzieren Sie dies in Ihrem eigenen Agenten“-Panel mit der Installationsmeldung, der ZIP-Datei und einer Aufgabenbeschreibung. Senden Sie die Installationsnachricht einmal, fügen Sie dann das Briefing ein, und der Agent reproduziert das gleiche Modell und die gleichen Parameter anhand Ihres eigenen Schlüssels.

Was der Skill nicht kann

Es sagt Ihrem Agenten nicht, wie er arbeiten soll. Wiederholungsversuche, Stapelverarbeitung und was zurückgemeldet werden soll, liegt zwischen Ihnen und Ihrem Agenten. Der Skill dokumentiert nur die API.
Es führt keine eigene Modellliste. Der Katalog und jeder Anforderungsvertrag werden live gelesen, sodass ein heute veröffentlichtes Modell bereits heute verwendbar ist.
Es werden keine Dateien in einen Speicher hochgeladen: Lokale Referenzbilder werden als Daten-URLs in die Anfrage eingebettet. Halten Sie sie daher klein (einige MB).
Modellgruppen können nicht entsperrt werden. Wenn die API model_unavailable antwortet, ist dieses Modell für dieses Konto nicht verfügbar.

Paketlayout

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

Das Paket enthält keine Modelldaten und wird daher nicht veraltet. Neuinstallation nur, um eine neue Skill-Version zu erhalten.