# एसेट URL इम्पोर्ट करें

कैनोनिकल URL: https://sosoapi.ai/hi/docs/mcp/import-asset-url

`sosoapi_import_asset_url`

SosoAPI को सार्वजनिक http(s) इमेज या वीडियो URL निजी Workspace स्टोरेज में नए एसेट के रूप में डाउनलोड करने को कहें। import_id लौटाता है; sosoapi_get_asset_import_status को पोल करें। idempotency_key और editor भूमिका आवश्यक है।

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

प्रोफ़ाइल: core, full

ट्रांसपोर्ट: stdio, http

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

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

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

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

`/assets-api/imports/url` — agent:operate; queued_asynchronous_poll_import_status

## इनपुट फ़ील्ड

```json
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "source_url": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "expected_kind": {
      "type": "string",
      "enum": [
        "image",
        "video"
      ]
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      }
    }
  },
  "required": [
    "workspace_id",
    "source_url",
    "idempotency_key"
  ],
  "additionalProperties": false
}
```

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

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

```json
{
  "type": "object",
  "properties": {
    "import_id": {
      "type": "string",
      "format": "uuid"
    },
    "job_id": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "importing",
        "needs_repair",
        "ready",
        "asset_purged",
        "failed"
      ]
    }
  },
  "required": [
    "import_id",
    "job_id",
    "status"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}
```

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

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

```json
{
  "name": "sosoapi_import_asset_url",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "source_url": "https://example.com/media.png",
    "idempotency_key": "example-intent-0001"
  }
}
```

structuredContent

```json
{
  "import_id": "11111111-1111-4111-8111-111111111111",
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "queued"
}
```

## आधारभूत API ऑपरेशन

- [/assets-api/imports/url](https://sosoapi.ai/hi/docs/api/assets-api-imports-url)