AiVideoEditor
Empieza gratis
Menú

Revisada el 2026-11-11 · Versión de API 2026-11-09 · Leer Markdown

Publicación y programación

Una publicación de AiVideoEditor tiene un borrador versionado y entregas independientes para sus cuentas seleccionadas. Guardar borradores es permisivo; un guardado exitoso no establece que cada destino sea publicable.

Preparar una publicación

  1. Lee /api/v1/accounts y /api/v1/capabilities con la clave prevista.
  2. Sube y finaliza los medios requeridos.
  3. Crea un borrador con POST /api/v1/posts, o edítalo con PATCH /api/v1/posts/{id}. Suministra el expectedVersion actual en las ediciones y conserva la versión devuelta.
  4. Establece el formato de destino y las anulaciones explícitas de variante por cuenta donde sea necesario. La referencia de la API define los campos de la solicitud.
  5. Valida con POST /api/v1/posts/{id}/validate. Un HTTP 200 puede contener valid: false; inspecciona cada problema antes de enviar. Las cuentas inválidas no se eliminan silenciosamente de la audiencia.

Publicar ahora o más tarde

POST /posts/{id}/publish envía el borrador actual. POST /posts/{id}/schedule requiere scheduledAt, timezone y expectedVersion. El instante programado debe ser futuro y estar dentro de 90 días. Almacena una marca de tiempo UTC ISO y una zona horaria IANA de visualización separada; resuelve las ambigüedades del horario de verano antes de enviar.

Usa una Idempotency-Key distinta para cada mutación nueva. Conserva esa clave y el cuerpo exacto de la solicitud antes de enviar. Tras un timeout, reproduce la solicitud idéntica con la misma clave. Cambia la clave solo cuando solicites intencionalmente una nueva operación. Una edición o programación de un borrador obsoleto devuelve revision_conflict; vuelve a leer y revisa el contenido más reciente en lugar de sobrescribirlo a ciegas.

Una respuesta 202 significa aceptado para despacho. No es evidencia de publicación. Registra los IDs de entrega y observa GET /posts/{id} o webhooks de cliente firmados. Usa sondeos acotados con retrasos crecientes; detente ante resultados terminales o un traspaso humano en lugar de iterar indefinidamente.

Resultados por destino

Las entregas pueden resolverse de forma independiente. Un destino puede publicarse mientras otro necesita reconexión o consentimiento. Muestra cada estado y el enlace nativo de la publicación cuando exista. Reintenta solo un fallo conocido elegible usando POST /deliveries/{id}/retry. Los destinos exitosos no deben recrearse para recuperar uno fallido. Un resultado externo desconocido necesita conciliación o revisión, no un envío nuevo.

Cancela con POST /deliveries/{id}/cancel mientras el trabajo siga seguramente sin reclamar. too_late_to_cancel significa que el envío ha progresado más allá de la cancelación segura; no significa que la publicación externa haya sido eliminada.

Revisión humana de TikTok

Lee /accounts/{id}/tiktok/settings para conocer la configuración actual del creador y las opciones de privacidad disponibles. Una lectura de configuración o un guardado de borrador no proporciona el consentimiento. consent_required incluye un traspaso seguro requiresAction al compositor autenticado. Una persona autorizada revisa el vídeo exacto, el subtítulo y el destino, y confirma explícitamente allí las opciones requeridas. Las claves de producto y las herramientas MCP no pueden confirmar en su nombre. Los cambios de contenido o de identidad requieren una revisión nueva. El traspaso no concede membresía ni acceso por sí mismo.

Controles del compositor

Usa Añadir medios para subir un archivo o elegir un elemento existente de la biblioteca. El subtítulo se comparte hasta que Personalizar contenido crea una variante específica de la cuenta. Las herramientas de emoji y hashtags insertan texto ordinario en el cursor.

Opciones de publicación agrupa la configuración de la cuenta seleccionada. Las opciones requeridas permanecen visibles; los grupos opcionales permanecen colapsados. Los cambios se aplican solo a esa cuenta. Vista previa muestra el borrador efectivo sin guardarlo ni enviarlo, incluidos los borradores incompletos; la presentación nativa de la plataforma puede diferir.

Usa referencias de recursos privados para las portadas y miniaturas programadas. Las alternativas de URL públicas deben seguir accesibles en el momento de la entrega. El contenido de los subtítulos se almacena con la configuración inmutable en lugar de depender de un archivo local temporal. La subida de documentos de LinkedIn acepta actualmente PDF; los formatos Office siguen restringidos hasta que se implemente la validación de firmas.

Consulta la referencia de capacidades para los controles canónicos y los límites de integración. El nuevo comportamiento de formatos y confirmación requiere las migraciones de base de datos correspondientes antes del despliegue.