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
- Lies
/api/v1/accountsund/api/v1/capabilitiesmit dem vorgesehenen Key. - Lade benötigte Medien hoch und finalisiere sie.
- Erstelle einen Entwurf mit
POST /api/v1/posts, oder bearbeite ihn mitPATCH /api/v1/posts/{id}. Gib bei Bearbeitungen die aktuelleexpectedVersionan und bewahre die zurückgegebene Version auf. - Lege das Zielformat und bei Bedarf explizite Overrides pro Konto fest. Die API-Referenz definiert die Anfragefelder.
- Validiere mit
POST /api/v1/posts/{id}/validate. HTTP 200 kannvalid: falseenthalten; 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.