AiVideoEditor
Commencez gratuitement
Menu

Vérifié le 2026-11-11 · Version API 2026-11-09 · Lire le Markdown

Publication et planification

Une publication AiVideoEditor possède un brouillon versionné et des livraisons indépendantes pour ses comptes sélectionnés. L'enregistrement des brouillons est permissif ; un enregistrement réussi n'établit pas que chaque destination est publiable.

Préparer une publication

  1. Lisez /api/v1/accounts et /api/v1/capabilities avec la clé prévue.
  2. Téléversez et finalisez tout média requis.
  3. Créez un brouillon avec POST /api/v1/posts, ou modifiez avec PATCH /api/v1/posts/{id}. Fournissez le expectedVersion actuel lors des modifications et conservez la version retournée.
  4. Définissez le format de destination et les overrides explicites de variante par compte si nécessaire. La référence API définit les champs de requête.
  5. Validez avec POST /api/v1/posts/{id}/validate. Un HTTP 200 peut contenir valid: false ; inspectez chaque problème avant de soumettre. Les comptes invalides ne sont pas retirés silencieusement de l'audience.

Publier maintenant ou plus tard

POST /posts/{id}/publish soumet le brouillon actuel. POST /posts/{id}/schedule requiert scheduledAt, timezone et expectedVersion. L'instant planifié doit être futur et dans les 90 jours. Stockez un horodatage ISO UTC et un fuseau horaire d'affichage IANA séparé ; résolvez les ambiguïtés d'heure d'été avant l'envoi.

Utilisez une Idempotency-Key distincte pour chaque nouvelle mutation. Conservez cette clé et le corps de requête exact avant l'envoi. Après un timeout, rejouez la requête identique avec la même clé. Ne changez la clé que lorsque vous demandez intentionnellement une nouvelle opération. Une modification ou planification de brouillon obsolète renvoie revision_conflict ; relisez et examinez le contenu le plus récent plutôt que de l'écraser aveuglément.

Une réponse 202 signifie accepté pour envoi. Ce n'est pas une preuve de publication. Enregistrez les IDs de livraison et observez GET /posts/{id} ou les webhooks client signés. Utilisez un polling borné avec des délais croissants ; arrêtez-vous sur des résultats terminaux ou un handoff humain plutôt que de boucler indéfiniment.

Résultats par destination

Les livraisons peuvent se conclure indépendamment. Une destination peut publier tandis qu'une autre nécessite une reconnexion ou un consentement. Affichez chaque état et le lien de publication natif lorsqu'il existe. Retentez uniquement un échec connu éligible avec POST /deliveries/{id}/retry. Les destinations réussies ne doivent pas être recréées pour récupérer une destination en échec. Un résultat externe inconnu nécessite une réconciliation ou une revue, pas une soumission neuve.

Annulez avec POST /deliveries/{id}/cancel tant que le travail reste en sécurité sans être revendiqué. too_late_to_cancel signifie que la soumission a progressé au-delà d'une annulation sûre ; cela ne signifie pas que la publication externe a été retirée.

Revue humaine TikTok

Lisez /accounts/{id}/tiktok/settings pour connaître les réglages actuels du créateur et les choix de confidentialité disponibles. Une lecture des réglages ou un enregistrement de brouillon ne fournit pas le consentement. consent_required inclut un handoff requiresAction sûr vers le composer authentifié. Une personne autorisée examine la vidéo exacte, la légende et la destination et confirme explicitement les choix requis à cet endroit. Les clés de produit et les outils MCP ne peuvent pas confirmer à sa place. Les changements de contenu ou d'identité requièrent une nouvelle revue. Le handoff n'accorde par lui-même ni appartenance ni accès.

Contrôles du composer

Utilisez Ajouter un média pour téléverser un fichier ou choisir un élément existant de la bibliothèque. La légende est partagée jusqu'à ce que Personnaliser le contenu crée une variante spécifique au compte. Les outils emoji et hashtag insèrent du texte ordinaire au curseur.

Options de publication regroupe les réglages du compte sélectionné. Les choix requis restent visibles ; les groupes optionnels restent repliés. Les modifications ne s'appliquent qu'à ce compte. Aperçu affiche le brouillon effectif sans l'enregistrer ni le soumettre, y compris les brouillons incomplets ; la présentation native de la plateforme peut différer.

Utilisez des références d'assets privés pour les couvertures et miniatures planifiées. Les alternatives d'URL publiques doivent rester joignables au moment de la livraison. Le contenu des sous-titres est stocké avec les réglages immuables plutôt que de dépendre d'un fichier local temporaire. Le téléversement de documents LinkedIn accepte actuellement le PDF ; les formats Office restent restreints tant que la validation de signature n'est pas implémentée.

Voir la référence des capacités pour les contrôles canoniques et les limites d'intégration. Le nouveau comportement de format et de confirmation requiert les migrations de base de données correspondantes avant le déploiement.