# إنشاء ملف PDF بصور مرتبة محليًا

الرابط الأساسي: https://sosoapi.ai/ar/docs/mcp/build-image-pdf

`sosoapi_build_image_pdf`

أنشئ ملف PDF قابلًا للتنزيل يضم الصور فقط ومعاينات صفحات JPEG المطابقة، من 1–20 صورة PNG/JPEG مصرح بها في Workspace وفق ترتيب المصفوفة. يلائم الصور كاملة دون قص؛ يدعم عنوان Unicode وصفحات مربعة أو رأسية أو أفقية. الحد الأقصى للمخرجات 50 MiB. يعيد الملفات المحلية ومعلومات المصدر. مستقل عن صلاحية الوصول إلى LinkedIn؛ لا يسجل PDF بوصفه صورة ولا ينشر شيئًا.

## الملفات التعريفية ووسائل النقل

الملفات التعريفية: core, full

وسائل النقل: stdio

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

## الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

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

`/assets-api/get` — agent:operate; synchronous_http_response

## حقول الإدخال

```json
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "source_asset_ids": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "preset": {
      "type": "string",
      "enum": [
        "square",
        "portrait",
        "landscape"
      ]
    }
  },
  "required": [
    "workspace_id",
    "source_asset_ids",
    "title",
    "preset"
  ],
  "additionalProperties": false
}
```

## مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

```json
{
  "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": {}
}
```

## مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

```json
{
  "name": "sosoapi_build_image_pdf",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "source_asset_ids": [
      42,
      43
    ],
    "title": "圖片 / Images",
    "preset": "portrait"
  }
}
```

structuredContent

```json
{
  "stage": "ready",
  "output_directory": "/tmp/sosoapi-preparation-example",
  "manifest_path": "/tmp/sosoapi-preparation-example/manifest.json",
  "preview_path": "/tmp/sosoapi-preparation-example/preview.html",
  "file_path": "/tmp/sosoapi-preparation-example/document.pdf",
  "title": "圖片 / Images",
  "preset": "portrait",
  "pages": [
    {
      "source_asset_id": 42
    },
    {
      "source_asset_id": 43
    }
  ]
}
```

## عمليات API الأساسية

- [/assets-api/get](https://sosoapi.ai/ar/docs/api/assets-api-get)