openclip-ugc-ads

OpenClip: UGC-Anzeigenerstellung

generate_ugc rendert einen kurzen vertikalen UGC-Clip (ca. 7 bis 12 Sekunden) aus einer Creative Brief. Kostenlose Konten erhalten EINE Generierung pro Tag. Kostenpflichtige Konten werden in Credits nach den gerenderten Sekunden abgerechnet.

Rendervorgänge sind rechenintensiv. Rechnen Sie mit einigen Minuten pro Clip, nicht mit Sekunden.

Einrichtung (einmalig)

OpenClip ist ein entfernter MCP-Server unter https://openclip.app/mcp. Melden Sie sich mit Ihrem OpenClip-Konto an, wenn die OAuth-Aufforderung erscheint. Es gibt keinen API-Key zum Kopieren.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, dann /mcp zur Autorisierung.
• Claude Desktop / Web: Einstellungen, Connectors, "Benutzerdefinierten Connector hinzufügen", URL einfügen, anmelden.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Nur-Header-Clients: Minten Sie ein MCP-Token unter openclip.app/settings/connect und verbinden Sie sich mit https://openclip.app/mcp/key mit Authorization: Bearer <token>.

Kurzer Test: Rufen Sie get_account auf.

Der Ablauf

1. Rufen Sie ZUERST den Creator-Roster ab. list_ugc_creators gibt die gültigen creator- und start_frame-Werte für dieses Team zurück: einen kuratierten Roster plus die eigenen gespeicherten Creator des Teams, gruppiert nach Nische. Erraten Sie niemals einen Creator-Namen, wählen Sie einen aus diesem Aufruf.
2. Generieren. generate_ugc(...) entweder mit:
   • brief_name – ein serverseitiger Voreinstellung, die schnelle Methode, oder
   • brief – einem Inline-Objekt mit strukturierten kreativen Feldern (character und weitere).
3. Abfragen. Gibt eine ugc_job-Hash-ID zurück. Fragen Sie get_ugc_job_status(ugc_job) alle 10 bis 15 Sekunden ab. queued / rendering bedeuten, dass der Job läuft. completed gibt video_url plus result_meta (Dauer, Abmessungen, fps, Seed) zurück. failed gibt error zurück.
4. Frühere Arbeiten ansehen. list_ugc_jobs listet die vorherigen UGC-Clips eines Teams auf und ist der Weg, um eine ugc_job-ID zu finden, die Sie abfragen können, falls Sie sie verloren haben.

Die Brief ist strukturiert, kein Prompt

Das ist der Punkt, den Agenten am häufigsten falsch machen. brief ist kein Prosa-Prompt. Es ist ein Objekt mit einzelnen kreativen Feldern (character und die anderen Felder, die die API akzeptiert). Das Schreiben eines Absatzes in ein Feld verschwendet die Struktur und erzeugt Matsch.

Schreiben Sie jedes Feld als konkretes, physisches, filmbares Detail:

• Nennen Sie, was im Bild zu sehen ist, nicht wie es sich anfühlen soll. "Hält die Flasche auf Brusthöhe, Küchentheke dahinter" ist besser als "energetische und ambitionierte Stimmung".
• Eine Idee pro Feld. Stapeln Sie nicht drei Handlungen in character.
• Einschränkungen erzeugen bessere Ergebnisse als Adjektive. Eine bestimmte Umgebung, ein bestimmtes Requisit und eine bestimmte Aktion sind besser als "hochwertig, professionell, ansprechend".

Testen von Anzeigenansätzen

Wenn der Benutzer Variationen und nicht nur einen Clip möchte, ändern Sie EINE Variable pro Rendering, damit der Vergleich aussagekräftig ist:

• Gleicher Creator, anderer Hook.
• Gleicher Hook, anderer Creator, wenn Sie testen, wer die Botschaft am besten rüberbringt.
• Alles gleich, andere start_frame, wenn Sie den Thumbnail-Moment testen.

Kostenlose Konten erhalten eine Generierung pro Tag. Geben Sie diese bei einem kostenlosen Konto für den am stärksten abweichenden Ansatz aus, anstatt für eine nahezu identische Kopie. Prüfen Sie get_account, bevor Sie einen Batch versprechen.

Regeln

• Rufen Sie list_ugc_creators vor jeder ersten Generierung in einer Sitzung auf. Der Roster ist teamspezifisch und ändert sich.
• Fragen Sie immer ab. Renderings dauern Minuten, generate_ugc kehrt sofort zurück.
• Clips sind von Natur aus kurz, etwa 7 bis 12 Sekunden. Versprechen Sie keine 60-Sekunden-Anzeige.
• Kostenlose Stufe: EINE Generierung pro Tag. Sagen Sie das, bevor der Benutzer einen Batch auf einem kostenlosen Konto plant.
• result_meta enthält den seed. Behalten Sie ihn, wenn dem Benutzer ein Rendering gefallen hat und er eine ähnliche Variante wünscht.

Fehler

Tool-Fehler werden als Tool-Ergebnis mit isError: true und einer Klartext-Nachricht zurückgegeben, nicht als HTTP-Status. "Not authenticated. Reconnect your OpenClip token." bedeutet, dass Sie das Token erneut verbinden oder neu ausstellen müssen. Validierungsmeldungen (ein unbekannter Creator, eine fehlerhafte Brief) werden als Nachrichtentext zurückgegeben; korrigieren Sie das Argument und wiederholen Sie den Vorgang.

Beispielhafte Aktionen zu Prompts

• "Erstelle eine UGC-Anzeige für meine App" – list_ugc_creators, passenden Creator auswählen, generate_ugc(brief={...}), get_ugc_job_status abfragen, video_url zurückgeben.
• "Gib mir drei Ansätze zum Testen" – ein Rendering pro Ansatz, jedes Mal eine Variable geändert, jedes abfragen. Prüfen Sie zuerst das Tageslimit bei einem kostenlosen Konto.
• "Verwende dasselbe Mädchen wie beim letzten Mal" – list_ugc_jobs, um den vorherigen Job zu finden, seinen Creator auslesen, wiederverwenden.
• "Welche Creator kann ich verwenden?" – list_ugc_creators, nach Nische gruppiert anzeigen.

Verwandtes

Zuschneiden von echtem Langzeitmaterial in Kurzformate: openclip-clipping. Kostenloses Trimmen, Zuschneiden und Komprimieren des generierten Clips: openclip-video-editing.