Communitygithub.com

ImagineVid KI-Generierung

Nutze die authentifizierten Agenten-Generierungswerkzeuge von ImagineVid, um KI-Bilder, KI-Videos und KI-Musik über den aktuellen Multi-Modell-Fähigkeitskatalog zu erstellen. Verwende dies, wenn ein Nutzer die Medienerstellung anfordert, eine ImagineVid-Fähigkeit auswählt, eine lokale Datei hochlädt, Credits abfragt, eine Generierung einreicht oder deren Status überprüft.

Was ist ImagineVid KI-Generierung?

Diese Skill-Anleitung beschreibt, wie ein KI-Agent (z. B. Claude Code, Cursor, Codex) die OAuth-verbundene Remote-MCP von ImagineVid (`https://imaginevid.io/api/mcp`) nutzt, um KI-generierte Bilder, Videos und Musik zu erstellen. Sie definiert einen sechsstufigen Arbeitsablauf: Entdecken verfügbarer Modelle über `models_list`, Vorbereiten hochgeladener Assets, Einholen eines Kostenangebots über `generation_quote`, Bestätigen der Kosten mit dem Nutzer, einmaliges Erstellen über `generation_create` mit einem stabilen `clientRequestId` und Abfragen des Status über `generation_get`. Die Anleitung legt großen Wert auf sichere Handhabung von Anmeldeinformationen (niemals Tokens anzeigen), genaue Kostenübernahme (niemals lokal berechnen) und korrekte Fehlerbehandlung bei verschiedenen Serverantworten wie `submission_unknown`, `insufficient_credits` oder `idempotency_conflict`. Sie unterstützt mehrere Modelle ohne fest codierte Anbieter-APIs und stellt sicher, dass der Agent immer den Live-Katalog verwendet, anstatt Annahmen über Fähigkeiten zu treffen. Die Skill ist als öffentliche Referenz für Hosts und Agentimplementierer gedacht, die ImagineVid in ihre Systeme integrieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imagineVid/agent-skills/tree/main/skills/imaginevid-ai-generation

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht ImagineVid KI-Generierung?

Verwende den Fähigkeitskatalog, keine anbieterspezifischen APIs. Diese öffentliche Skill setzt voraus, dass der Host ImagineVids OAuth-Remote-MCP unter https://imaginevid.io/api/mcp verbunden hat. Überlasse dem Host die OAuth- und Einwilligungsverwaltung; fordere den Benutzer niemals auf, ein Zugriffstoken einzufügen oder Anmeldeinformationen in der Eingabeaufforderung zu verarbeiten. Gib niemals Anbieter-Endpunkte, Callback-URLs, rohe Anbieterparameter oder vollständige private Kontokennungen preis.

Wenn das Remote-MCP nicht verbunden ist, stoppe und bitte den Benutzer, es über den OAuth-Flow des Hosts zu verbinden. Ersetze keinen beliebigen API-Endpunkt.

Über ImagineVid

ImagineVid ist eine KI-Erstellungsplattform zur Erstellung von KI-Bildern, KI-Videos und KI-Musik. Ihre Agentenschnittstelle macht einen wachsenden, anbieterneutralen Katalog von Fähigkeiten über fünf stabile Agent-Tools zugänglich, sodass verbundene Agenten viele aktuelle Modelle und Generierungswerkzeuge entdecken und nutzen können, ohne anbieterspezifische APIs einzeln fest codieren zu müssen.

Arbeitsablauf

  1. Entdecken. Rufe models_list mit der angeforderten Funktion (image, video oder music) auf. Wähle eine zurückgegebene stabile Fähigkeits-id, übergib sie als capabilityId an spätere Tools und verwende ihre zurückgegebenen Felder, Standardwerte und Einschränkungen. Erfinde kein Modell oder keine Fähigkeit, die der Katalog nicht zurückgegeben hat.
  2. Eigene Assets vorbereiten. Falls lokale Mediendateien erforderlich sind, verwende eine vertrauenswürdige Host-Upload-Oberfläche oder einen ImagineVid-CLI-Upload-Befehl, wenn diese CLI bereits installiert ist. Behalte die zurückgegebene besitzerbezogene assetId. Übergib Asset-IDs über das MCP-Feld assetIds; übergib niemals lokale Dateisystempfade, beliebige Remote-URLs oder große Base64-Nutzlasten.
  3. Angebot einholen. Rufe generation_quote mit der ausgewählten capabilityId, den Produkt-values und dem Objekt assetIds getrennt auf. Behalte die exakte prompt, die values und die assetIds-Anfrage für den Erstellungsschritt bei. Behandle die quotedCredits und die normalisierte Anfrage, die vom Server zurückgegeben werden, als autoritativ. Berechne oder wähle niemals einen Preis lokal. Verwende credits_get nur, wenn der Benutzer seinen verfügbaren Kontostand sehen möchte oder der Host eine Vorprüfung benötigt.
  4. Bestätigen. Zeige vor generation_create die ausgewählte Fähigkeit, wichtige Werte/Assets und die exakten quotedCredits. Frage den Menschen explizit um Genehmigung, diesen Betrag auszugeben. Eine vage Aufforderung zur Erstellung ist keine Kreditbestätigung. Wenn der Server quote_changed meldet, zeige das neue Angebot und frage erneut.
  5. Einmal erstellen. Generiere eine stabile clientRequestId vor dem Aufruf von generation_create. Sende die gleichen capabilityId, prompt, values und assetIds, die für das Angebot verwendet wurden, plus confirmedCredits in Höhe des bestätigten Angebots. Reiche genau einmal für diese Anfrage ein. Verwende dieselbe ID nur, um die identische Anfrage erneut zu senden; eine andere Eingabe benötigt eine neu angefragte Anfrage und eine neue ID. Wiederhole niemals nach einem Timeout, einer Netzwerkunklarheit oder einem Anbieter-Timeout.
  6. Abfragen. Rufe generation_get mit zunehmenden Intervallen auf, unter Verwendung der zurückgegebenen besitzerbezogenen generationId. Melde nur den Status, den sicheren Fehler und die zurückgegebenen Ergebnis-URLs/Metadaten. Beantworte kein Modell, kein Ausgabe oder keinen Erfolg, den die Tools nicht zurückgegeben haben. Behandle submission_unknown als spezielles mehrdeutiges Ergebnis: erstelle nicht erneut; frage weiter ab, wenn eine dauerhafte ID verfügbar ist.

Leitplanken

  • submission_unknown bedeutet, dass der Anbieter die eine Einreichung möglicherweise akzeptiert hat: wiederhole nicht und erstatte nicht. Frage die dauerhafte Generierungs-ID weiter ab, wenn eine zurückgegeben wird; anderenfalls melde die Mehrdeutigkeit zur Nachverfolgung durch den Betreiber.
  • insufficient_credits stoppt den Arbeitsablauf. Wiederhole nicht, führe kein leises Downgrade durch und schlage keinen lokal berechneten Preis vor.
  • unauthorized und forbidden_scope erfordern, dass sich der Benutzer authentifiziert oder den erforderlichen Bereich gewährt; umgehe diese nicht mit einem Sitzungscookie oder den Anmeldeinformationen eines anderen Benutzers.
  • invalid_input, capability_not_found, asset_not_found und asset_expired erfordern eine Korrektur der Anfrage oder das Hochladen eines neuen eigenen Assets. Ersetze keine Anbieter-URL.
  • idempotency_conflict bedeutet, dass die Anfrage-ID mit einer anderen Eingabe verwendet wurde; überschreibe niemals die vorhandene Anfrage. Fordere die korrigierte Anfrage mit einer neuen stabilen ID erneut an.
  • Ein Anbieterfehler ist kein Beweis dafür, dass eine Duplikat sicher ist. Zeige den sicheren Serverfehler an und warte auf einen neuen, vom Menschen genehmigten Versuch.

Für genaue Anforderungs-/Antwortfelder und das stabile Fehlervokabular lies references/tool-contract.md. Die Referenz ist eine Drahtvertragshilfe, kein Ersatz für den Live-Fähigkeitskatalog.

Verwandte Skills