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

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

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

المعامِلات

المعامِلالنوعمطلوبالوصف
imagestringنعمالصورة المصدر مُشفّرة بـ base64.
scalenumberلاعامل الترقية. استخدم القيم المدعومة المذكورة في مرجع واجهة برمجة التطبيقات وكتالوج النماذج.
الاستجابة هي بيانات صورة ثنائية، وليست JSON. اكتب جسم الاستجابة مباشرة إلى ملف أو دفّقه إلى التخزين.

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

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

موارد ذات صلة