Preparar un medio para Instagram
Inspecciona el contenido real de un archivo cargado o de una URL pública y lo adecua al destino de Instagram con un perfil versionado.
| Tool ID | instagram.medio.preparar |
| Nombre MCP | instagram__medio__preparar |
| Conector | instagram |
| Plano | action |
| Scope (permiso) | instagram:media |
| Auth | none |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=false, destructive=false, idempotent=true, openWorld=true |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST y campoconnectionIden elexecute_writede 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
Guarda el original y el derivado de forma privada con sus SHA-256 y la receta, y devuelve un preparacionId estable. No recorta, no rellena ni silencia: si hiciera falta, responde requiere_decision. No publica, no usa la cuenta de Instagram y no aprueba contenido. El video queda no_disponible mientras Emisso no habilite su motor. Repetir con el mismo origen converge a la misma preparación.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
perfil | "feed_image" · "carousel_image" · "story_image" · "reel" · "story_video" | sí | Destino: imagen de feed, imagen de carrusel, imagen de Story, Reel o video de Story. |
origen | valor | sí | Un archivo ya cargado en esta conexión o una URL pública. |
opciones | objeto | no · default {"permitirDownmix":false,"fondoTransparencia":null,"forzarRecodificacion":false} | Autorizaciones explícitas para cambios perceptibles. Sin ellas, Emisso pide decisión. |
opciones.permitirDownmix | booleano | no · default false | Autoriza bajar audio multicanal a estéreo (perceptible). |
opciones.fondoTransparencia | "#ffffff" · "#000000" | null | no · default null |
opciones.forzarRecodificacion | booleano | no · default false | Recodifica un video aunque sólo falte reescribir el contenedor. |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"perfil": {
"type": "string",
"enum": [
"feed_image",
"carousel_image",
"story_image",
"reel",
"story_video"
],
"description": "Destino: imagen de feed, imagen de carrusel, imagen de Story, Reel o video de Story."
},
"origen": {
"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."
}
},
"required": [
"medioId"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"format": "uri",
"description": "URL HTTPS pública. Emisso la descarga una vez con controles de red y guarda ese contenido como original; no la vuelve a leer."
}
},
"required": [
"url"
],
"additionalProperties": false
}
],
"description": "Un archivo ya cargado en esta conexión o una URL pública."
},
"opciones": {
"default": {
"permitirDownmix": false,
"fondoTransparencia": null,
"forzarRecodificacion": false
},
"description": "Autorizaciones explícitas para cambios perceptibles. Sin ellas, Emisso pide decisión.",
"type": "object",
"properties": {
"permitirDownmix": {
"default": false,
"description": "Autoriza bajar audio multicanal a estéreo (perceptible).",
"type": "boolean"
},
"fondoTransparencia": {
"default": null,
"description": "Autoriza aplanar transparencia sobre este color (perceptible).",
"anyOf": [
{
"type": "string",
"enum": [
"#ffffff",
"#000000"
]
},
{
"type": "null"
}
]
},
"forzarRecodificacion": {
"default": false,
"description": "Recodifica un video aunque sólo falte reescribir el contenedor.",
"type": "boolean"
}
},
"additionalProperties": false
}
},
"required": [
"perfil",
"origen"
],
"additionalProperties": false
}Ejemplo
curl -X POST https://connect.emisso.ai/api/v1/tools/instagram.medio.preparar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input":{"perfil":"feed_image","origen":{"medioId":"mobj_0123456789abcdefghijk"}}}'{
"tool": "instagram.medio.preparar",
"params": {
"perfil": "feed_image",
"origen": {
"medioId": "mobj_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.preparar",
"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.
Abrir una carga de medio para Instagram
Abre una carga privada de un archivo en Emisso para esta conexión, sin pasar los bytes por la llamada.
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.