# Publica video en YouTube, Instagram, Facebook y Threads URL canónica: https://sosoapi.ai/es/docs/video-publishing Carga tu video una vez y prepara una publicación para cada destino. Esta guía cubre comprobaciones multimedia, opciones de plataforma, privacidad de YouTube y cómo comprobar si se publicó. Contrato de publicación revisado el 20 de octubre de 2026. ## 1. Prepara un recurso de video listo Carga un video local o importa una URL pública de video a tu espacio de trabajo. Comprueba esa carga o importación hasta que esté lista y usa el asset_id registrado y la asset_url canónica en tu publicación. SosoAPI comprueba el contenedor, la duración, las dimensiones y los códecs reales del video cuando la plataforma lo exige. Un nombre de archivo, un tipo MIME proporcionado por el solicitante o una vista previa reproducible no bastan para acreditar la elegibilidad. Comprueba tus derechos sobre el video y el audio, y cualquier aviso obligatorio, antes de programar. - Mantén el video original y los recursos de portada en el mismo espacio de trabajo autorizado. - Comprueba la elegibilidad del borrador completo para la cuenta exacta y el formato previsto. - Si la preparación falla, consulta su estado existente; no inicies importaciones duplicadas solo porque una respuesta tarde. ## 2. Elige el formato de video del destino Elige el formato y las opciones admitidos por la cuenta de destino. Puedes reutilizar un recurso listo, pero cada plataforma necesita su propio provider_payload. Opciones de publicación de video | Destino | Selección de provider_payload | Revisa antes de programar | | --- | --- | --- | | Instagram | platform: instagram; VIDEO, REELS o STORY_VIDEO según corresponda. | Cuenta profesional y capacidades observadas; Stories necesita elegibilidad Business. Las opciones específicas de Reels deben quedarse en Reels. | | Página de Facebook | platform: facebook; VIDEO, REELS o STORY_VIDEO según corresponda. | Identidad de página, permiso de publicación y tarea CREATE_CONTENT; opciones de archivos multimedia y formatos admitidos. | | Threads | platform: threads; VIDEO. | Cuenta elegible para publicación y video listo; los adjuntos exclusivos de texto no se aplican a un payload VIDEO. | | Canal de YouTube | platform: youtube; VIDEO. | Título, categoría, privacidad y modo de cancelación explícitos; permiso de gestión para programación nativa. | ## 3. Programa un video revisado para YouTube Usa la función auxiliar de servidor de la referencia API. Sustituye asset_id por el entero positivo registrado y asset_url por su URL canónica. Selecciona el ID real de cuenta del canal y una hora futura de publicación. Este ejemplo solicita publicación pública a la hora elegida. Confirma esa visibilidad con el usuario antes de ejecutarlo. Configura contains_synthetic_media según el video; false es solo un ejemplo. UNSCHEDULE_KEEP_PRIVATE solicita a YouTube mantener privada una programación nativa sin publicar si se cancela. ``` await sosoPost("/studio-api/scheduled-posts/create", { "workspace_id": "", "social_account_id": "", "caption": null, "hashtags": [], "media": [ { "kind": "video", "asset_id": "", "url": "" } ], "provider_payload": { "platform": "youtube", "publish_options": { "post_type": "VIDEO", "title": "A reviewed product walkthrough", "description": "Our team introduces the product in one short walkthrough.", "category_id": "24", "privacy_status": "public", "cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE", "contains_synthetic_media": false } }, "scheduled_at": "", "display_timezone": "Asia/Hong_Kong", "idempotency_key": "" }); ``` - [Referencia de API de publicación](https://sosoapi.ai/es/docs/publishing-api-reference) ## 4. Explicita la privacidad, Shorts y los límites del proveedor Usa post_type VIDEO para YouTube. Puedes establecer surface_expectation: SHORT, pero YouTube sigue decidiendo si la carga cumple los requisitos de un Short. Un nombre de archivo o la orientación vertical por sí solos no lo acreditan. El permiso de carga y el permiso para gestionar programaciones nativas son independientes. Comprueba si el canal admite funciones opcionales como miniaturas; su disponibilidad puede ser desconocida. La referencia de carga de Google explica los requisitos de autorización y metadatos; SosoAPI también comprueba sus propios campos admitidos y la cuenta conectada. YouTube y otras plataformas pueden tardar en procesar o moderar un video y sus cuotas siguen aplicándose. Una carga aceptada no significa que el video sea visible públicamente. - [Google: referencia de YouTube videos.insert](https://developers.google.com/youtube/data/reference/rest/v3/videos/insert) - [Matriz de capacidades de cuentas y formatos](https://sosoapi.ai/es/docs/publishing-capabilities) ## 5. Verifica el resultado final de la misma publicación Guarda el ID de publicación programada y comprueba su entrega y resultado final. Abre el enlace del proveedor cuando esté disponible. Programado o publicando significa que el resultado final sigue pendiente. Una programación aceptada continúa en el servidor si se desconecta tu cliente. Consulta la misma publicación antes de cambiar nada. Para cancelar, usa su versión actual y una acción de cancelación disponible. Eliminar un video ya publicado sigue otras reglas. Comprueba los requisitos de cada destino al reutilizar un video entre plataformas. Estos ejemplos muestran formatos de solicitud; no ejecutan ni publican un video desde esta página. - [Flujo de revisión con tu propio agente](https://sosoapi.ai/es/docs/claude-code-codex-social-publishing) - [Referencia de API de publicación](https://sosoapi.ai/es/docs/publishing-api-reference)