AiVideoEditor
Kostenlos starten
Menü

Geprüft am 2026-11-11 · API-Version 2026-11-09 · Markdown lesen

Veröffentlichen und Planen

Ein AiVideoEditor-Beitrag hat einen versionierten Entwurf und unabhängige Zustellungen für seine ausgewählten Konten. Das Speichern von Entwürfen ist großzügig; erfolgreiches Speichern stellt nicht sicher, dass jedes Ziel veröffentlicht werden kann.

Einen Beitrag vorbereiten

  1. Lies /api/v1/accounts und /api/v1/capabilities mit dem vorgesehenen Key.
  2. Lade benötigte Medien hoch und finalisiere sie.
  3. Erstelle einen Entwurf mit POST /api/v1/posts, oder bearbeite ihn mit PATCH /api/v1/posts/{id}. Gib bei Bearbeitungen die aktuelle expectedVersion an und bewahre die zurückgegebene Version auf.
  4. Lege das Zielformat und bei Bedarf explizite Overrides pro Konto fest. Die API-Referenz definiert die Anfragefelder.
  5. Validiere mit POST /api/v1/posts/{id}/validate. HTTP 200 kann valid: false enthalten; prüfe jedes Problem vor dem Absenden. Ungültige Konten werden nicht still aus der Zielgruppe entfernt.

Jetzt oder später veröffentlichen

POST /posts/{id}/publish sendet den aktuellen Entwurf. POST /posts/{id}/schedule erfordert scheduledAt, timezone und expectedVersion. Der geplante Zeitpunkt muss in der Zukunft liegen und innerhalb von 90 Tagen. Speichere einen UTC-ISO-Zeitstempel und eine separate IANA- Anzeigezeitzone; löse Mehrdeutigkeiten durch die Sommerzeit vor dem Senden auf.

Verwende einen eigenen Idempotency-Key für jede neue Mutation. Bewahre diesen Key und den exakten Anfrage-Body vor dem Senden auf. Nach einem Timeout wiederhole die identische Anfrage mit demselben Key. Ändere den Key nur, wenn du bewusst eine neue Operation anforderst. Eine veraltete Entwurfsbearbeitung oder Planung liefert revision_conflict; lies den neuesten Inhalt erneut und prüfe ihn, statt ihn blind zu überschreiben.

Eine 202-Antwort bedeutet: zur Zustellung angenommen. Sie ist kein Beleg für eine Veröffentlichung. Zeichne Zustellungs-IDs auf und beobachte GET /posts/{id} oder signierte Kunden-Webhooks. Verwende begrenztes Polling mit zunehmenden Verzögerungen; stoppe bei terminalen Ergebnissen oder einer menschlichen Übergabe, statt endlos in einer Schleife zu laufen.

Ergebnisse pro Ziel

Zustellungen können sich unabhängig entwickeln. Ein Ziel kann veröffentlichen, während ein anderes eine erneute Verbindung oder Zustimmung benötigt. Zeige jeden Zustand und den nativen Beitragslink an, wenn vorhanden. Wiederhole nur einen berechtigten bekannten Fehler mit POST /deliveries/{id}/retry. Erfolgreiche Ziele dürfen nicht neu erstellt werden, um ein fehlgeschlagenes wiederherzustellen. Ein unbekanntes externes Ergebnis erfordert Abstimmung oder Prüfung, keine neue Übermittlung.

Brich mit POST /deliveries/{id}/cancel ab, solange die Arbeit sicher nicht in Anspruch genommen wurde. too_late_to_cancel bedeutet, dass die Übermittlung bereits über die sichere Abbruchgrenze hinaus fortgeschritten ist; es bedeutet nicht, dass der externe Beitrag entfernt wurde.

Menschliche Prüfung bei TikTok

Lies /accounts/{id}/tiktok/settings für aktuelle Creator-Einstellungen und verfügbare Datenschutz-Auswahlen. Ein Einstellungsabruf oder das Speichern eines Entwurfs stellt keine Zustimmung bereit. consent_required enthält eine sichere requiresAction-Übergabe an den authentifizierten Composer. Eine autorisierte Person prüft dort das exakte Video, den Beitragstext und das Ziel und bestätigt ausdrücklich die erforderlichen Auswahlen. Produktkeys und MCP-Tools können nicht in ihrem Namen bestätigen. Inhalts- oder Identitätsänderungen erfordern eine erneute Prüfung. Die Übergabe gewährt für sich allein keine Mitgliedschaft oder keinen Zugriff.

Composer-Steuerung

Verwende Medium hinzufügen, um eine Datei hochzuladen oder ein vorhandenes Bibliothekselement auszuwählen. Der Beitragstext wird geteilt, bis Inhalt anpassen eine kontospezifische Variante erstellt. Emoji- und Hashtag-Werkzeuge fügen gewöhnlichen Text an der Cursorposition ein.

Beitragsoptionen gruppiert Einstellungen für das ausgewählte Konto. Erforderliche Auswahlen bleiben sichtbar; optionale Gruppen bleiben eingeklappt. Änderungen gelten nur für dieses Konto. Vorschau zeigt den effektiven Entwurf ohne ihn zu speichern oder abzusenden, einschließlich unvollständiger Entwürfe; die native Darstellung der Plattform kann abweichen.

Verwende private Asset-Referenzen für geplante Cover und Thumbnails. Alternativen mit öffentlichen URLs müssen zum Zustellungszeitpunkt erreichbar bleiben. Untertitel-Inhalte werden mit den unveränderlichen Einstellungen gespeichert, statt von einer temporären lokalen Datei abzuhängen. Der LinkedIn-Dokument-Upload akzeptiert derzeit PDF; Office-Formate bleiben eingeschränkt, bis die Signaturvalidierung implementiert ist.

Siehe die Capabilities-Referenz für kanonische Steuerungen und Integrations-Limits. Neues Format- und Bestätigungsverhalten erfordert vor dem Deployment die entsprechenden Datenbankmigrationen.