> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-e9b472fd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ترقية دقّة الصور

> حسّن الصور وارفع دقّتها باستخدام واجهة /image/upscale المتزامنة في Venice، بإرسال مدخلات مُشفّرة بـ base64 واستقبال مخرجات صورية ثنائية بدقّة أعلى.

تُحسّن ترقية الصور دقّةَ الصورة الحالية وجودتها البصرية. أرسل صورة مُشفّرة بـ base64 إلى `/image/upscale`، واختر عامل التكبير، ويُعيد Venice الصورة المُحسّنة كبيانات ثنائية.

استخدم ترقية الصور عندما تمتلك بالفعل صورة وتريد مخرجًا بدقّة أعلى. استخدم [توليد الصور](/guides/media/image-generation) عندما تحتاج إلى إنشاء صورة من مطالبة، و[تحرير الصور](/guides/media/image-editing) عندما تحتاج إلى تغيير محتوى الصورة.

## الاستخدام الأساسي

<CodeGroup>
  ```python Python theme={null}
  import base64
  import os
  from pathlib import Path

  import requests

  image_base64 = base64.b64encode(Path("input.jpg").read_bytes()).decode("utf-8")

  response = requests.post(
      "https://api.venice.ai/api/v1/image/upscale",
      headers={
          "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
          "image": image_base64,
          "scale": 2,
      },
  )

  response.raise_for_status()
  Path("upscaled.png").write_bytes(response.content)
  ```

  ```javascript Node.js theme={null}
  import { readFile, writeFile } from "node:fs/promises";

  const image = await readFile("input.jpg");

  const response = await fetch("https://api.venice.ai/api/v1/image/upscale", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      image: image.toString("base64"),
      scale: 2,
    }),
  });

  if (!response.ok) {
    throw new Error(await response.text());
  }

  const output = Buffer.from(await response.arrayBuffer());
  await writeFile("upscaled.png", output);
  ```

  ```bash cURL theme={null}
  IMAGE_BASE64=$(base64 < input.jpg | tr -d '\n')

  curl https://api.venice.ai/api/v1/image/upscale \
    -H "Authorization: Bearer $VENICE_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"image\": \"$IMAGE_BASE64\",
      \"scale\": 2
    }" \
    --output upscaled.png
  ```
</CodeGroup>

## المعامِلات

| المعامِل | النوع  | مطلوب | الوصف                                                                                       |
| -------- | ------ | ----- | ------------------------------------------------------------------------------------------- |
| `image`  | string | نعم   | الصورة المصدر مُشفّرة بـ base64.                                                            |
| `scale`  | number | لا    | عامل الترقية. استخدم القيم المدعومة المذكورة في مرجع واجهة برمجة التطبيقات وكتالوج النماذج. |

<Note>
  الاستجابة هي بيانات صورة ثنائية، وليست JSON. اكتب جسم الاستجابة مباشرة إلى ملف أو دفّقه إلى التخزين.
</Note>

## نصائح المدخلات

* ابدأ بأنقى صورة مصدر تمتلكها. تُحسّن الترقية التفاصيل، لكنها لا تستطيع استعادة معلومات غير موجودة أصلًا بشكل كامل.
* استخدم عوامل تكبير معتدلة لسير العمل الإنتاجي. المخرجات الكبيرة جدًا قد تزيد زمن الاستجابة وحجم الملف.
* احتفظ بالصورة الأصلية إذا كنت بحاجة إلى مقارنة الجودة أو إعادة المحاولة بإعدادات مختلفة.

## موارد ذات صلة

* [واجهة برمجة تطبيقات ترقية الصور](/api-reference/endpoint/image/upscale)
* [نماذج الصور](/models/image)
* [دليل تحرير الصور](/guides/media/image-editing)