SosoAPI
SV
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
Logga in

Sökningen laddas först när du använder den. Bläddra bland alla kategorier nedan.

MCP-verktyg

Skapa mediefil

sosoapi_create_asset

Registrera en mediefilspost för medier eller text som du redan lagrar (asset_url, asset_type). Detta laddar inte upp något: använd sosoapi_upload_asset för en lokal fil eller sosoapi_import_asset_url för att låta SosoAPI hämta en offentlig URL. Ange workspace_id (avvisas utan detta när uttryckligt målval tillämpas). Valfri idempotency_key.

Läs som Markdown

Profiler och transporter

Profiler: full · Transporter: stdio, http

Välj core eller full för att styra vilka verktyg klienten ser; detta ändrar inte dess behörigheter. Lokal filuppladdning kräver stdio och är inte tillgänglig via HTTP. Ange SOSOAPI_OUTPUT_SCHEMAS=1 för att inkludera utdatascheman vid identifiering. Verktygen returnerar strukturerade resultat med eller utan inställningen.

Behörigheter och sidoeffekter

Annoteringar hjälper klienter att beskriva ett verktyg. Varje anrop kontrollerar fortfarande användarens autentisering, roll, resursåtkomst och tilldelade funktionsbehörigheter.

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

Indatafält

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Indatafält
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
workspace_idstringValfritt / objekt
  • format: "uuid"
asset_typestringObligatoriskt i överordnat objekt
  • enum: ["text","image","video"]
asset_urlstringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 2048
titlestringValfritt / objekt
  • maxLength: 200
descriptionstringValfritt / objekt
  • maxLength: 2000
tagsarrayValfritt / objekt
  • maxItems: 50
tags[]stringValfritt / objekt
  • maxLength: 64
metadataobjectValfritt / objekt

Fritt JSON-objekt; dess serialiserade UTF-8-storlek får inte överstiga 16384 byte.

  • additionalProperties: {}
metadata.*any JSON valueValfritt / objekt—
sourcestringValfritt / objekt
  • maxLength: 64
source_metadataobjectValfritt / objekt

Fritt JSON-objekt; dess serialiserade UTF-8-storlek får inte överstiga 16384 byte.

  • additionalProperties: {}
source_metadata.*any JSON valueValfritt / objekt—
idempotency_keystringValfritt / objekt
  • minLength: 8
  • maxLength: 160
Fullständigt JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "asset_type": {
      "type": "string",
      "enum": [
        "text",
        "image",
        "video"
      ]
    },
    "asset_url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      }
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {},
      "description": "Free-form JSON object; its serialized UTF-8 size must not exceed 16384 bytes."
    },
    "source": {
      "type": "string",
      "maxLength": 64
    },
    "source_metadata": {
      "type": "object",
      "additionalProperties": {},
      "description": "Free-form JSON object; its serialized UTF-8 size must not exceed 16384 bytes."
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160
    }
  },
  "required": [
    "asset_type",
    "asset_url"
  ],
  "additionalProperties": false
}

Strukturerat resultat

Detta schema beskriver structuredContent i ett lyckat verktygsresultat. MCP-svaret innehåller även content och kan ange isError när ett anrop misslyckas. För publicering ska du läsa inläggets slutresultat i stället för att tolka en accepterad begäran eller ett textsvar som bekräftelse. Den länkade API-åtgärden förklarar behörigheter och regler för nya försök.

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Strukturerat resultat
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
assetobjectObligatoriskt i överordnat objekt
  • additionalProperties: false
asset.idinteger | stringObligatoriskt i överordnat objekt—
asset.idanyOf 1integerObligatoriskt i överordnat objekt
  • minimum: -9007199254740991
  • maximum: 9007199254740991
asset.idanyOf 2stringObligatoriskt i överordnat objekt—
asset.workspace_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
asset.user_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
asset.asset_typestringObligatoriskt i överordnat objekt
  • enum: ["text","image","video","audio"]
asset.asset_urlstring | nullObligatoriskt i överordnat objekt—
asset.asset_urlanyOf 1stringObligatoriskt i överordnat objekt—
asset.asset_urlanyOf 2nullObligatoriskt i överordnat objekt—
asset.preview_urlstring | nullValfritt / objekt

Tillfällig läs-URL med arbetsytebehörighet. Förnya genom Asset read/list efter preview_expires_at; behåll asset_url som beständig medieidentitet.

—
asset.preview_urlanyOf 1stringValfritt / objekt
  • format: "uri"
asset.preview_urlanyOf 2nullValfritt / objekt—
asset.preview_expires_atstring | nullValfritt / objekt—
asset.preview_expires_atanyOf 1stringValfritt / objekt
  • 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))$"
asset.preview_expires_atanyOf 2nullValfritt / objekt—
asset.titlestring | nullObligatoriskt i överordnat objekt—
asset.titleanyOf 1stringObligatoriskt i överordnat objekt—
asset.titleanyOf 2nullObligatoriskt i överordnat objekt—
asset.descriptionstring | nullObligatoriskt i överordnat objekt—
asset.descriptionanyOf 1stringObligatoriskt i överordnat objekt—
asset.descriptionanyOf 2nullObligatoriskt i överordnat objekt—
asset.tagsarray | nullObligatoriskt i överordnat objekt—
asset.tagsanyOf 1arrayObligatoriskt i överordnat objekt—
asset.tags[]anyOf 1stringValfritt / objekt—
asset.tagsanyOf 2nullObligatoriskt i överordnat objekt—
asset.metadataobject | nullObligatoriskt i överordnat objekt—
asset.metadataanyOf 1objectObligatoriskt i överordnat objekt
  • additionalProperties: {}
asset.metadata.*anyOf 1any JSON valueValfritt / objekt—
asset.metadataanyOf 2nullObligatoriskt i överordnat objekt—
asset.sourcestring | nullValfritt / objekt—
asset.sourceanyOf 1stringValfritt / objekt—
asset.sourceanyOf 2nullValfritt / objekt—
asset.source_metadataobject | nullValfritt / objekt—
asset.source_metadataanyOf 1objectValfritt / objekt
  • additionalProperties: {}
asset.source_metadata.*anyOf 1any JSON valueValfritt / objekt—
asset.source_metadataanyOf 2nullValfritt / objekt—
asset.created_atstringObligatoriskt i överordnat objekt—
asset.versionintegerValfritt / objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
dedupedbooleanObligatoriskt i överordnat objekt—
Fullständigt JSON Schema
{
  "type": "object",
  "properties": {
    "asset": {
      "type": "object",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "string"
            }
          ]
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "user_id": {
          "type": "string",
          "format": "uuid"
        },
        "asset_type": {
          "type": "string",
          "enum": [
            "text",
            "image",
            "video",
            "audio"
          ]
        },
        "asset_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "preview_url": {
          "description": "Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.",
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "preview_expires_at": {
          "anyOf": [
            {
              "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))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "tags": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "metadata": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_metadata": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "id",
        "workspace_id",
        "user_id",
        "asset_type",
        "asset_url",
        "title",
        "description",
        "tags",
        "metadata",
        "created_at"
      ],
      "additionalProperties": false
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "asset",
    "deduped"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Exempel på verktygsanrop

Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop.

{
  "name": "sosoapi_create_asset",
  "arguments": {
    "asset_type": "text",
    "asset_url": "example"
  }
}

structuredContent

{
  "asset": {
    "id": 0,
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "user_id": "11111111-1111-4111-8111-111111111111",
    "asset_type": "text",
    "asset_url": null,
    "title": null,
    "description": null,
    "tags": null,
    "metadata": null,
    "created_at": "example"
  },
  "deduped": false
}
Installera eller anslut MCP