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

खोज केवल इस्तेमाल करने पर लोड होती है। नीचे सभी श्रेणियाँ देखें।

MCP टूल

एसेट इम्पोर्ट की स्थिति पाएँ

sosoapi_get_asset_import_status

import_id से इम्पोर्ट पढ़ें। पोस्टिंग के लिए include_asset=true दें: तैयार परिणाम में पंजीकृत asset id, kind और स्थिर asset_url शामिल होते हैं, इसलिए अलग get_asset की आवश्यकता नहीं होती। लंबित या अनुपस्थित एसेट निर्धारित नहीं किए जा सकते। स्रोत या प्रीव्यू URL को कभी मीडिया की पहचान न मानें। प्रक्रिया अटकने पर job_id के साथ sosoapi_job_status पढ़ें; डुप्लिकेट इम्पोर्ट कभी शुरू न करें।

Markdown में पढ़ें

प्रोफ़ाइल और ट्रांसपोर्ट

प्रोफ़ाइल: core, full · ट्रांसपोर्ट: stdio, http

क्लाइंट में दिखने वाले टूल के लिए core या full चुनें; इससे अनुमतियाँ नहीं बदलतीं। लोकल फ़ाइल अपलोड के लिए stdio चाहिए और HTTP पर उपलब्ध नहीं। खोज में आउटपुट स्कीमा के लिए SOSOAPI_OUTPUT_SCHEMAS=1 सेट करें। इस सेटिंग के साथ या बिना टूल संरचित परिणाम लौटाते हैं।

अनुमतियाँ और अन्य प्रभाव

एनोटेशन क्लाइंट को टूल का वर्णन करने में मदद करते हैं। हर कॉल फिर भी यूज़र का प्रमाणीकरण, भूमिका, संसाधन एक्सेस और क्षमता अधिकार जाँचती है।

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

इनपुट फ़ील्ड

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

इनपुट फ़ील्ड
फ़ील्ड / शाखाप्रकार / अनिवार्यशर्तें
$objectपैरेंट में अनिवार्य
  • additionalProperties: false
workspace_idstringपैरेंट में अनिवार्य
  • format: "uuid"
import_idstringपैरेंट में अनिवार्य
  • format: "uuid"
include_assetbooleanवैकल्पिक / आइटम—
संपूर्ण JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "import_id": {
      "type": "string",
      "format": "uuid"
    },
    "include_asset": {
      "type": "boolean"
    }
  },
  "required": [
    "workspace_id",
    "import_id"
  ],
  "additionalProperties": false
}

संरचित आउटपुट

यह स्कीमा सफल टूल परिणाम के structuredContent का वर्णन करता है। MCP रिस्पॉन्स में content भी होता है और कॉल विफल होने पर isError सेट हो सकता है। प्रकाशन के लिए स्वीकृत अनुरोध या टेक्स्ट रिस्पॉन्स को पुष्टि मानने के बजाय पोस्ट का अंतिम परिणाम पढ़ें। लिंक किया गया API ऑपरेशन अनुमतियाँ और पुनः प्रयास के नियम समझाता है।

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

संरचित आउटपुट
फ़ील्ड / शाखाप्रकार / अनिवार्यशर्तें
$objectपैरेंट में अनिवार्य
  • additionalProperties: false
importobjectपैरेंट में अनिवार्य
  • additionalProperties: false
import.idstringपैरेंट में अनिवार्य
  • format: "uuid"
import.statusstringपैरेंट में अनिवार्य
  • enum: ["queued","importing","needs_repair","ready","asset_purged","failed"]
import.job_idstring | nullपैरेंट में अनिवार्य—
import.job_idanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
import.job_idanyOf 2nullपैरेंट में अनिवार्य—
import.asset_idinteger | nullपैरेंट में अनिवार्य—
import.asset_idanyOf 1integerपैरेंट में अनिवार्य
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.asset_idanyOf 2nullपैरेंट में अनिवार्य—
import.completed_asset_idinteger | nullपैरेंट में अनिवार्य—
import.completed_asset_idanyOf 1integerपैरेंट में अनिवार्य
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
import.completed_asset_idanyOf 2nullपैरेंट में अनिवार्य—
import.asset_purged_atstring | nullपैरेंट में अनिवार्य—
import.asset_purged_atanyOf 1stringपैरेंट में अनिवार्य—
import.asset_purged_atanyOf 2nullपैरेंट में अनिवार्य—
import.source_urlstringपैरेंट में अनिवार्य
  • format: "uri"
import.final_urlstring | nullपैरेंट में अनिवार्य—
import.final_urlanyOf 1stringपैरेंट में अनिवार्य
  • format: "uri"
import.final_urlanyOf 2nullपैरेंट में अनिवार्य—
import.object_keystring | nullपैरेंट में अनिवार्य—
import.object_keyanyOf 1stringपैरेंट में अनिवार्य
  • minLength: 1
import.object_keyanyOf 2nullपैरेंट में अनिवार्य—
import.content_typestring | nullपैरेंट में अनिवार्य—
import.content_typeanyOf 1stringपैरेंट में अनिवार्य
  • minLength: 1
import.content_typeanyOf 2nullपैरेंट में अनिवार्य—
import.byte_sizeinteger | nullपैरेंट में अनिवार्य—
import.byte_sizeanyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
import.byte_sizeanyOf 2nullपैरेंट में अनिवार्य—
import.content_sha256string | nullपैरेंट में अनिवार्य—
import.content_sha256anyOf 1stringपैरेंट में अनिवार्य
  • pattern: "^[0-9a-f]{64}$"
import.content_sha256anyOf 2nullपैरेंट में अनिवार्य—
import.media_probereference | nullपैरेंट में अनिवार्य—
import.media_probeanyOf 1string | number | boolean | null | array | objectपैरेंट में अनिवार्य—
import.media_probeanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य—
import.media_probeanyOf 1 / anyOf 2numberपैरेंट में अनिवार्य—
import.media_probeanyOf 1 / anyOf 3booleanपैरेंट में अनिवार्य—
import.media_probeanyOf 1 / anyOf 4nullपैरेंट में अनिवार्य—
import.media_probeanyOf 1 / anyOf 5arrayपैरेंट में अनिवार्य—
import.media_probe[]anyOf 1 / anyOf 5referenceवैकल्पिक / आइटम
  • #/definitions/__schema0
import.media_probeanyOf 1 / anyOf 6objectपैरेंट में अनिवार्य
  • additionalProperties: {"$ref":"#/definitions/__schema0"}
import.media_probe.*anyOf 1 / anyOf 6referenceवैकल्पिक / आइटम
  • #/definitions/__schema0
import.media_probeanyOf 2nullपैरेंट में अनिवार्य—
import.error_messagestring | nullपैरेंट में अनिवार्य—
import.error_messageanyOf 1stringपैरेंट में अनिवार्य—
import.error_messageanyOf 2nullपैरेंट में अनिवार्य—
import.created_atstringपैरेंट में अनिवार्य—
import.completed_atstring | nullपैरेंट में अनिवार्य—
import.completed_atanyOf 1stringपैरेंट में अनिवार्य—
import.completed_atanyOf 2nullपैरेंट में अनिवार्य—
assetobject | nullवैकल्पिक / आइटम—
assetanyOf 1objectवैकल्पिक / आइटम
  • additionalProperties: false
asset.idanyOf 1integer | stringपैरेंट में अनिवार्य—
asset.idanyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: -9007199254740991
  • maximum: 9007199254740991
asset.idanyOf 1 / anyOf 2stringपैरेंट में अनिवार्य—
asset.asset_typeanyOf 1stringपैरेंट में अनिवार्य
  • enum: ["text","image","video","audio"]
asset.asset_urlanyOf 1string | nullपैरेंट में अनिवार्य—
asset.asset_urlanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य—
asset.asset_urlanyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
assetanyOf 2nullवैकल्पिक / आइटम—
संपूर्ण JSON Schema
{
  "type": "object",
  "properties": {
    "import": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "status": {
          "type": "string",
          "enum": [
            "queued",
            "importing",
            "needs_repair",
            "ready",
            "asset_purged",
            "failed"
          ]
        },
        "job_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "asset_id": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "completed_asset_id": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "asset_purged_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_url": {
          "type": "string",
          "format": "uri"
        },
        "final_url": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "object_key": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "content_type": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ]
        },
        "byte_size": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "content_sha256": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "media_probe": {
          "anyOf": [
            {
              "$ref": "#/definitions/__schema0"
            },
            {
              "type": "null"
            }
          ]
        },
        "error_message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "completed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "status",
        "job_id",
        "asset_id",
        "completed_asset_id",
        "asset_purged_at",
        "source_url",
        "final_url",
        "object_key",
        "content_type",
        "byte_size",
        "content_sha256",
        "media_probe",
        "error_message",
        "created_at",
        "completed_at"
      ],
      "additionalProperties": false
    },
    "asset": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "string"
                }
              ]
            },
            "asset_type": {
              "type": "string",
              "enum": [
                "text",
                "image",
                "video",
                "audio"
              ]
            },
            "asset_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "id",
            "asset_type",
            "asset_url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "import"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "__schema0": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/definitions/__schema0"
          }
        },
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "$ref": "#/definitions/__schema0"
          }
        }
      ]
    }
  }
}

टूल कॉल का उदाहरण

उदाहरणों में स्कीमा से जाँचे काल्पनिक मान हैं। IDs को अधिकृत IDs, मीडिया को तैयार एसेट और तारीखों को पुष्ट प्रकाशन समय से बदलें। राइट सबमिट करने से पहले खाते की पात्रता जाँचें। यह पेज API अनुरोध नहीं भेजता।

{
  "name": "sosoapi_get_asset_import_status",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "import_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "import": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "queued",
    "job_id": null,
    "asset_id": null,
    "completed_asset_id": null,
    "asset_purged_at": null,
    "source_url": "https://example.com/media.png",
    "final_url": null,
    "object_key": null,
    "content_type": null,
    "byte_size": null,
    "content_sha256": null,
    "media_probe": null,
    "error_message": null,
    "created_at": "example",
    "completed_at": null
  }
}
MCP इंस्टॉल या कनेक्ट करें