MCP 工具

在本地准备图片版位预览

sosoapi_prepare_asset_images

从一张已获授权访问的 Workspace 图片，在本地生成 1–4 张有范围限制的裁剪、补边或等比例缩放 JPEG 预览。仅支持静态 PNG/JPEG，最大 20 MiB、8 百万像素。返回本地文件、尺寸、警告及来源记录。使用 sosoapi_upload_asset 和返回的 upload_arguments 保存前，请先检查具体文件。不会发布。

阅读 Markdown

配置与传输方式

配置： core、full · 传输方式： stdio

选择 core 或 full 以控制客户端显示的工具；这不会变更权限。本地文件上传需要 stdio，无法通过 HTTP 使用。设置 SOSOAPI_OUTPUT_SCHEMAS=1 可在探索结果加入输出schema。无论是否启用此设置，工具皆会返回结构化结果。

权限与副作用

注解帮助客户端描述工具。每次调用仍会检查用户身份验证、角色、资源访问和能力授权。

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

/assets-api/get：agent:operate · synchronous_http_response

输入字段

「必填」是指在其父对象及所选分支内必填。必填子字段不会使可选父对象变成必填。下列规则与字段名称均复制自契约。

输入字段
字段 / 分支	类型 / 必填	约束
`$`	`object`在父对象中必填	`additionalProperties: false`
`workspace_id`	`string`在父对象中必填	`format: "uuid"`
`source_asset_id`	`integer`在父对象中必填	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`outputs`	`array`在父对象中必填	`minItems: 1` `maxItems: 4`
`outputs[]`	`object`可选／项目	`additionalProperties: false`
`outputs[].version`	`number`在父对象中必填	`enum: [1]`
`outputs[].destination`	`string`在父对象中必填	`enum: ["facebook-feed-square","facebook-feed-landscape","instagram-feed-square","instagram-feed-portrait"]`
`outputs[].operation`	`string`在父对象中必填	`enum: ["crop","pad","resize"]`
`outputs[].focal_point`	`object`在父对象中必填	`additionalProperties: false`
`outputs[].focal_point.x`	`number`在父对象中必填	`minimum: 0` `maximum: 1`
`outputs[].focal_point.y`	`number`在父对象中必填	`minimum: 0` `maximum: 1`
`outputs[].background`	`string`在父对象中必填	`pattern: "^#[0-9a-fA-F]{6}$"`

完整 JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "source_asset_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "outputs": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "version": {
            "type": "number",
            "enum": [
              1
            ]
          },
          "destination": {
            "type": "string",
            "enum": [
              "facebook-feed-square",
              "facebook-feed-landscape",
              "instagram-feed-square",
              "instagram-feed-portrait"
            ]
          },
          "operation": {
            "type": "string",
            "enum": [
              "crop",
              "pad",
              "resize"
            ]
          },
          "focal_point": {
            "type": "object",
            "properties": {
              "x": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "y": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "x",
              "y"
            ],
            "additionalProperties": false
          },
          "background": {
            "type": "string",
            "pattern": "^#[0-9a-fA-F]{6}$"
          }
        },
        "required": [
          "version",
          "destination",
          "operation",
          "focal_point",
          "background"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "workspace_id",
    "source_asset_id",
    "outputs"
  ],
  "additionalProperties": false
}

结构化输出

此 schema 描述成功工具结果中的 structuredContent。MCP 响应也包含 content，并可能在调用失败时设置 isError。对于发布，请读取帖子的最终结果，不要把获接受的请求或文字响应当作确认。链接的 API 操作说明了权限和重试规则。

「必填」是指在其父对象及所选分支内必填。必填子字段不会使可选父对象变成必填。下列规则与字段名称均复制自契约。

结构化输出
字段 / 分支	类型 / 必填	约束
`$`	`object`在父对象中必填	`additionalProperties: {}`
`stage`	`string`在父对象中必填	`enum: ["ready","failed"]`
`output_directory`	`string`可选／项目	—
`manifest_path`	`string`可选／项目	—
`preview_path`	`string`可选／项目	—
`retryable`	`boolean`可选／项目	—
`$.*`	`any JSON value`可选／项目	—

完整 JSON Schema

{
  "type": "object",
  "properties": {
    "stage": {
      "type": "string",
      "enum": [
        "ready",
        "failed"
      ]
    },
    "output_directory": {
      "type": "string"
    },
    "manifest_path": {
      "type": "string"
    },
    "preview_path": {
      "type": "string"
    },
    "retryable": {
      "type": "boolean"
    }
  },
  "required": [
    "stage"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

工具调用示例

这些示例使用已依schema检查的虚构值。请将 ID 替换为你有权使用的 ID、将媒体替换为已就绪素材，并将日期替换为已确认的发布时间。提交写入前，请检查账号资格。本页不会发送 API 请求。

{
  "name": "sosoapi_prepare_asset_images",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "source_asset_id": 42,
    "outputs": [
      {
        "version": 1,
        "destination": "facebook-feed-square",
        "operation": "pad",
        "focal_point": {
          "x": 0.5,
          "y": 0.5
        },
        "background": "#ffffff"
      }
    ]
  }
}

structuredContent

{
  "stage": "ready",
  "output_directory": "/tmp/sosoapi-preparation-example",
  "manifest_path": "/tmp/sosoapi-preparation-example/manifest.json",
  "preview_path": "/tmp/sosoapi-preparation-example/preview.html",
  "images": [
    {
      "file_path": "/tmp/sosoapi-preparation-example/01-facebook-feed-square.jpg",
      "width": 1080,
      "height": 1080,
      "cropped": false,
      "upscaled": false
    }
  ]
}

/assets-api/get

安装或连接 MCP