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

Smart Resize

التكامل

معرّف النموذج smart-resize
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/smart-resize?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",
    "target_sizes": [
      "1024x1024",
      "1920x1080",
      "768x1344"
    ]
  }'

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

ملفات مثل المثال: ⁨‏0.50 $⁩ 500 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Utility تحرير الصور إخراج بدقة 4Kحتى 4K #realism#typography#visual#ads

يعيد تركيب صورة بما يصل إلى 10 أبعاد مستهدفة، وهو مفيد لنسخ الإعلانات والقص

Utility · صورة

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

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

إنشاء طلب

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

0 / 5000

إرشادات إضافية لتغيير الحجم: تطلب القيمة الفارغة من النموذج الحفاظ على محتوى المصدر بأكبر قدر ممكن من الدقة. ترافق أي تعليمات مقدمة موجّه تغيير الحجم المُنشأ تلقائيًا والمرسل إلى nano-banana-pro.

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

عنوان URL للصورة المصدر لتغيير حجمها.

resolution الافتراضي 1K

تلميح داخلي لفئة الدقة يحدد حدًا أدنى، وليس الأبعاد النهائية المحددة بواسطة `target_sizes`. إذا تعذر على تلك الفئة استيعاب حجم مطلوب، فقد يختار تغيير الحجم الذكي فئة أعلى تلقائيًا.

الافتراضي 1

عدد المتغيرات لكل حجم لـ nano-banana-pro، ويحدد إجمالي عدد الصور المُرجعة بالصيغة `len(target_sizes) * num_images_per_size`.

•مطلوب

أبعاد المخرج المطلوبة كقائمة من السلاسل `<width>x<height>`، مثل `"1920x1080"`. يغطي كل هدف إعداد مسبق لـ nano-banana-pro يكون صغيرًا قدر الإمكان مع الاستمرار في تغطية الأبعاد المطلوبة، ما يوفر تطابقًا دقيقًا للبكسلات دون رفع الدقة. يساوي عدد الصور لكل حجم واحدًا مضروبًا في `num_images_per_size`.

متقدم output_format · safety_tolerance · seed
output_format الافتراضي png

صيغة الصور المُولَّدة.

safety_tolerance الافتراضي 4

درجة تحمّل الأمان: تؤدي زيادة هذا الرقم إلى جعل التصفية أقل صرامة لاستدعاءات /edit الداخلية لـ nano-banana-pro.

بذرة اختيارية لإعادة الإنتاج ومشتركة بين جميع الأحجام المستهدفة. عند توفيرها، تُمرَّر إلى استدعاءات /edit الداخلية لـ nano-banana-pro.

POST /run/smart-resize?wait=20 عرض السعر → ⁨‏0.50 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/smart-resize?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",
    "target_sizes": [
      "1024x1024",
      "1920x1080",
      "768x1344"
    ]
  }'

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

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

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

حول Smart Resize

يغير حجم الصورة المصدر إلى أحجام عشوائية عبر إعادة إنشاء التكوين بدل الاقتصاص فحسب. قدّم `target_sizes` كسلاسل من 1 إلى 10 مثل "1920x1080"، مع من 1 إلى 4 تنويعات لكل حجم عبر `num_images_per_size`. تضيف `prompt` اختيارية تصل إلى 5000 حرف تعليمات. تكون `resolution` هي 1K أو 2K أو 4K، والإخراج png أو jpeg أو webp.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة المصدر لتغيير حجمها.
target_sizesمطلوب
النوعstring[]
≤ 10 عناصر
أبعاد المخرج المطلوبة كقائمة من السلاسل `<width>x<height>`، مثل `"1920x1080"`. يغطي كل هدف إعداد مسبق لـ nano-banana-pro يكون صغيرًا قدر الإمكان مع الاستمرار في تغطية الأبعاد المطلوبة، ما يوفر تطابقًا دقيقًا للبكسلات دون رفع الدقة. يساوي عدد الصور لكل حجم واحدًا مضروبًا في `num_images_per_size`.
promptاختياري
النوعstring
الافتراضي
≤ 5,000 حرف
إرشادات إضافية لتغيير الحجم: تطلب القيمة الفارغة من النموذج الحفاظ على محتوى المصدر بأكبر قدر ممكن من الدقة. ترافق أي تعليمات مقدمة موجّه تغيير الحجم المُنشأ تلقائيًا والمرسل إلى nano-banana-pro.
num_images_per_sizeاختياري
النوعinteger
الافتراضي1
1 – 4
عدد المتغيرات لكل حجم لـ nano-banana-pro، ويحدد إجمالي عدد الصور المُرجعة بالصيغة `len(target_sizes) * num_images_per_size`.
resolutionاختياري
النوعenum
الافتراضي1K
1K2K4K
تلميح داخلي لفئة الدقة يحدد حدًا أدنى، وليس الأبعاد النهائية المحددة بواسطة `target_sizes`. إذا تعذر على تلك الفئة استيعاب حجم مطلوب، فقد يختار تغيير الحجم الذكي فئة أعلى تلقائيًا.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpngwebp
صيغة الصور المُولَّدة.
safety_toleranceاختياري
النوعenum
الافتراضي4
123456
درجة تحمّل الأمان: تؤدي زيادة هذا الرقم إلى جعل التصفية أقل صرامة لاستدعاءات /edit الداخلية لـ nano-banana-pro.
seedاختياري
النوعinteger | null
بذرة اختيارية لإعادة الإنتاج ومشتركة بين جميع الأحجام المستهدفة. عند توفيرها، تُمرَّر إلى استدعاءات /edit الداخلية لـ nano-banana-pro.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "smart-resize",
  "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": 500,
    "usd": "0.50",
    "charged": 500,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "target_sizes": [
      "1024x1024",
      "1920x1080",
      "768x1344"
    ]
  },
  "output": {
    "images": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ],
    "description": "string",
    "results": [
      {
        "images": [
          {}
        ],
        "description": "string",
        "width": 1024,
        "height": 768,
        "aspect_ratio": "string",
        "resolution": "string"
      }
    ]
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, content_type, file_name, file_size, width, height}قائمة صور مدمجة تتضمن إدخالات `num_images_per_size` لـ `target_sizes[0]` أولًا، ثم مجموعات مكافئة لـ `target_sizes` اللاحقة. وتتضمن كل صورة مولَّدة بالترتيب نفسه الموجود في `results`.
description
stringوصف مصاحب للصور المولّدة.
results
array of object {images, description, width, height, aspect_ratio, resolution}العرض والارتفاع المطلوبان لكل هدف، مقترنان بالإعداد المسبق لـ nano-banana-pro المستخدم أثناء المعالجة، والمحدد بواسطة aspect_ratio وresolution.

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