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

Z-Image Turbo Seamless Tiling

التكامل

معرّف النموذج z-image/turbo/tiling
# 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/z-image/turbo/tiling?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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.02 $⁩ 20 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Alibaba من نص إلى صورة سريع #z-image#turbo#seamless#tiling

نموذج سريع لتحويل النص إلى صورة ينتج مخرجات قابلة للتبليط، مع تبليط أفقي أو رأسي أو بالاتجاهين وطلاء داخلي

Alibaba · صورة

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

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

إنشاء طلب

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

•مطلوب

الموجّه الذي يوجّه توليد الصورة.

image_size الافتراضي square_hd

أبعاد الصورة المُولَّدة، حيث يختار 'auto' القيمة 1024x1024 ما لم تُوفَّر صورة مدخل، وعندها تُستخدم أبعادها.

num_images الافتراضي 1

عدد الصور المطلوب توليده.

متقدم image · mask_image_url · output_format · acceleration · tiling_mode · num_inference_steps · strength · tile_size · tile_stride · seed · enable_safety_checker · enable_prompt_expansion
image_url
أفلت ملفًا، أو

عنوان URL للصورة يُستخدم إما لتوليد صورة من صورة أو للرسم داخل الصورة. يؤدي توفير mask_image_url إلى اختيار الرسم داخل الصورة؛ بينما يؤدي حذفه إلى اختيار توليد صورة من صورة.

أفلت ملفًا، أو

عنوان URL لقناع الرسم الداخلي المقدّم بجانب image_url المطلوب. يحافظ القناع على المناطق السوداء دون تغيير ويعيد توليد المناطق البيضاء.

output_format الافتراضي png

تنسيق ملف الصورة الناتجة.

acceleration الافتراضي regular

مستوى التسريع المطبّق على المعالجة.

tiling_mode الافتراضي both

اتجاه التجزئة إلى بلاطات: يغطي 'both' جميع الاتجاهات، ويغطي 'horizontal' الاتجاه من اليسار إلى اليمين فقط، بينما يغطي 'vertical' الاتجاه من الأعلى إلى الأسفل فقط.

الافتراضي 8

عدد خطوات الاستدلال المطلوب تنفيذها.

الافتراضي 0.6

قوة التحويل المطبقة فقط على صورة مقدّمة عبر image_url؛ ولا تُستخدم خلاف ذلك.

الافتراضي 128

حجم البلاطة في الفضاء الكامن، حيث تقابل 64 قيمة 512px، وتقابل 128 قيمة 1024px، وتقابل 256 قيمة 2048px. تحدّ أبعاد الصورة المُولَّدة تلقائيًا الحجم على طول المحاور المُجزأة؛ وتتطلب عملية تقسيم الرقع قيمة زوجية قابلة للقسمة على 2.

الافتراضي 64

خطوة البلاطة في الفضاء الكامن، مع مكافئات بكسلية تبلغ 32 = 256px و64 = 512px و128 = 1024px. القيم المضاعفة لـ 2 فقط صالحة؛ وأي قيمة تتجاوز نصف حجم البلاطة الفعلي تُخفَّض تلقائيًا إلى ذلك الحد.

بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.

POST /run/z-image/turbo/tiling?wait=20 عرض السعر → ⁨‏0.02 $⁩
# 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/z-image/turbo/tiling?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

حول Z-Image Turbo Seamless Tiling

ينشئ صورًا تتكرر عبر الحواف، مع التحكم عبر `tiling_mode` (both أو horizontal أو vertical) و`tile_size` و`tile_stride`. يعمل بما يصل إلى 8 خطوات استدلال ويُرجع من 1 إلى 4 صور بصيغ png أو jpeg أو webp. يتيح توفير `image_url` التحويل من صورة إلى صورة، كما يتيح إضافة `mask_image_url` الطلاء الداخلي. تحدد `strength` مقدار تغيير الإدخال.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
الموجّه الذي يوجّه توليد الصورة.
image_sizeاختياري
النوعobject
الافتراضيsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
أبعاد الصورة المُولَّدة، حيث يختار 'auto' القيمة 1024x1024 ما لم تُوفَّر صورة مدخل، وعندها تُستخدم أبعادها.
num_inference_stepsاختياري
النوعinteger
الافتراضي8
1 – 8
عدد خطوات الاستدلال المطلوب تنفيذها.
seedاختياري
النوعinteger | null
بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليده.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
فحص السلامة، الذي يعيد صورًا سوداء بدلًا من أي صور مصنفة على أنها غير آمنة. تُمكّن القيمة true الفحص؛ وتعطله false للحسابات المخولة فقط، بينما تُفحص الطلبات من دون تخويل على أي حال.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpngwebp
تنسيق ملف الصورة الناتجة.
accelerationاختياري
النوعenum
الافتراضيregular
noneregularhigh
مستوى التسريع المطبّق على المعالجة.
enable_prompt_expansionاختياري
النوعboolean
الافتراضيfalse
يتحكم في تفعيل توسيع الموجّه.
image_urlاختياري image
النوعurl · image
عنوان URL للصورة يُستخدم إما لتوليد صورة من صورة أو للرسم داخل الصورة. يؤدي توفير mask_image_url إلى اختيار الرسم داخل الصورة؛ بينما يؤدي حذفه إلى اختيار توليد صورة من صورة.
mask_image_urlاختياري
النوعurl · image
عنوان URL لقناع الرسم الداخلي المقدّم بجانب image_url المطلوب. يحافظ القناع على المناطق السوداء دون تغيير ويعيد توليد المناطق البيضاء.
strengthاختياري
النوعnumber
الافتراضي0.6
≤ 1> 0
قوة التحويل المطبقة فقط على صورة مقدّمة عبر image_url؛ ولا تُستخدم خلاف ذلك.
tile_sizeاختياري
النوعinteger
الافتراضي128
32 – 256
حجم البلاطة في الفضاء الكامن، حيث تقابل 64 قيمة 512px، وتقابل 128 قيمة 1024px، وتقابل 256 قيمة 2048px. تحدّ أبعاد الصورة المُولَّدة تلقائيًا الحجم على طول المحاور المُجزأة؛ وتتطلب عملية تقسيم الرقع قيمة زوجية قابلة للقسمة على 2.
tile_strideاختياري
النوعinteger
الافتراضي64
16 – 128
خطوة البلاطة في الفضاء الكامن، مع مكافئات بكسلية تبلغ 32 = 256px و64 = 512px و128 = 1024px. القيم المضاعفة لـ 2 فقط صالحة؛ وأي قيمة تتجاوز نصف حجم البلاطة الفعلي تُخفَّض تلقائيًا إلى ذلك الحد.
tiling_modeاختياري
النوعenum
الافتراضيboth
bothhorizontalvertical
اتجاه التجزئة إلى بلاطات: يغطي 'both' جميع الاتجاهات، ويغطي 'horizontal' الاتجاه من اليسار إلى اليمين فقط، بينما يغطي 'vertical' الاتجاه من الأعلى إلى الأسفل فقط.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "z-image/turbo/tiling",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "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}معلومات الملفات الخاصة بالصور المولّدة.
timings
objectمعلومات توقيت عملية التوليد.
seed
integerبذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.
has_nsfw_concepts
array of booleanيشير إلى ما إذا كانت مفاهيم NSFW تظهر في الصور المُولّدة.
prompt
stringالموجّه المستخدم أثناء توليد الصورة.

مزيد من النماذج: من نص إلى صورة

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