<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>png to pptx on Document Processing REST APIs | GroupDocs Cloud</title>
    <link>https://blog-qa.groupdocs.cloud/fa/tag/png-to-pptx/</link>
    <description>Recent content in png to pptx on Document Processing REST APIs | GroupDocs Cloud</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>fa</language>
    <lastBuildDate>Mon, 03 Aug 2026 11:11:03 +0000</lastBuildDate><atom:link href="https://blog-qa.groupdocs.cloud/fa/tag/png-to-pptx/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>آموزش گام به گام تبدیل PNG به PPTX در پایتون</title>
      <link>https://blog-qa.groupdocs.cloud/fa/conversion/step-by-step-png-to-pptx-conversion-tutorial-in-python/</link>
      <pubDate>Mon, 03 Aug 2026 11:11:03 +0000</pubDate>
      
      <guid>https://blog-qa.groupdocs.cloud/fa/conversion/step-by-step-png-to-pptx-conversion-tutorial-in-python/</guid>
      <description>تبدیل تصاویر PNG به ارائه‌های PPTX در Python با استفاده از GroupDocs.Conversion Cloud SDK. این راهنمای گام‌به‌گام را همراه با کد، دستورات cURL و نکات دنبال کنید.</description>
      <content:encoded><![CDATA[<p>تبدیل فایل‌های <a href="https://docs.fileformat.com/image/png/">PNG</a> به اسلایدهای PowerPoint یک نیاز متداول هنگام ساخت ابزارهای گزارش‌گیری خودکار است. <a href="https://products.groupdocs.cloud/conversion/python/">GroupDocs.Conversion Cloud SDK for Python</a> یک API ساده فراهم می‌کند که کارهای سنگین را در ابر انجام می‌دهد. در این راهنما شما یاد خواهید گرفت چگونه SDK را تنظیم کنید، یک PNG را بارگذاری کنید، آن را به <a href="https://docs.fileformat.com/presentation/pptx/">PPTX</a> تبدیل کنید و نتیجه را بازیابی کنید، همه با مثال‌های کد واضح. در پایان می‌توانید تبدیل PNG به PPTX را با اطمینان در پروژه‌های Python ادغام کنید.</p>
<h2 id="قبل-از-شروع-پیشنیازها-و-نصب">قبل از شروع: پیش‌نیازها و نصب</h2>
<p>قبل از شروع، مطمئن شوید که موارد زیر را دارید:</p>
<ul>
<li>Python 3.7 یا جدیدتر بر روی ماشین توسعه شما نصب شده باشد.</li>
<li>یک حساب GroupDocs Cloud با <strong>client_id</strong> و <strong>client_secret</strong> (آنها را از پورتال GroupDocs دریافت کنید).</li>
<li>دسترسی به اینترنت برای SDK جهت ارتباط با سرویس ابری.</li>
</ul>
<p>SDK را از طریق pip نصب کنید:</p>
<!--[CODE_SNIPPET_START]-->
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>pip install groupdocs-conversion-cloud
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<p>شما می‌توانید آخرین بسته را از صفحهٔ رسمی انتشار دانلود کنید: <a href="https://releases.groupdocs.cloud/conversion/python/">GroupDocs.Conversion Cloud SDK for Python Download</a>. پس از نصب، آماده‌اید کدی بنویسید که با GroupDocs Conversion API ارتباط برقرار کند.</p>
<h2 id="تبدیل-png-به-pptx-در-پایتون-راهنمای-گام-به-گام">تبدیل PNG به PPTX در پایتون: راهنمای گام به گام</h2>
<h3 id="مرحله-1-پیکربندی-اعتبارها">مرحله 1: پیکربندی اعتبارها</h3>
<p>ابتدا یک شیء پیکربندی ایجاد کنید و اعتبارنامه‌های مشتری خود را تنظیم کنید. این شیء توسط تمام تماس‌های API بعدی استفاده می‌شود.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span><span style="color:#f92672">from</span> groupdocs_conversion_cloud <span style="color:#f92672">import</span> Configuration, ApiClient
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>client_id <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;YOUR_CLIENT_ID&#34;</span>
</span></span><span style="display:flex;"><span>client_secret <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;YOUR_CLIENT_SECRET&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>config <span style="color:#f92672">=</span> Configuration()
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span>client_id <span style="color:#f92672">=</span> client_id
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span>client_secret <span style="color:#f92672">=</span> client_secret
</span></span><span style="display:flex;"><span>api_client <span style="color:#f92672">=</span> ApiClient(config)
</span></span></code></pre></div><h3 id="مرحله۲-بارگذاری-png-در-ذخیرهسازی-ابری">مرحله ۲: بارگذاری PNG در ذخیره‌سازی ابری</h3>
<p>SDK فایل‌ها را در ذخیره‌سازی GroupDocs Cloud ذخیره می‌کند. فایل PNG محلی خود را بارگذاری کنید تا توسط سرویس تبدیل قابل دسترسی باشد.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span><span style="color:#f92672">import</span> os
</span></span><span style="display:flex;"><span><span style="color:#f92672">from</span> groupdocs_conversion_cloud <span style="color:#f92672">import</span> StorageApi, UploadFileRequest
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>storage_api <span style="color:#f92672">=</span> StorageApi(api_client)
</span></span><span style="display:flex;"><span>local_png_path <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;sample_image.png&#34;</span>
</span></span><span style="display:flex;"><span>cloud_png_path <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;sample_image.png&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">if</span> os<span style="color:#f92672">.</span>path<span style="color:#f92672">.</span>isfile(local_png_path):
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">with</span> open(local_png_path, <span style="color:#e6db74">&#34;rb&#34;</span>) <span style="color:#66d9ef">as</span> file_stream:
</span></span><span style="display:flex;"><span>        upload_request <span style="color:#f92672">=</span> UploadFileRequest(path<span style="color:#f92672">=</span>cloud_png_path, file<span style="color:#f92672">=</span>file_stream)
</span></span><span style="display:flex;"><span>        storage_api<span style="color:#f92672">.</span>upload_file(upload_request)
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">else</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">raise</span> <span style="color:#a6e22e">FileNotFoundError</span>(<span style="color:#e6db74">f</span><span style="color:#e6db74">&#34;Local file not found: </span><span style="color:#e6db74">{</span>local_png_path<span style="color:#e6db74">}</span><span style="color:#e6db74">&#34;</span>)
</span></span></code></pre></div><h3 id="مرحله-۳-تنظیم-گزینههای-تبدیل">مرحله ۳: تنظیم گزینه‌های تبدیل</h3>
<p>یک شیء <code>PptxConvertOptions</code> ایجاد کنید. برای یک PNG تک‑صفحه، ویژگی <code>pages</code> هیچ تأثیری ندارد، اما نشان می‌دهد که چگونه می‌توانید صفحات را برای منابع چند‑صفحه محدود کنید.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span><span style="color:#f92672">from</span> groupdocs_conversion_cloud <span style="color:#f92672">import</span> PptxConvertOptions
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>pptx_options <span style="color:#f92672">=</span> PptxConvertOptions()
</span></span><span style="display:flex;"><span>pptx_options<span style="color:#f92672">.</span>pages <span style="color:#f92672">=</span> [<span style="color:#ae81ff">1</span>]  <span style="color:#75715e"># Limit to first page (useful for PDFs)</span>
</span></span></code></pre></div><h3 id="مرحله-4-تعریف-تنظیمات-تبدیل">مرحله 4: تعریف تنظیمات تبدیل</h3>
<p>فایل منبع، قالب هدف، مسیر خروجی و گزینه‌های ایجاد شده در بالا را مشخص کنید.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span><span style="color:#f92672">from</span> groupdocs_conversion_cloud <span style="color:#f92672">import</span> ConvertSettings
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>convert_settings <span style="color:#f92672">=</span> ConvertSettings()
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>file_path <span style="color:#f92672">=</span> cloud_png_path          <span style="color:#75715e"># source file in cloud storage</span>
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>format <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;pptx&#34;</span>                     <span style="color:#75715e"># target format</span>
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>output_path <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;sample_image_converted.pptx&#34;</span>
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>options <span style="color:#f92672">=</span> pptx_options
</span></span><span style="display:flex;"><span><span style="color:#75715e"># convert_settings.storage_name = &#34;MyStorage&#34;  # optional custom storage</span>
</span></span></code></pre></div><h3 id="مرحله-5-اجرای-تبدیل-و-مدیریت-نتیجه">مرحله 5: اجرای تبدیل و مدیریت نتیجه</h3>
<p>متد <code>convert_document</code> را فراخوانی کنید. پاسخ شامل مسیر فایل PPTX تولید شده است.</p>
<!--[CODE_SNIPPET_START]-->
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span><span style="color:#f92672">from</span> groupdocs_conversion_cloud <span style="color:#f92672">import</span> ConvertApi
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>convert_api <span style="color:#f92672">=</span> ConvertApi(api_client)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">try</span>:
</span></span><span style="display:flex;"><span>    conversion_result <span style="color:#f92672">=</span> convert_api<span style="color:#f92672">.</span>convert_document(convert_settings)
</span></span><span style="display:flex;"><span>    print(<span style="color:#e6db74">&#34;Conversion successful!&#34;</span>)
</span></span><span style="display:flex;"><span>    print(<span style="color:#e6db74">f</span><span style="color:#e6db74">&#34;Converted file stored at: </span><span style="color:#e6db74">{</span>conversion_result<span style="color:#f92672">.</span>path<span style="color:#e6db74">}</span><span style="color:#e6db74">&#34;</span>)
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">except</span> <span style="color:#a6e22e">Exception</span> <span style="color:#66d9ef">as</span> e:
</span></span><span style="display:flex;"><span>    print(<span style="color:#e6db74">&#34;An error occurred during conversion:&#34;</span>)
</span></span><span style="display:flex;"><span>    print(e)
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<h3 id="مرحله-6-اختیاری-دانلود-فایل-pptx-تولید-شده">مرحله 6: (اختیاری) دانلود فایل PPTX تولید شده</h3>
<p>اگر به فایل به صورت محلی نیاز دارید، می‌توانید آن را از ذخیره‌سازی ابری دانلود کنید.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span>download_path <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;downloaded_sample_image_converted.pptx&#34;</span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">with</span> open(download_path, <span style="color:#e6db74">&#34;wb&#34;</span>) <span style="color:#66d9ef">as</span> out_file:
</span></span><span style="display:flex;"><span>    download_request <span style="color:#f92672">=</span> storage_api<span style="color:#f92672">.</span>download_file(<span style="color:#e6db74">&#34;sample_image_converted.pptx&#34;</span>)
</span></span><span style="display:flex;"><span>    out_file<span style="color:#f92672">.</span>write(download_request<span style="color:#f92672">.</span>read())
</span></span><span style="display:flex;"><span>print(<span style="color:#e6db74">f</span><span style="color:#e6db74">&#34;PPTX downloaded to: </span><span style="color:#e6db74">{</span>download_path<span style="color:#e6db74">}</span><span style="color:#e6db74">&#34;</span>)
</span></span></code></pre></div><h2 id="مثال-کامل-کد-تبدیل-png-به-pptx-با-پیادهسازی-کامل">مثال کامل کد: تبدیل PNG به PPTX با پیاده‌سازی کامل</h2>
<p>اسکریپت زیر تمام قطعات را به هم می‌پیوندد. این اسکریپت یک تبدیل کامل انتها‑به‑انتها از PNG به PPTX را با استفاده از GroupDocs.Conversion Cloud SDK for Python نشان می‌دهد.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-python" data-lang="python"><span style="display:flex;"><span><span style="color:#f92672">import</span> os
</span></span><span style="display:flex;"><span><span style="color:#f92672">from</span> groupdocs_conversion_cloud <span style="color:#f92672">import</span> (
</span></span><span style="display:flex;"><span>    Configuration,
</span></span><span style="display:flex;"><span>    ApiClient,
</span></span><span style="display:flex;"><span>    ConvertApi,
</span></span><span style="display:flex;"><span>    ConvertSettings,
</span></span><span style="display:flex;"><span>    PptxConvertOptions,
</span></span><span style="display:flex;"><span>    StorageApi,
</span></span><span style="display:flex;"><span>    UploadFileRequest,
</span></span><span style="display:flex;"><span>)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- Configuration --------------------</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># Replace with your actual GroupDocs Cloud credentials</span>
</span></span><span style="display:flex;"><span>client_id <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;YOUR_CLIENT_ID&#34;</span>
</span></span><span style="display:flex;"><span>client_secret <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;YOUR_CLIENT_SECRET&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>config <span style="color:#f92672">=</span> Configuration()
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span>client_id <span style="color:#f92672">=</span> client_id
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span>client_secret <span style="color:#f92672">=</span> client_secret
</span></span><span style="display:flex;"><span>api_client <span style="color:#f92672">=</span> ApiClient(config)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- APIs --------------------</span>
</span></span><span style="display:flex;"><span>convert_api <span style="color:#f92672">=</span> ConvertApi(api_client)
</span></span><span style="display:flex;"><span>storage_api <span style="color:#f92672">=</span> StorageApi(api_client)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- File Paths --------------------</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># Local PNG file to be uploaded and converted</span>
</span></span><span style="display:flex;"><span>local_png_path <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;sample_image.png&#34;</span>          <span style="color:#75715e"># &lt;-- ensure this file exists locally</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># Path inside GroupDocs Cloud storage</span>
</span></span><span style="display:flex;"><span>cloud_png_path <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;sample_image.png&#34;</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># Desired output PPTX file name in cloud storage</span>
</span></span><span style="display:flex;"><span>cloud_pptx_path <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;sample_image_converted.pptx&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- Upload PNG to Cloud Storage --------------------</span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">if</span> os<span style="color:#f92672">.</span>path<span style="color:#f92672">.</span>isfile(local_png_path):
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">with</span> open(local_png_path, <span style="color:#e6db74">&#34;rb&#34;</span>) <span style="color:#66d9ef">as</span> file_stream:
</span></span><span style="display:flex;"><span>        upload_request <span style="color:#f92672">=</span> UploadFileRequest(path<span style="color:#f92672">=</span>cloud_png_path, file<span style="color:#f92672">=</span>file_stream)
</span></span><span style="display:flex;"><span>        storage_api<span style="color:#f92672">.</span>upload_file(upload_request)
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">else</span>:
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">raise</span> <span style="color:#a6e22e">FileNotFoundError</span>(<span style="color:#e6db74">f</span><span style="color:#e6db74">&#34;Local file not found: </span><span style="color:#e6db74">{</span>local_png_path<span style="color:#e6db74">}</span><span style="color:#e6db74">&#34;</span>)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- Conversion Options --------------------</span>
</span></span><span style="display:flex;"><span>pptx_options <span style="color:#f92672">=</span> PptxConvertOptions()
</span></span><span style="display:flex;"><span><span style="color:#75715e"># Example performance tweak: limit conversion to first page (useful for multi‑page PDFs)</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># For a single PNG this has no effect but demonstrates the property.</span>
</span></span><span style="display:flex;"><span>pptx_options<span style="color:#f92672">.</span>pages <span style="color:#f92672">=</span> [<span style="color:#ae81ff">1</span>]
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- Conversion Settings --------------------</span>
</span></span><span style="display:flex;"><span>convert_settings <span style="color:#f92672">=</span> ConvertSettings()
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>file_path <span style="color:#f92672">=</span> cloud_png_path          <span style="color:#75715e"># source file in cloud storage</span>
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>format <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;pptx&#34;</span>                     <span style="color:#75715e"># target format</span>
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>output_path <span style="color:#f92672">=</span> cloud_pptx_path       <span style="color:#75715e"># output file in cloud storage</span>
</span></span><span style="display:flex;"><span>convert_settings<span style="color:#f92672">.</span>options <span style="color:#f92672">=</span> pptx_options
</span></span><span style="display:flex;"><span><span style="color:#75715e"># If you have a dedicated storage, set its name:</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># convert_settings.storage_name = &#34;MyStorage&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- Execute Conversion --------------------</span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">try</span>:
</span></span><span style="display:flex;"><span>    conversion_result <span style="color:#f92672">=</span> convert_api<span style="color:#f92672">.</span>convert_document(convert_settings)
</span></span><span style="display:flex;"><span>    <span style="color:#75715e"># conversion_result contains details like the URL of the converted file</span>
</span></span><span style="display:flex;"><span>    print(<span style="color:#e6db74">&#34;Conversion successful!&#34;</span>)
</span></span><span style="display:flex;"><span>    print(<span style="color:#e6db74">f</span><span style="color:#e6db74">&#34;Converted file stored at: </span><span style="color:#e6db74">{</span>conversion_result<span style="color:#f92672">.</span>path<span style="color:#e6db74">}</span><span style="color:#e6db74">&#34;</span>)
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">except</span> <span style="color:#a6e22e">Exception</span> <span style="color:#66d9ef">as</span> e:
</span></span><span style="display:flex;"><span>    print(<span style="color:#e6db74">&#34;An error occurred during conversion:&#34;</span>)
</span></span><span style="display:flex;"><span>    print(e)
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># -------------------- (Optional) Download Result --------------------</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># Uncomment the following block if you want to download the PPTX locally.</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># download_path = &#34;downloaded_sample_image_converted.pptx&#34;</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># with open(download_path, &#34;wb&#34;) as out_file:</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">#     download_request = storage_api.download_file(cloud_pptx_path)</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">#     out_file.write(download_request.read())</span>
</span></span><span style="display:flex;"><span><span style="color:#75715e"># print(f&#34;PPTX downloaded to: {download_path}&#34;)</span>
</span></span></code></pre></div><blockquote>
<p><strong>توجه:</strong> این مثال کد عملکرد اصلی را نشان می‌دهد. پیش از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (<code>sample_image.png</code>، <code>sample_image_converted.pptx</code> و غیره) را به مکان‌های واقعی خود به‌روز کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به <a href="https://docs.groupdocs.cloud/conversion/">مستندات رسمی</a> مراجعه کنید یا برای دریافت کمک با <a href="https://forum.groupdocs.cloud/c/conversion/11">تیم پشتیبانی</a> تماس بگیرید.</p>
</blockquote>
<h2 id="تبدیل-تصویر-به-پاورپوینت-از-طریق-rest-api-با-استفاده-از-curl">تبدیل تصویر به پاورپوینت از طریق REST API با استفاده از cURL</h2>
<p>اگر ترجیح می‌دهید از رویکرد صرفاً REST استفاده کنید، همان تبدیل می‌تواند با دستورات cURL انجام شود. جریان مراحل SDK را بازتاب می‌دهد: احراز هویت، بارگذاری، تبدیل و دانلود.</p>
<h3 id="1-احراز-هویت-و-دریافت-توکن-دسترسی">1. احراز هویت و دریافت توکن دسترسی</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X POST <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v2.0/connect/token&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Content-Type: application/x-www-form-urlencoded&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -d <span style="color:#e6db74">&#34;grant_type=client_credentials&amp;client_id=YOUR_CLIENT_ID&amp;client_secret=YOUR_CLIENT_SECRET&#34;</span>
</span></span></code></pre></div><p>پاسخ یک <code>access_token</code> برمی‌گرداند که در تماس‌های بعدی استفاده می‌شود.</p>
<h3 id="2-بارگذاری-png-منبع">2. بارگذاری PNG منبع</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X PUT <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v2.0/storage/file/sample_image.png&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Authorization: Bearer YOUR_ACCESS_TOKEN&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Content-Type: application/octet-stream&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     --data-binary <span style="color:#e6db74">&#34;@sample_image.png&#34;</span>
</span></span></code></pre></div><h3 id="3-اجرای-تبدیل">3. اجرای تبدیل</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X POST <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v2.0/conversion/convert?format=pptx&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Authorization: Bearer YOUR_ACCESS_TOKEN&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Content-Type: application/json&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -d <span style="color:#e6db74">&#39;{
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           &#34;filePath&#34;: &#34;sample_image.png&#34;,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           &#34;outputPath&#34;: &#34;sample_image_converted.pptx&#34;,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           &#34;options&#34;: {
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">               &#34;pages&#34;: [1]
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           }
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">         }&#39;</span>
</span></span></code></pre></div><p>API یک شیء <a href="https://docs.fileformat.com/web/json/">JSON</a> را برمی‌گرداند که شامل <code>path</code> فایل PPTX تولید شده است.</p>
<h3 id="4-دانلود-pptx-حاصل">4. دانلود PPTX حاصل</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X GET <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v2.0/storage/file/sample_image_converted.pptx&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Authorization: Bearer YOUR_ACCESS_TOKEN&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -o downloaded_sample_image_converted.pptx
</span></span></code></pre></div><p>برای جزئیات بیشتر در مورد بارهای درخواست و پارامترهای اضافی، به <a href="https://reference.groupdocs.cloud/conversion/">مرجع API</a> مراجعه کنید.</p>
<h2 id="بهینهسازی-عملکرد-تبدیل-تصویر-به-پاورپوینت">بهینه‌سازی عملکرد تبدیل تصویر به پاورپوینت</h2>
<ol>
<li><strong>قبل از بارگذاری، PNGهای بزرگ را تغییر اندازه دهید</strong> - کاهش ابعاد تصویر مصرف حافظه را در حین تبدیل کاهش می‌دهد. از Pillow یا OpenCV برای کاهش اندازه تصاویر به وضوح مورد نیاز استفاده کنید.</li>
<li><strong>از همان نمونه ApiClient مجدداً استفاده کنید</strong> - ایجاد یک کلاینت جدید برای هر درخواست بار اضافی ایجاد می‌کند. یک شیء <code>ApiClient</code> واحد را برای تمام جلسه تبدیل نگه دارید.</li>
<li><strong>در هنگام تبدیل منابع چندصفحه، صفحات را محدود کنید</strong> - گزینه <code>pages</code> از پردازش غیرضروری صفحاتی که نیاز ندارید جلوگیری می‌کند، که عملیات را سریع‌تر می‌سازد و پهنای باند را کاهش می‌دهد.</li>
<li><strong>برای فایل‌های بزرگ، استریمینگ را فعال کنید</strong> - هنگام کار با PNGهای بسیار بزرگ، برای بارگذاری و دانلود از APIهای استریمینگ استفاده کنید تا از بارگذاری کل فایل در حافظه جلوگیری شود.</li>
</ol>
<p>اعمال این نکات به دستیابی به عملکرد سریع‌تر تبدیل PNG به PPTX در برنامه‌های پایتون کمک می‌کند.</p>
<h2 id="نتیجهگیری">نتیجه‌گیری</h2>
<p>تبدیل برنامه‌ای PNG به PPTX در پایتون با استفاده از <a href="https://products.groupdocs.cloud/conversion/python/">GroupDocs.Conversion Cloud SDK for Python</a> به سادگی انجام می‌شود. با دنبال کردن مراحل توضیح داده شده در بالا، تنظیم اعتبارنامه‌ها، بارگذاری تصویر، پیکربندی گزینه‌های تبدیل و اجرای فراخوانی API می‌توانید به‌طور قابل اعتماد اسلایدهای PowerPoint را از گرافیک‌ها تولید کنید. به یاد داشته باشید که با اندازه‌های نماینده تصویر تست کنید و توصیه‌های عملکردی را اعمال کنید تا برنامه شما پاسخگو بماند. برای استقرارهای تولیدی، یک لایسنس مناسب دریافت کنید؛ می‌توانید گزینه‌های قیمت‌گذاری را بررسی کنید یا از <a href="https://purchase.groupdocs.cloud/temporary-license/">صفحه لایسنس موقت</a> یک لایسنس موقت درخواست کنید.</p>
<h2 id="سوالات-متداول">سوالات متداول</h2>
<ul>
<li>
<p><strong>چگونه می‌توانم تبدیل PNG به PPTX را در پایتون با استفاده از GroupDocs انجام دهم؟</strong><br>
از SDK برای بارگذاری PNG خود استفاده کنید، <code>PptxConvertOptions</code> را تنظیم کنید و <code>convert_document</code> را فراخوانی کنید. مثال کامل کد در این مقاله پیاده‌سازی دقیق را نشان می‌دهد.</p>
</li>
<li>
<p><strong>آیا پس از تبدیل با Python می‌توان فایل‌های PPTX را ویرایش کرد؟</strong><br>
در حالی که Conversion SDK بر تبدیل فرمت تمرکز دارد، می‌توانید از همان کتابخانه برای به‌روزرسانی فایل‌های PowerPoint در Python استفاده کنید یا آن را با GroupDocs.Editor Cloud SDK ترکیب کنید تا قابلیت‌های پیشرفته‌تری برای ویرایش PPTX فراهم شود.</p>
</li>
<li>
<p><strong>بهترین روش‌ها برای بهینه‌سازی عملکرد تبدیل PNG به PPTX در پایتون چیست؟</strong><br>
رزولوشن تصویر را پیش از بارگذاری کاهش دهید، نمونه <code>ApiClient</code> را مجدداً استفاده کنید، صفحات را با گزینه <code>pages</code> محدود کنید، و به جای بارگذاری کامل فایل‌های بزرگ در حافظه، آن‌ها را به صورت جریان (stream) پردازش کنید.</p>
</li>
<li>
<p><strong>آیا برای اجرای این کد در محیط تولید به مجوز نیاز دارم؟</strong><br>
بله. یک مجوز موقت برای ارزیابی در دسترس است و می‌توانید یک مجوز کامل را از صفحه قیمت‌گذاری GroupDocs خریداری کنید. برای جزئیات، صفحهٔ <a href="https://purchase.groupdocs.cloud/temporary-license/">مجوز موقت</a> را ببینید.</p>
</li>
</ul>
<h2 id="ادامه-مطلب">ادامه مطلب</h2>
<ul>
<li><a href="https://blog.groupdocs.cloud/fa/conversion/how-to-docx-to-html-conversion-in-python/">نحوه تبدیل DOCX به HTML در Python</a></li>
<li><a href="https://blog.groupdocs.cloud/fa/conversion/how-to-enable-csv-to-pdf-conversion-on-the-fly-in-python/">نحوه فعال‌سازی تبدیل CSV به PDF به‌صورت لحظه‌ای در Python</a></li>
<li><a href="https://blog.groupdocs.cloud/fa/conversion/step-by-step-html-to-docx-conversion-tutorial-in-nodejs/">آموزش گام‌به‌گام تبدیل HTML به DOCX در Node.JS</a></li>
</ul>
]]></content:encoded>
    </item>
    
  </channel>
</rss>
