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 ID | instagram.medio.ver |
| Nombre MCP | instagram__medio__ver |
| Conector | instagram |
| Plano | action |
| Scope (permiso) | instagram:media |
| Auth | none |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=true, destructive=false, idempotent=true, openWorld=false |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
Qué hace
No vuelve a descargar ni a procesar nada.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
preparacionId | string ^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 -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"}}'{
"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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
preparacionId | string ^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. |
motivo | string | null | sí |
mensaje | string | null | sí |
perfil | objeto | sí | Perfil versionado del destino. |
perfil.id | string | sí | Perfil de compatibilidad aplicado. |
perfil.version | string | sí | Versión del perfil (fecha de las fuentes). |
original | objeto | null | sí |
original.medioId | string ^mobj_[0-9a-z]{21}$ | sí | Identificador estable de un archivo guardado en Emisso para esta conexión. |
original.sha256 | string ^[0-9a-f]{64}$ | sí | SHA-256 del contenido, en hexadecimal minúscula. |
original.bytes | entero | sí | Tamaño en bytes. |
original.mime | string | sí | Tipo detectado por el contenido. |
original.inspeccion | valor | sí | Lo que Emisso leyó de los bytes reales. |
original.enlace | objeto | null | sí |
original.enlace.url | string | sí | Enlace temporal para descargar el archivo. Exige que la conexión y el permiso sigan vigentes al usarlo. |
original.enlace.expiraEn | string `^(?:(?:\d\d[2468][048] | \d\d[13579][26] | \d\d0[48] |
derivado | objeto | null | sí |
derivado.medioId | string ^mobj_[0-9a-z]{21}$ | sí | Identificador estable de un archivo guardado en Emisso para esta conexión. |
derivado.sha256 | string ^[0-9a-f]{64}$ | sí | SHA-256 del contenido, en hexadecimal minúscula. |
derivado.bytes | entero | sí | Tamaño en bytes. |
derivado.mime | string | sí | Tipo detectado por el contenido. |
derivado.inspeccion | valor | sí | Lo que Emisso leyó de los bytes reales. |
derivado.enlace | objeto | null | sí |
derivado.enlace.url | string | sí | Enlace temporal para descargar el archivo. Exige que la conexión y el permiso sigan vigentes al usarlo. |
derivado.enlace.expiraEn | string `^(?:(?:\d\d[2468][048] | \d\d[13579][26] | \d\d0[48] |
derivado.derivadoDe | string ^[0-9a-f]{64}$ | sí | SHA-256 del original del que proviene. |
derivado.identicoAlOriginal | booleano | sí | true si el original ya cumplía y no se transformó. |
receta | objeto | null | sí |
receta.id | string | sí | Receta aplicada. |
receta.version | entero | sí | Versión de la receta. |
receta.params | objeto | sí | Parámetros efectivos de esta ejecución. |
transformaciones | lista de objeto | sí | Cambios aplicados al derivado. |
transformaciones[].tipo | string | sí | Cambio aplicado (p. ej. format_convert, recompress, downscale). |
transformaciones[].perceptible | booleano | sí | Si una persona podría notar la diferencia. |
transformaciones[].detalle | objeto | sí | Valores del cambio. |
restricciones | objeto | null | sí |
restricciones.bytes | objeto | sí | Límites de bytes separados por capa. |
restricciones.bytes.procesamiento | entero | sí | Máximo que Emisso acepta procesar. |
restricciones.bytes.upload | entero | sí | Máximo que Emisso transfiere al proveedor en una corrida. |
restricciones.bytes.publicacion | entero | sí | Máximo que documenta el proveedor. |
restricciones.bytes.efectivo | entero | sí | Menor entre upload y publicación. |
restricciones.bytes.manda | "upload" · "publish" | sí | Qué límite define el efectivo. |
restricciones.incumplimientos | lista de objeto | sí | Lo que el original no cumplía. |
restricciones.incumplimientos[].codigo | string | sí | 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[].actual | valor | sí | Valor encontrado. |
restricciones.incumplimientos[].limite | valor | sí | Valor exigido. |
restricciones.noVerificado | lista de string | sí | Requisitos del proveedor que la estructura no permite comprobar. |
restricciones.avisos | lista de string | sí | Observaciones que no bloquean. |
decisiones | lista de objeto | sí | Decisiones pendientes del cliente; Emisso no recorta, rellena ni silencia. |
decisiones[].codigo | string | sí | Cambio que exigiría decidir. |
decisiones[].actual | valor | sí | Valor encontrado. |
decisiones[].limite | valor | sí | Valor exigido. |
decisiones[].remedio | string | sí | Qué puede hacer el cliente. |
reintentable | booleano | sí | true si repetir preparar con el mismo origen puede cambiar el resultado (en proceso, motor no disponible o fallo transitorio). |
reintentarEnSegundos | entero 0-3600 | null | sí |
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ódigo | HTTP | Reintentable | Qué hacer |
|---|---|---|---|
connection_disabled | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_not_found | 404 | no | Usa 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.