img_uuid und holen Sie das Ergebnis per Polling oder HTTPS-Callback ab.AI-Videoeffekt-API für automatisierte Kreativ-Workflows
Nutzen Sie AI-Videoeffekte über die unabhängige GoEnhance API. Rufen Sie die verfügbaren Vorlagen ab, senden Sie ein freigegebenes Referenzbild zusammen mit einer Effekt-ID, speichern Sie die zurückgegebene
API-Key erstellen
Funktionen der AI-Videoeffekt-API
Verfügbare Effekte entdecken
Rufen Sie GET /api/v1/videoeffect/list mit Bearer-Authentifizierung auf, um aktuelle Effekt-IDs, Bezeichnungen und Vorschau-URLs zu erhalten, statt einen veralteten Katalog fest im Code zu hinterlegen.
Aufgabe erzeugen und verfolgen
Senden Sie ein öffentlich erreichbares reference_img und eine gültige effect_id per POST an /api/v1/videoeffect/generate und speichern Sie anschließend die zurückgegebene img_uuid für Statusabfragen.
Prüfen Sie Zugangsdaten, Medienzugriff, Vorlagenkennung und Callback-Konfiguration, bevor Sie eine Aufgabe anlegen.
Wichtige Bestandteile einer AI-Videoeffekt-API-Anfrage
Bearer-Authentifizierung
Senden Sie Ihren GoEnhance API-Key im <code>Authorization</code>-Header und halten Sie ihn ausschließlich serverseitig, niemals im Client-Code.
Vorlagen abrufen
Nutzen Sie <code>GET /api/v1/videoeffect/list</code>, um den aktuellen Katalog abzurufen, bevor Sie Effektoptionen in Ihrem Produkt anzeigen.
Referenzbild
Geben Sie in <code>reference_img</code> eine öffentlich erreichbare HTTPS-Bild-URL an und verwenden Sie nur Material, das Ihnen gehört oder dessen Verarbeitung Ihnen gestattet ist.
Effekt-Kennung
Übergeben Sie die exakte <code>effect_id</code> der gewählten Vorlage und prüfen Sie sie gegen die aktuelle Listen-Antwort, statt Kennungen zu erraten.
Optionaler Callback
Geben Sie <code>custom_callback_url</code> an, wenn Statusbenachrichtigungen an einen öffentlichen HTTPS-Endpunkt gesendet werden sollen.
Asynchrone Aufgaben-ID
Speichern Sie <code>data.img_uuid</code> aus einer erfolgreichen Sendeantwort dauerhaft und verknüpfen Sie sie mit Ihrem internen Anfragedatensatz.
Verlassen Sie sich auf aktuelle Vorlagendaten und Dokumentation statt auf einen erfundenen oder veralteten Einheitspreis.
Preise der AI-Videoeffekt-API
Preise je nach Effekt
Die Preise der AI-Videoeffekt-API hängen von der gewählten Vorlage und vom aktuellen GoEnhance-Katalog ab. Gehen Sie nicht von einem festen Einheitspreis für jeden Effekt aus.
Aktuellen Katalog prüfen
Nutzen Sie die Vorlagenlisten-API und die aktuelle GoEnhance-Dokumentation als maßgebliche Quelle für den Effekt, den Sie ausführen möchten.
Kosten vor dem Senden kalkulieren
Klären Sie die gewählte <code>effect_id</code> und deren aktuelle Abrechnungsdetails, bevor Sie Produktionsstapel einreihen, denn Katalogkonditionen können sich ändern.
AI-Videoeffekte in drei Schritten integrieren
1
1. Abrufen und prüfen
Holen Sie die Effektliste, wählen Sie eine exakte
effect_id und stellen Sie sicher, dass Ihr HTTPS-Referenzbild erreichbar und zur Verarbeitung freigegeben ist. 2
2. Senden und speichern
Senden Sie
reference_img, effect_id und optional eine Callback-URL per POST und speichern Sie danach data.img_uuid aus der Antwort. 3
3. Endergebnis abholen
Fragen Sie
GET /api/v1/jobs/detail?img_uuid=... per Polling ab oder verarbeiten Sie Callback-Inhalte idempotent, bis die Aufgabe success oder failed erreicht.Bauen Sie wiederholbare Effekt-Workflows rund um Inhalte auf, die Ihnen gehören oder deren Bearbeitung Ihnen erlaubt ist.
Anwendungsfälle der AI-Videoeffekt-API
Creator-Tools
Lassen Sie Nutzer freigegebene Effekte auswählen und verwandeln Sie autorisierte Standbilder direkt in Ihrer Anwendung in kurze bewegte Assets.
Kampagnenvarianten
Reihen Sie Effektvarianten für Marketingideen ein, während Rechteklärung, Moderation und Freigabe in Ihrem eigenen Workflow bleiben.
UGC-Pipelines
Verbinden Sie Uploads, Effektauswahl, asynchrone Verarbeitung und Ergebnisauslieferung in einer nachvollziehbaren Backend-Pipeline.
Unterhaltungserlebnisse
Bauen Sie freiwillig aktivierbare Spaß- und Themenanimationen mit klarer Einwilligung und Prüfung der Inhaltsrichtlinien.
Kreativarbeit im Stapelbetrieb
Speichern Sie Aufgaben-IDs und verarbeiten Sie Endergebnisse unabhängig, damit sich Stapel nach Zeitüberschreitungen ohne doppelte Übermittlung erholen können.
Medienautomatisierung
Leiten Sie fertige Videos erst nach Prüfung der finalen Antwort in Speicher-, Sichtungs-, Moderations- und Publishing-Systeme weiter.
Antworten zu Endpunkten, Preisen, Eingaben, asynchroner Auslieferung und Schutzmaßnahmen im Produktivbetrieb.