> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> حسّن الصور وارفع دقّتها باستخدام واجهة برمجة التطبيقات المتزامنة لترقية الصور في Venice، مع مدخلات base64 ومخرجات صورية ثنائية.

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

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

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

<CodeGroup>
  ```python Python theme={"system"}
  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={"system"}
  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={"system"}
  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)