تخطّي إلى المحتوى

Topaz Upscale Image Generative

التكامل

معرّف النموذج topaz/upscale/image/generative
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏0.08 $⁩ 80 رصيد API · ≈ ⁨‏8.44 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Topaz Labs تحسين الدقة #upscale#image

أداة توليدية لرفع دقة الصور مع نماذج متعددة وتحسين للوجه ووضع Redefine الموجَّه بالمطالبة

Topaz Labs · صورة

ستظهر نتيجتك الأولى هنا

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

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

0 / 1024

نص إرشادي لرفع الدقة التوليدي، بحد أقصى 1024 حرفًا، ويدعمه Redefine فقط.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL لصورة المصدر لرفع الدقة.

الافتراضي Wonder 3

اختيار نموذج رفع الدقة التوليدي: يعيد Recovery وRecovery V2 بناء الصور شديدة الانخفاض في الدقة؛ ويستخدم Redefine الموجّهات لتوجيه التفاصيل الإبداعية؛ ويفضّل Standard MAX الدقة والجودة العالية؛ ويعيد Recover 3 بناء التفاصيل الطبيعية. ضمن عائلة Wonder، يأتي Wonder وWonder 2 قبل Wonder 3، وهو نموذج الواقعية التوليدية الأكثر تقدمًا؛ أما الإصدار الأحدث Wonder 3.5 فيوفر تفاصيل أدق مع تكرار أنماط أقل.

الافتراضي 2

مضاعف تكبير الصورة؛ فمثلًا تضاعف 2.0 كلا البعدين.

متقدم output_format · subject_detection · enhancement_strength · face_enhancement_creativity · face_enhancement_strength · creativity · texture · sharpen · denoise · detail · crop_to_fill · face_enhancement · autoprompt · enable_safety_checker
output_format الافتراضي jpeg

التنسيق المستخدم للصورة المرفوعة الدقة.

subject_detection الافتراضي All

يتحكم في كيفية اكتشاف العناصر عند تحسين الصور باستخدام Recovery V2 أو Wonder 3 أو Recovery.

enhancement_strength

قوة تحسين رفع الدقة التوليدي، وتُهيَّأ تلقائيًا عند تركها غير محددة؛ وتدعمها النماذج Wonder 3.5 وWonder 3.

الافتراضي 0

يتحكم في إبداع تحسين الوجه، ويكون فعالًا فقط عند تمكين تحسين الوجه: عيّن 1.0 لأقصى إبداع أو 0.0 لعدم الإبداع.

الافتراضي 0.8

يتحكم في قوة تحسين الوجه، ويكون فعالًا فقط عند تمكين تحسين الوجه: عيّن 1.0 لأقصى تحسين أو 0.0 لعدم التحسين.

إبداع رفع الدقة التوليدي من 1 إلى 6، ويدعمه Redefine فقط. تؤدي زيادته إلى إضافة تفاصيل أكثر تخيلًا أو هلوسة.

يتحكم في تفاصيل الخامة، وهو حصري لرفع الدقة التوليدي في Redefine، ويقبل مستويات من 1 إلى 5.

شدة زيادة الحدة من 0.0 إلى 1.0، ويدعمها Redefine فقط.

شدة إزالة التشويش من 0.0 إلى 1.0، ويدعمها Redefine فقط.

شدة استعادة التفاصيل من 0.0 إلى 1.0، وتدعمها Recovery V2 فقط.

POST /run/topaz/upscale/image/generative?wait=20 عرض السعر → ⁨‏0.08 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Topaz Upscale Image Generative

ترفع دقة الصورة من 1x إلى 4x مع اختيار `model`، بما في ذلك Wonder 3.5 وWonder 3 وRecover 3 وRedefine وRecovery V2. لتحسين الوجه منزلقان مستقلان للشدة والإبداع. يضيف Redefine مطالبة `prompt` تصل إلى 1024 حرفًا، بالإضافة إلى `creativity` و`texture` و`sharpen` و`denoise`. مناسب للمصادر الصغيرة أو الضبابية.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة المصدر لرفع الدقة.
modelاختياري
النوعenum
الافتراضيWonder 3
Wonder 3.5Wonder 3Wonder 2WonderRecover 3Standard MAXRedefineRecovery V2Recovery
اختيار نموذج رفع الدقة التوليدي: يعيد Recovery وRecovery V2 بناء الصور شديدة الانخفاض في الدقة؛ ويستخدم Redefine الموجّهات لتوجيه التفاصيل الإبداعية؛ ويفضّل Standard MAX الدقة والجودة العالية؛ ويعيد Recover 3 بناء التفاصيل الطبيعية. ضمن عائلة Wonder، يأتي Wonder وWonder 2 قبل Wonder 3، وهو نموذج الواقعية التوليدية الأكثر تقدمًا؛ أما الإصدار الأحدث Wonder 3.5 فيوفر تفاصيل أدق مع تكرار أنماط أقل.
upscale_factorاختياري
النوعnumber
الافتراضي2
1 – 4
مضاعف تكبير الصورة؛ فمثلًا تضاعف 2.0 كلا البعدين.
crop_to_fillاختياري
النوعboolean
الافتراضيfalse
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
التنسيق المستخدم للصورة المرفوعة الدقة.
subject_detectionاختياري
النوعenum
الافتراضيAll
AllForegroundBackground
يتحكم في كيفية اكتشاف العناصر عند تحسين الصور باستخدام Recovery V2 أو Wonder 3 أو Recovery.
face_enhancementاختياري
النوعboolean
الافتراضيtrue
مفتاح تحسين الوجه للصورة.
face_enhancement_creativityاختياري
النوعnumber
الافتراضي0
0 – 1
يتحكم في إبداع تحسين الوجه، ويكون فعالًا فقط عند تمكين تحسين الوجه: عيّن 1.0 لأقصى إبداع أو 0.0 لعدم الإبداع.
face_enhancement_strengthاختياري
النوعnumber
الافتراضي0.8
0 – 1
يتحكم في قوة تحسين الوجه، ويكون فعالًا فقط عند تمكين تحسين الوجه: عيّن 1.0 لأقصى تحسين أو 0.0 لعدم التحسين.
enhancement_strengthاختياري
النوعenum
lowmediumhigh
قوة تحسين رفع الدقة التوليدي، وتُهيَّأ تلقائيًا عند تركها غير محددة؛ وتدعمها النماذج Wonder 3.5 وWonder 3.
creativityاختياري
النوعinteger | null
1 – 6
إبداع رفع الدقة التوليدي من 1 إلى 6، ويدعمه Redefine فقط. تؤدي زيادته إلى إضافة تفاصيل أكثر تخيلًا أو هلوسة.
textureاختياري
النوعinteger | null
1 – 5
يتحكم في تفاصيل الخامة، وهو حصري لرفع الدقة التوليدي في Redefine، ويقبل مستويات من 1 إلى 5.
promptاختياري
النوعstring | null
≤ 1,024 حرفًا
نص إرشادي لرفع الدقة التوليدي، بحد أقصى 1024 حرفًا، ويدعمه Redefine فقط.
autopromptاختياري
النوعboolean | null
مفتاح توليد الموجّه تلقائيًا، وهو متاح حصريًا ضمن رفع الدقة التوليدي في Redefine.
sharpenاختياري
النوعnumber | null
0 – 1
شدة زيادة الحدة من 0.0 إلى 1.0، ويدعمها Redefine فقط.
denoiseاختياري
النوعnumber | null
0 – 1
شدة إزالة التشويش من 0.0 إلى 1.0، ويدعمها Redefine فقط.
detailاختياري
النوعnumber | null
0 – 1
شدة استعادة التفاصيل من 0.0 إلى 1.0، وتدعمها Recovery V2 فقط.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "topaz/upscale/image/generative",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size}الصورة الناتجة عن التكبير.

مزيد من النماذج: تحسين الدقة

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/topaz/upscale/image/generative.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt