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

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

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

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

​

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

Python

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)

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);

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

​

المعامِلات

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

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

​

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

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

​

موارد ذات صلة

• واجهة برمجة تطبيقات ترقية الصور
• نماذج الصور
• دليل تحرير الصور