API de Publicación en Redes Sociales

API de Publicación en Redes Sociales

Usa la API de Publicación en Redes Sociales para conectar cuentas de redes sociales y publicar clips de WayinVideo directamente en esas cuentas.

Esta API está diseñada para clips exportados generados por Clipping con IA y Buscar Momentos. Primero crea clips con una de esas APIs y asegúrate de que el proyecto original se haya enviado con enable_export = true. Después usa el project_id resultante y el idx del clip al crear una tarea de publicación.

Flujo típico:

1. Crea una URL de autorización OAuth para la plataforma que quieres conectar.
2. Abre el auth_url devuelto en un navegador y completa la autorización.
3. Llama al endpoint de cuentas para confirmar la cuenta conectada y copiar su id.
4. Crea una tarea de publicación con el clip de destino y la configuración específica de la cuenta.

Todos los endpoints requieren:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
x-wayinvideo-api-version: v2

Facturación: Durante el periodo promocional por tiempo limitado, conectar correctamente una cuenta de red social consume actualmente 10 API Units. Si la autorización no se completa correctamente, no se descuentan API Units.

Endpoints

Conectar una Cuenta de Red Social

Crea una URL de autorización OAuth para la plataforma que quieres conectar.

POST https://wayinvideo-api.wayin.ai/api/v2/social-media/oauth/{platform}

Parámetros de Ruta

Cuerpo de la Solicitud

No se requiere cuerpo de solicitud.

Ejemplo de Solicitud

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/social-media/oauth/youtube \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2" \
  --data ''

Ejemplo de Respuesta

{
  "data": {
    "auth_url": "https://example.com/oauth2/auth?xxxxxx",
    "state": "a49bc736-xxxxx"
  }
}

Campos de Respuesta

Notas

• Cada auth_url solo puede usarse una vez. Si la autorización falla o la URL caduca, llama de nuevo a este endpoint para crear una URL nueva.
• Cuando la autorización se complete correctamente, llama a Listar Cuentas de Redes Sociales para confirmar que la cuenta está disponible para publicar.
• Puedes conectar varias cuentas en la misma plataforma. Por ejemplo, llama varias veces al endpoint OAuth de YouTube para conectar varios canales de YouTube.
• Si la cuenta no se conecta correctamente, no se descuentan API Units.

Listar Cuentas de Redes Sociales

Obtén todas las cuentas de redes sociales conectadas al propietario de la API key actual. Usa este endpoint antes de publicar para encontrar los valores de id que se usan en publish_configs.

GET https://wayinvideo-api.wayin.ai/api/v2/social-media/accounts?active_only={active_only}

Parámetros de Consulta

Ejemplo de Solicitud

curl -X GET "https://wayinvideo-api.wayin.ai/api/v2/social-media/accounts?active_only=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2"

Respuesta Cuando No Hay Ninguna Cuenta Conectada

{
  "data": []
}

Si data está vacío, llama primero a Conectar una Cuenta de Red Social.

Respuesta Cuando Hay Cuentas Conectadas

{
  "data": [
    {
      "id": "smaccxxx",
      "platform": "youtube",
      "platform_username": "MyChannel",
      "platform_avatar": "https://example.com/avatar.jpg",
      "token_valid": true,
      "token_expiring_soon": false
    }
  ]
}

Campos de Respuesta

Uso Recomendado

• Antes de crear una tarea de publicación, confirma que la cuenta de destino tenga token_valid: true.

Crear una Tarea de Publicación

Publica un clip en una o más cuentas de redes sociales conectadas. Identifica el clip enviando el ID del proyecto y el índice del clip.

Obligatorio: El project_id debe provenir de una tarea de Clipping con IA o Buscar Momentos enviada con enable_export = true. La publicación social requiere un video de clip exportado; los proyectos creados sin exportación habilitada no se pueden publicar con este endpoint.

POST https://wayinvideo-api.wayin.ai/api/v2/social-media/publish

Campos de Solicitud

Cómo generar un valor scheduled_at

scheduled_at es un timestamp Unix en milisegundos. Debe estar al menos 5 minutos en el futuro y no más de 30 días en el futuro.

Para programar la publicación 10 minutos desde ahora en JavaScript:

const scheduledAt = Date.now() + 10 * 60 * 1000;

Para programar una hora específica:

const scheduledAt = new Date('2026-06-15T10:00:00Z').getTime();

Configuración de Publicación de Plataforma

Cada valor dentro de publish_configs es un objeto de configuración de publicación específico de la plataforma.

Importante: Las claves dentro de publish_configs deben ser IDs de cuenta devueltos por /api/v2/social-media/accounts, como smacct06ixxxxxxx. No uses youtube, tiktok ni otros nombres de plataforma como claves.

Ejemplo de Solicitud

curl -sS -X POST https://wayinvideo-api.wayin.ai/api/v2/social-media/publish \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "project_id": "prj06ixxxxxxx",
    "idx": 0,
    "resolution": "1080p",
    "publish_configs": {
      "smacct06ixxxxxxx": {
        "title": "API Test Video",
        "description": "Posted by curl test",
        "tags": ["api", "test"],
        "visibility": "public"
      }
    },
    "scheduled_at": null
  }'

Ejemplo de Respuesta

{
  "data": {
    "task_id": "pubtask06ixxxxxxx",
    "status": "PENDING",
    "created_at": 1781251687210
  }
}

Campos de Respuesta

Puedes ver las programaciones de publicación y los resultados en tiempo real en el calendario de WayinVideo.

Valores de Plataforma

Valores de Estado de Publicación

Ejemplo de Flujo Completo

Paso 1: Crear una URL OAuth de YouTube

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/social-media/oauth/youtube \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2" \
  --data ''

Abre el auth_url devuelto en un navegador y completa la autorización.

Paso 2: Listar Cuentas Disponibles

curl -X GET "https://wayinvideo-api.wayin.ai/api/v2/social-media/accounts?active_only=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2"

Copia el id de la cuenta en la que quieres publicar.

Paso 3: Publicar un Clip

curl -sS -X POST https://wayinvideo-api.wayin.ai/api/v2/social-media/publish \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "project_id": "prj06ixxxxxxx",
    "idx": 0,
    "resolution": "1080p",
    "publish_configs": {
      "smacct06ixxxxxxx": {
        "title": "API Test Video",
        "description": "Posted by curl test",
        "tags": ["api", "test"],
        "visibility": "public"
      }
    },
    "scheduled_at": null
  }'

Notas

1. Las claves de publish_configs son IDs de cuenta, no nombres de plataforma.
2. Para programar una publicación, envía scheduled_at como un timestamp futuro en milisegundos.
3. El mismo clip puede publicarse varias veces en diferentes cuentas. Publicar de nuevo el mismo clip en la misma cuenta crea una tarea independiente.
4. La publicación social requiere un video de clip exportado. Usa el project_id de una tarea de Clipping con IA o Buscar Momentos creada con enable_export = true.
5. Si la publicación devuelve un error de token de cuenta, vuelve a conectar esa cuenta de red social e inténtalo de nuevo.