​

Inicio rápido de trabajos de transcodificación

​

Resumen listo para IA (para humanos y asistentes)

• Usa la URL base de la API Studio: https://livepeer.studio/api
• Envía trabajos con POST /transcode
• La transcodificación es asíncrona; consulta GET /task/{id}
• Un éxito POST /transcode devuelve un task.id
• Se requiere una revisión final de precisión técnica de Rick (TD)

​

Estado de revisión

​

1. Requisitos previos

• Una clave API Livepeer (solo uso de backend)
• curl (y opcionalmente jq)
• Video de entrada accesible a través de HTTP o una fuente compatible con S3
• Destino de almacenamiento de salida (compatible con S3 o prueba de delegación de web3.storage)

​

2. URL base y autenticación

• URL base: https://livepeer.studio/api
• Encabezado de autenticación: Authorization: Bearer <LIVEPEER_API_KEY>

export LIVEPEER_API_KEY="<YOUR_API_KEY>"

​

3. Enviar un trabajo de transcodificación

• input
• storage
• outputs

• URL de entrada HTTP
• Salida de almacenamiento compatible con S3
• Salidas HLS + MP4

​

Cuerpo de solicitud de ejemplo

{
  "input": {
    "url": "https://example.com/video.mp4"
  },
  "storage": {
    "type": "s3",
    "endpoint": "https://gateway.storjshare.io",
    "bucket": "outputbucket",
    "credentials": {
      "accessKeyId": "<ACCESS_KEY_ID>",
      "secretAccessKey": "<SECRET_ACCESS_KEY>"
    }
  },
  "outputs": {
    "hls": {
      "path": "/samplevideo/hls"
    },
    "mp4": {
      "path": "/samplevideo/mp4"
    }
  },
  "profiles": [
    {
      "name": "720p",
      "width": 1280,
      "height": 720,
      "bitrate": 3000000,
      "fps": 30
    }
  ]
}

​

Solicitud curl de ejemplo

curl -sS \
  -X POST "https://livepeer.studio/api/transcode" \
  -H "Authorization: Bearer $LIVEPEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": { "url": "https://example.com/video.mp4" },
    "storage": {
      "type": "s3",
      "endpoint": "https://gateway.storjshare.io",
      "bucket": "outputbucket",
      "credentials": {
        "accessKeyId": "<ACCESS_KEY_ID>",
        "secretAccessKey": "<SECRET_ACCESS_KEY>"
      }
    },
    "outputs": {
      "hls": { "path": "/samplevideo/hls" },
      "mp4": { "path": "/samplevideo/mp4" }
    },
    "profiles": [
      {
        "name": "720p",
        "width": 1280,
        "height": 720,
        "bitrate": 3000000,
        "fps": 30
      }
    ]
  }'

​

4. Capturar el ID de la tarea

{
  "id": "09F8B46C-61A0-4254-9875-F71F4C605BC7",
  "type": "transcode-file",
  "status": {
    "phase": "pending",
    "updatedAt": 1587667174725
  }
}

​

5. Consulta el estado de la tarea

TASK_ID="<TASK_ID_FROM_TRANSCODE_RESPONSE>"

curl -sS \
  -H "Authorization: Bearer $LIVEPEER_API_KEY" \
  "https://livepeer.studio/api/task/$TASK_ID"

• pending
• waiting
• running
• failed
• completed
• cancelled

​

6. Verificar la finalización y las salidas

• Confirma que la tarea no haya reportado un errorMessage
• Inspecciona los metadatos de salida de la tarea y/o los IDs de activos vinculados
• Verifique las rutas de salida que solicitó bajo outputs en su almacenamiento de destino

​

7. Modos de falla comunes

​

401 Unauthorized

• Clave API inválida
• Falta/incorrecto Authorization encabezado

​

422 Validation Error

• Faltan campos obligatorios de nivel superior (input, storage, outputs)
• Inválido input esquema (desajuste entre URL y objeto S3)
• Inválido profiles forma

​

La tarea entra failed

• Verificar status.errorMessage
• Verifique que la URL de entrada sea accesible para el servicio
• Verifique las credenciales de almacenamiento de salida y los permisos del bucket
• Ejecute nuevamente con una combinación mínima de perfil/salida primero

​

8. Lista de verificación de revisión de Rick (TD) (bloqueo antes de la publicación final)

• Confirme el flujo de transcodificación canónico orientado al usuario para la documentación de 2026
• Confirme los ejemplos de perfil predeterminado recomendados
• Confirme las expectativas de sondeo y la guía de verificación de finalización
• Confirme que los ejemplos heredados obsoletos deben eliminarse/etiquetarse
• Confirme el límite con las API en tiempo real (qué pertenece a otro lugar)

​

9. Próximos pasos

• Crear referencia del endpoint de trabajo de transcodificación
• Resumen de la API de transcodificación
• Resumen de la API de tareas
• Referencia del endpoint Obtener Tarea
• Resumen de la API de Studio
• Resumen de los SDKs

​

Referencias canónicas (fuente de la verdad primero)

• GitHub (principal): livepeer/docs api/studio.yaml
• GitHub (principal): livepeer/docs api/gateway.openapi.yaml (para contexto compartido generate de etiqueta)
• DeepWiki (solo corroboración): livepeer/docs | DeepWiki
• Referencias de docs locales del repositorio (no validadas hasta ser verificadas cruzadamente): /platforms/livepeer-studio/api-reference/transcode/create, /platforms/livepeer-studio/api-reference/tasks/get