Ver una preparación de medio de Instagram

Devuelve el estado guardado de una preparación de esta conexión, con enlaces temporales nuevos al original y al derivado.

Tool IDinstagram.medio.ver
Nombre MCPinstagram__medio__ver
Conectorinstagram
Planoaction
Scope (permiso)instagram:media
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

No vuelve a descargar ni a procesar nada.

Entrada

CampoTipoRequeridoDescripción
preparacionIdstring ^mprep_[0-9a-z]{21}$síIdentificador estable de la preparación, para consultarla sin repetirla.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "preparacionId": {
      "type": "string",
      "pattern": "^mprep_[0-9a-z]{21}$",
      "description": "Identificador estable de la preparación, para consultarla sin repetirla."
    }
  },
  "required": [
    "preparacionId"
  ],
  "additionalProperties": false
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/instagram.medio.ver/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"preparacionId":"mprep_0123456789abcdefghijk"}}'
MCP · meta-tool execute
{
  "tool": "instagram.medio.ver",
  "params": {
    "preparacionId": "mprep_0123456789abcdefghijk"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "preparacionId": "mprep_0123456789abcdefghijk",
    "estado": "lista",
    "motivo": null,
    "mensaje": null,
    "perfil": {
      "id": "instagram.feed_image",
      "version": "2026-11-14"
    },
    "original": {
      "medioId": "mobj_0123456789abcdefghijk",
      "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "bytes": 182000,
      "mime": "image/jpeg",
      "inspeccion": {
        "tipo": "imagen",
        "formato": "jpeg",
        "ancho": 1080,
        "alto": 1350,
        "orientacionExif": 1,
        "animada": false,
        "cuadros": 1,
        "transparencia": false,
        "modeloColor": "rgb",
        "perfilIcc": false,
        "multiImagen": false
      },
      "enlace": {
        "url": "https://connect.emisso.ai/api/medios/archivo?token=…",
        "expiraEn": "2026-11-14T15:05:00.000Z"
      }
    },
    "derivado": {
      "medioId": "mobj_0123456789abcdefghijk",
      "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "bytes": 182000,
      "mime": "image/jpeg",
      "inspeccion": {
        "tipo": "imagen",
        "formato": "jpeg",
        "ancho": 1080,
        "alto": 1350,
        "orientacionExif": 1,
        "animada": false,
        "cuadros": 1,
        "transparencia": false,
        "modeloColor": "rgb",
        "perfilIcc": false,
        "multiImagen": false
      },
      "enlace": {
        "url": "https://connect.emisso.ai/api/medios/archivo?token=…",
        "expiraEn": "2026-11-14T15:05:00.000Z"
      },
      "derivadoDe": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "identicoAlOriginal": true
    },
    "receta": null,
    "transformaciones": [],
    "restricciones": {
      "bytes": {
        "procesamiento": 31457280,
        "upload": 8000000,
        "publicacion": 8000000,
        "efectivo": 8000000,
        "manda": "upload"
      },
      "incumplimientos": [],
      "noVerificado": [],
      "avisos": []
    },
    "decisiones": [],
    "reintentable": false,
    "reintentarEnSegundos": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "instagram.medio.ver",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

CampoTipoRequeridoDescripción
preparacionIdstring ^mprep_[0-9a-z]{21}$síIdentificador estable de la preparación, para consultarla sin repetirla.
estado"lista" · "requiere_decision" · "rechazada" · "no_disponible" · "fallida" · "en_proceso"sílista: derivado verificado o el original ya compatible; requiere_decision: adecuarlo cambiaría el contenido; no_disponible: el motor (p. ej. video) no está habilitado; en_proceso: otro trabajo tiene el lease.
motivostringnullsí
mensajestringnullsí
perfilobjetosíPerfil versionado del destino.
perfil.idstringsíPerfil de compatibilidad aplicado.
perfil.versionstringsíVersión del perfil (fecha de las fuentes).
originalobjetonullsí
original.medioIdstring ^mobj_[0-9a-z]{21}$síIdentificador estable de un archivo guardado en Emisso para esta conexión.
original.sha256string ^[0-9a-f]{64}$síSHA-256 del contenido, en hexadecimal minúscula.
original.bytesenterosíTamaño en bytes.
original.mimestringsíTipo detectado por el contenido.
original.inspeccionvalorsíLo que Emisso leyó de los bytes reales.
original.enlaceobjetonullsí
original.enlace.urlstringsíEnlace temporal para descargar el archivo. Exige que la conexión y el permiso sigan vigentes al usarlo.
original.enlace.expiraEnstring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
derivadoobjetonullsí
derivado.medioIdstring ^mobj_[0-9a-z]{21}$síIdentificador estable de un archivo guardado en Emisso para esta conexión.
derivado.sha256string ^[0-9a-f]{64}$síSHA-256 del contenido, en hexadecimal minúscula.
derivado.bytesenterosíTamaño en bytes.
derivado.mimestringsíTipo detectado por el contenido.
derivado.inspeccionvalorsíLo que Emisso leyó de los bytes reales.
derivado.enlaceobjetonullsí
derivado.enlace.urlstringsíEnlace temporal para descargar el archivo. Exige que la conexión y el permiso sigan vigentes al usarlo.
derivado.enlace.expiraEnstring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
derivado.derivadoDestring ^[0-9a-f]{64}$síSHA-256 del original del que proviene.
derivado.identicoAlOriginalbooleanosítrue si el original ya cumplía y no se transformó.
recetaobjetonullsí
receta.idstringsíReceta aplicada.
receta.versionenterosíVersión de la receta.
receta.paramsobjetosíParámetros efectivos de esta ejecución.
transformacioneslista de objetosíCambios aplicados al derivado.
transformaciones[].tipostringsíCambio aplicado (p. ej. format_convert, recompress, downscale).
transformaciones[].perceptiblebooleanosíSi una persona podría notar la diferencia.
transformaciones[].detalleobjetosíValores del cambio.
restriccionesobjetonullsí
restricciones.bytesobjetosíLímites de bytes separados por capa.
restricciones.bytes.procesamientoenterosíMáximo que Emisso acepta procesar.
restricciones.bytes.uploadenterosíMáximo que Emisso transfiere al proveedor en una corrida.
restricciones.bytes.publicacionenterosíMáximo que documenta el proveedor.
restricciones.bytes.efectivoenterosíMenor entre upload y publicación.
restricciones.bytes.manda"upload" · "publish"síQué límite define el efectivo.
restricciones.incumplimientoslista de objetosíLo que el original no cumplía.
restricciones.incumplimientos[].codigostringsíRequisito incumplido.
restricciones.incumplimientos[].capa"processing" · "upload" · "publish"síCapa del límite.
restricciones.incumplimientos[].resolucion"remux" · "reencode" · "decision" · "reject"síCómo se resuelve.
restricciones.incumplimientos[].actualvalorsíValor encontrado.
restricciones.incumplimientos[].limitevalorsíValor exigido.
restricciones.noVerificadolista de stringsíRequisitos del proveedor que la estructura no permite comprobar.
restricciones.avisoslista de stringsíObservaciones que no bloquean.
decisioneslista de objetosíDecisiones pendientes del cliente; Emisso no recorta, rellena ni silencia.
decisiones[].codigostringsíCambio que exigiría decidir.
decisiones[].actualvalorsíValor encontrado.
decisiones[].limitevalorsíValor exigido.
decisiones[].remediostringsíQué puede hacer el cliente.
reintentablebooleanosítrue si repetir preparar con el mismo origen puede cambiar el resultado (en proceso, motor no disponible o fallo transitorio).
reintentarEnSegundosentero 0-3600nullsí
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "preparacionId": {
      "type": "string",
      "pattern": "^mprep_[0-9a-z]{21}$",
      "description": "Identificador estable de la preparación, para consultarla sin repetirla."
    },
    "estado": {
      "type": "string",
      "enum": [
        "lista",
        "requiere_decision",
        "rechazada",
        "no_disponible",
        "fallida",
        "en_proceso"
      ],
      "description": "lista: derivado verificado o el original ya compatible; requiere_decision: adecuarlo cambiaría el contenido; no_disponible: el motor (p. ej. video) no está habilitado; en_proceso: otro trabajo tiene el lease."
    },
    "motivo": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 60
        },
        {
          "type": "null"
        }
      ],
      "description": "Código estable del rechazo, falta de motor o fallo; null si está lista."
    },
    "mensaje": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300
        },
        {
          "type": "null"
        }
      ],
      "description": "Explicación para personas; null si no hace falta."
    },
    "perfil": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 60,
          "description": "Perfil de compatibilidad aplicado."
        },
        "version": {
          "type": "string",
          "maxLength": 20,
          "description": "Versión del perfil (fecha de las fuentes)."
        }
      },
      "required": [
        "id",
        "version"
      ],
      "additionalProperties": false,
      "description": "Perfil versionado del destino."
    },
    "original": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "medioId": {
              "type": "string",
              "pattern": "^mobj_[0-9a-z]{21}$",
              "description": "Identificador estable de un archivo guardado en Emisso para esta conexión."
            },
            "sha256": {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$",
              "description": "SHA-256 del contenido, en hexadecimal minúscula."
            },
            "bytes": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "Tamaño en bytes."
            },
            "mime": {
              "type": "string",
              "maxLength": 40,
              "description": "Tipo detectado por el contenido."
            },
            "inspeccion": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "tipo": {
                      "type": "string",
                      "const": "imagen",
                      "description": "Clase de medio inspeccionado."
                    },
                    "formato": {
                      "type": "string",
                      "enum": [
                        "jpeg",
                        "png",
                        "webp",
                        "gif"
                      ],
                      "description": "Formato detectado por el contenido, no por el nombre ni el tipo declarado."
                    },
                    "ancho": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Ancho de presentación en píxeles, tras la orientación EXIF."
                    },
                    "alto": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Alto de presentación en píxeles, tras la orientación EXIF."
                    },
                    "orientacionExif": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Orientación EXIF (1 a 8); 1 si no hay."
                    },
                    "animada": {
                      "type": "boolean",
                      "description": "Tiene más de un cuadro."
                    },
                    "cuadros": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Cantidad de cuadros."
                    },
                    "transparencia": {
                      "type": "boolean",
                      "description": "Tiene píxeles efectivamente transparentes."
                    },
                    "modeloColor": {
                      "type": "string",
                      "maxLength": 20,
                      "description": "rgb, grayscale, cmyk, ycck o palette."
                    },
                    "perfilIcc": {
                      "type": "boolean",
                      "description": "Trae un perfil de color incrustado."
                    },
                    "multiImagen": {
                      "type": "boolean",
                      "description": "JPEG multi-imagen (MPO), que Instagram no admite."
                    }
                  },
                  "required": [
                    "tipo",
                    "formato",
                    "ancho",
                    "alto",
                    "orientacionExif",
                    "animada",
                    "cuadros",
                    "transparencia",
                    "modeloColor",
                    "perfilIcc",
                    "multiImagen"
                  ],
                  "additionalProperties": false,
                  "description": "Inspección de una imagen."
                },
                {
                  "type": "object",
                  "properties": {
                    "tipo": {
                      "type": "string",
                      "const": "video",
                      "description": "Clase de medio inspeccionado."
                    },
                    "contenedor": {
                      "type": "string",
                      "enum": [
                        "mp4",
                        "mov"
                      ],
                      "description": "Contenedor ISO BMFF detectado."
                    },
                    "duracionSegundos": {
                      "type": "number",
                      "description": "Duración del contenedor."
                    },
                    "moovAlInicio": {
                      "type": "boolean",
                      "description": "El índice (moov) está antes de los datos."
                    },
                    "fragmentado": {
                      "type": "boolean",
                      "description": "MP4 fragmentado."
                    },
                    "video": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "codec": {
                              "type": "string",
                              "maxLength": 8,
                              "description": "Código del sample entry (avc1, hvc1, mp4v…)."
                            },
                            "familia": {
                              "type": "string",
                              "maxLength": 20,
                              "description": "Familia del codec (h264, hevc, mpeg4_part2…)."
                            },
                            "perfil": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 40
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Perfil del codec, si se pudo leer."
                            },
                            "nivel": {
                              "anyOf": [
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Nivel del codec, si se pudo leer."
                            },
                            "croma": {
                              "type": "string",
                              "maxLength": 10,
                              "description": "Submuestreo de croma (4:2:0, 4:2:2, 4:4:4 o unknown)."
                            },
                            "profundidadBits": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Bits por muestra, si se pudo leer."
                            },
                            "progresivo": {
                              "anyOf": [
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Escaneo progresivo; null si la estructura no permite afirmarlo."
                            },
                            "ancho": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Ancho de presentación, tras la rotación."
                            },
                            "alto": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Alto de presentación, tras la rotación."
                            },
                            "rotacion": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Rotación de presentación en grados antihorarios, como ffprobe."
                            },
                            "fps": {
                              "type": "number",
                              "description": "Cuadros por segundo medios."
                            },
                            "duracionSegundos": {
                              "type": "number",
                              "description": "Duración de la pista de video."
                            },
                            "editList": {
                              "type": "boolean",
                              "description": "La pista declara edit list."
                            },
                            "hdr": {
                              "anyOf": [
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Transferencia PQ o HLG; null si no se declara."
                            },
                            "bitrateBps": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Bitrate medio estimado."
                            }
                          },
                          "required": [
                            "codec",
                            "familia",
                            "perfil",
                            "nivel",
                            "croma",
                            "profundidadBits",
                            "progresivo",
                            "ancho",
                            "alto",
                            "rotacion",
                            "fps",
                            "duracionSegundos",
                            "editList",
                            "hdr",
                            "bitrateBps"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Primera pista de video; null si no tiene."
                    },
                    "audio": {
                      "maxItems": 16,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "codec": {
                            "type": "string",
                            "maxLength": 8,
                            "description": "Código del sample entry (p. ej. mp4a)."
                          },
                          "familia": {
                            "type": "string",
                            "maxLength": 20,
                            "description": "Familia del codec (aac, mp3, opus, pcm u other)."
                          },
                          "frecuenciaHz": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991,
                            "description": "Frecuencia de muestreo."
                          },
                          "canales": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991,
                            "description": "Canales de audio."
                          },
                          "duracionSegundos": {
                            "type": "number",
                            "description": "Duración de la pista."
                          },
                          "editList": {
                            "type": "boolean",
                            "description": "La pista declara edit list."
                          },
                          "bitrateBps": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991,
                            "description": "Bitrate medio estimado."
                          }
                        },
                        "required": [
                          "codec",
                          "familia",
                          "frecuenciaHz",
                          "canales",
                          "duracionSegundos",
                          "editList",
                          "bitrateBps"
                        ],
                        "additionalProperties": false,
                        "description": "Pista de audio."
                      },
                      "description": "Pistas de audio."
                    },
                    "otrasPistas": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Pistas que no son audio ni video."
                    }
                  },
                  "required": [
                    "tipo",
                    "contenedor",
                    "duracionSegundos",
                    "moovAlInicio",
                    "fragmentado",
                    "video",
                    "audio",
                    "otrasPistas"
                  ],
                  "additionalProperties": false,
                  "description": "Inspección de un video."
                }
              ],
              "description": "Lo que Emisso leyó de los bytes reales."
            },
            "enlace": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 8192,
                      "format": "uri",
                      "description": "Enlace temporal para descargar el archivo. Exige que la conexión y el permiso sigan vigentes al usarlo."
                    },
                    "expiraEn": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "description": "Vencimiento del enlace (máximo cinco minutos)."
                    }
                  },
                  "required": [
                    "url",
                    "expiraEn"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "null si el archivo ya venció o la consulta no puede entregarlo."
            }
          },
          "required": [
            "medioId",
            "sha256",
            "bytes",
            "mime",
            "inspeccion",
            "enlace"
          ],
          "additionalProperties": false,
          "description": "Archivo guardado de forma privada en Emisso."
        },
        {
          "type": "null"
        }
      ],
      "description": "El original tal como llegó; null si no se pudo leer."
    },
    "derivado": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "medioId": {
              "type": "string",
              "pattern": "^mobj_[0-9a-z]{21}$",
              "description": "Identificador estable de un archivo guardado en Emisso para esta conexión."
            },
            "sha256": {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$",
              "description": "SHA-256 del contenido, en hexadecimal minúscula."
            },
            "bytes": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "Tamaño en bytes."
            },
            "mime": {
              "type": "string",
              "maxLength": 40,
              "description": "Tipo detectado por el contenido."
            },
            "inspeccion": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "tipo": {
                      "type": "string",
                      "const": "imagen",
                      "description": "Clase de medio inspeccionado."
                    },
                    "formato": {
                      "type": "string",
                      "enum": [
                        "jpeg",
                        "png",
                        "webp",
                        "gif"
                      ],
                      "description": "Formato detectado por el contenido, no por el nombre ni el tipo declarado."
                    },
                    "ancho": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Ancho de presentación en píxeles, tras la orientación EXIF."
                    },
                    "alto": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Alto de presentación en píxeles, tras la orientación EXIF."
                    },
                    "orientacionExif": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Orientación EXIF (1 a 8); 1 si no hay."
                    },
                    "animada": {
                      "type": "boolean",
                      "description": "Tiene más de un cuadro."
                    },
                    "cuadros": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Cantidad de cuadros."
                    },
                    "transparencia": {
                      "type": "boolean",
                      "description": "Tiene píxeles efectivamente transparentes."
                    },
                    "modeloColor": {
                      "type": "string",
                      "maxLength": 20,
                      "description": "rgb, grayscale, cmyk, ycck o palette."
                    },
                    "perfilIcc": {
                      "type": "boolean",
                      "description": "Trae un perfil de color incrustado."
                    },
                    "multiImagen": {
                      "type": "boolean",
                      "description": "JPEG multi-imagen (MPO), que Instagram no admite."
                    }
                  },
                  "required": [
                    "tipo",
                    "formato",
                    "ancho",
                    "alto",
                    "orientacionExif",
                    "animada",
                    "cuadros",
                    "transparencia",
                    "modeloColor",
                    "perfilIcc",
                    "multiImagen"
                  ],
                  "additionalProperties": false,
                  "description": "Inspección de una imagen."
                },
                {
                  "type": "object",
                  "properties": {
                    "tipo": {
                      "type": "string",
                      "const": "video",
                      "description": "Clase de medio inspeccionado."
                    },
                    "contenedor": {
                      "type": "string",
                      "enum": [
                        "mp4",
                        "mov"
                      ],
                      "description": "Contenedor ISO BMFF detectado."
                    },
                    "duracionSegundos": {
                      "type": "number",
                      "description": "Duración del contenedor."
                    },
                    "moovAlInicio": {
                      "type": "boolean",
                      "description": "El índice (moov) está antes de los datos."
                    },
                    "fragmentado": {
                      "type": "boolean",
                      "description": "MP4 fragmentado."
                    },
                    "video": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "codec": {
                              "type": "string",
                              "maxLength": 8,
                              "description": "Código del sample entry (avc1, hvc1, mp4v…)."
                            },
                            "familia": {
                              "type": "string",
                              "maxLength": 20,
                              "description": "Familia del codec (h264, hevc, mpeg4_part2…)."
                            },
                            "perfil": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 40
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Perfil del codec, si se pudo leer."
                            },
                            "nivel": {
                              "anyOf": [
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Nivel del codec, si se pudo leer."
                            },
                            "croma": {
                              "type": "string",
                              "maxLength": 10,
                              "description": "Submuestreo de croma (4:2:0, 4:2:2, 4:4:4 o unknown)."
                            },
                            "profundidadBits": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Bits por muestra, si se pudo leer."
                            },
                            "progresivo": {
                              "anyOf": [
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Escaneo progresivo; null si la estructura no permite afirmarlo."
                            },
                            "ancho": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Ancho de presentación, tras la rotación."
                            },
                            "alto": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Alto de presentación, tras la rotación."
                            },
                            "rotacion": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Rotación de presentación en grados antihorarios, como ffprobe."
                            },
                            "fps": {
                              "type": "number",
                              "description": "Cuadros por segundo medios."
                            },
                            "duracionSegundos": {
                              "type": "number",
                              "description": "Duración de la pista de video."
                            },
                            "editList": {
                              "type": "boolean",
                              "description": "La pista declara edit list."
                            },
                            "hdr": {
                              "anyOf": [
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Transferencia PQ o HLG; null si no se declara."
                            },
                            "bitrateBps": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991,
                              "description": "Bitrate medio estimado."
                            }
                          },
                          "required": [
                            "codec",
                            "familia",
                            "perfil",
                            "nivel",
                            "croma",
                            "profundidadBits",
                            "progresivo",
                            "ancho",
                            "alto",
                            "rotacion",
                            "fps",
                            "duracionSegundos",
                            "editList",
                            "hdr",
                            "bitrateBps"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Primera pista de video; null si no tiene."
                    },
                    "audio": {
                      "maxItems": 16,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "codec": {
                            "type": "string",
                            "maxLength": 8,
                            "description": "Código del sample entry (p. ej. mp4a)."
                          },
                          "familia": {
                            "type": "string",
                            "maxLength": 20,
                            "description": "Familia del codec (aac, mp3, opus, pcm u other)."
                          },
                          "frecuenciaHz": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991,
                            "description": "Frecuencia de muestreo."
                          },
                          "canales": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991,
                            "description": "Canales de audio."
                          },
                          "duracionSegundos": {
                            "type": "number",
                            "description": "Duración de la pista."
                          },
                          "editList": {
                            "type": "boolean",
                            "description": "La pista declara edit list."
                          },
                          "bitrateBps": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991,
                            "description": "Bitrate medio estimado."
                          }
                        },
                        "required": [
                          "codec",
                          "familia",
                          "frecuenciaHz",
                          "canales",
                          "duracionSegundos",
                          "editList",
                          "bitrateBps"
                        ],
                        "additionalProperties": false,
                        "description": "Pista de audio."
                      },
                      "description": "Pistas de audio."
                    },
                    "otrasPistas": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991,
                      "description": "Pistas que no son audio ni video."
                    }
                  },
                  "required": [
                    "tipo",
                    "contenedor",
                    "duracionSegundos",
                    "moovAlInicio",
                    "fragmentado",
                    "video",
                    "audio",
                    "otrasPistas"
                  ],
                  "additionalProperties": false,
                  "description": "Inspección de un video."
                }
              ],
              "description": "Lo que Emisso leyó de los bytes reales."
            },
            "enlace": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 8192,
                      "format": "uri",
                      "description": "Enlace temporal para descargar el archivo. Exige que la conexión y el permiso sigan vigentes al usarlo."
                    },
                    "expiraEn": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "description": "Vencimiento del enlace (máximo cinco minutos)."
                    }
                  },
                  "required": [
                    "url",
                    "expiraEn"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "null si el archivo ya venció o la consulta no puede entregarlo."
            },
            "derivadoDe": {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$",
              "description": "SHA-256 del original del que proviene."
            },
            "identicoAlOriginal": {
              "type": "boolean",
              "description": "true si el original ya cumplía y no se transformó."
            }
          },
          "required": [
            "medioId",
            "sha256",
            "bytes",
            "mime",
            "inspeccion",
            "enlace",
            "derivadoDe",
            "identicoAlOriginal"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "El archivo para el destino. Emisso no aprueba contenido: vincula tu aprobación a este SHA-256 y receta."
    },
    "receta": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "maxLength": 40,
              "description": "Receta aplicada."
            },
            "version": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "Versión de la receta."
            },
            "params": {
              "type": "object",
              "propertyNames": {
                "type": "string",
                "maxLength": 40
              },
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 200
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  },
                  {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 100
                        },
                        {
                          "type": "number"
                        }
                      ]
                    }
                  }
                ]
              },
              "description": "Parámetros efectivos de esta ejecución."
            }
          },
          "required": [
            "id",
            "version",
            "params"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "null si no hubo transformación."
    },
    "transformaciones": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "tipo": {
            "type": "string",
            "maxLength": 40,
            "description": "Cambio aplicado (p. ej. format_convert, recompress, downscale)."
          },
          "perceptible": {
            "type": "boolean",
            "description": "Si una persona podría notar la diferencia."
          },
          "detalle": {
            "type": "object",
            "propertyNames": {
              "type": "string",
              "maxLength": 40
            },
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                },
                {
                  "maxItems": 20,
                  "type": "array",
                  "items": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 100
                      },
                      {
                        "type": "number"
                      }
                    ]
                  }
                }
              ]
            },
            "description": "Valores del cambio."
          }
        },
        "required": [
          "tipo",
          "perceptible",
          "detalle"
        ],
        "additionalProperties": false
      },
      "description": "Cambios aplicados al derivado."
    },
    "restricciones": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "bytes": {
              "type": "object",
              "properties": {
                "procesamiento": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Máximo que Emisso acepta procesar."
                },
                "upload": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Máximo que Emisso transfiere al proveedor en una corrida."
                },
                "publicacion": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Máximo que documenta el proveedor."
                },
                "efectivo": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Menor entre upload y publicación."
                },
                "manda": {
                  "type": "string",
                  "enum": [
                    "upload",
                    "publish"
                  ],
                  "description": "Qué límite define el efectivo."
                }
              },
              "required": [
                "procesamiento",
                "upload",
                "publicacion",
                "efectivo",
                "manda"
              ],
              "additionalProperties": false,
              "description": "Límites de bytes separados por capa."
            },
            "incumplimientos": {
              "maxItems": 40,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "codigo": {
                    "type": "string",
                    "maxLength": 60,
                    "description": "Requisito incumplido."
                  },
                  "capa": {
                    "type": "string",
                    "enum": [
                      "processing",
                      "upload",
                      "publish"
                    ],
                    "description": "Capa del límite."
                  },
                  "resolucion": {
                    "type": "string",
                    "enum": [
                      "remux",
                      "reencode",
                      "decision",
                      "reject"
                    ],
                    "description": "Cómo se resuelve."
                  },
                  "actual": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "number"
                            }
                          ]
                        }
                      }
                    ],
                    "description": "Valor encontrado."
                  },
                  "limite": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "maxItems": 20,
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "number"
                            }
                          ]
                        }
                      }
                    ],
                    "description": "Valor exigido."
                  }
                },
                "required": [
                  "codigo",
                  "capa",
                  "resolucion",
                  "actual",
                  "limite"
                ],
                "additionalProperties": false
              },
              "description": "Lo que el original no cumplía."
            },
            "noVerificado": {
              "maxItems": 10,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 60
              },
              "description": "Requisitos del proveedor que la estructura no permite comprobar."
            },
            "avisos": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 60
              },
              "description": "Observaciones que no bloquean."
            }
          },
          "required": [
            "bytes",
            "incumplimientos",
            "noVerificado",
            "avisos"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Evaluación contra el perfil; null si el archivo no se pudo inspeccionar."
    },
    "decisiones": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "codigo": {
            "type": "string",
            "maxLength": 60,
            "description": "Cambio que exigiría decidir."
          },
          "actual": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              },
              {
                "type": "null"
              },
              {
                "maxItems": 20,
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string",
                      "maxLength": 100
                    },
                    {
                      "type": "number"
                    }
                  ]
                }
              }
            ],
            "description": "Valor encontrado."
          },
          "limite": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              },
              {
                "type": "null"
              },
              {
                "maxItems": 20,
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string",
                      "maxLength": 100
                    },
                    {
                      "type": "number"
                    }
                  ]
                }
              }
            ],
            "description": "Valor exigido."
          },
          "remedio": {
            "type": "string",
            "maxLength": 300,
            "description": "Qué puede hacer el cliente."
          }
        },
        "required": [
          "codigo",
          "actual",
          "limite",
          "remedio"
        ],
        "additionalProperties": false
      },
      "description": "Decisiones pendientes del cliente; Emisso no recorta, rellena ni silencia."
    },
    "reintentable": {
      "type": "boolean",
      "description": "true si repetir preparar con el mismo origen puede cambiar el resultado (en proceso, motor no disponible o fallo transitorio)."
    },
    "reintentarEnSegundos": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 3600
        },
        {
          "type": "null"
        }
      ],
      "description": "Espera sugerida antes de reintentar; null si no aplica."
    }
  },
  "required": [
    "preparacionId",
    "estado",
    "motivo",
    "mensaje",
    "perfil",
    "original",
    "derivado",
    "receta",
    "transformaciones",
    "restricciones",
    "decisiones",
    "reintentable",
    "reintentarEnSegundos"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

En esta página