דילוג לתוכן

PATINA · Material

שילוב

מזהה מודל patina/material
# 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/patina/material?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.08 ‏$⁩ 80 קרדיטי API הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

קבלת מפתח API
Open model טקסט לתמונה #material#pbr#displacement#metalness

מחולל טקסט-לטקסטורה שמפיק תמונות הניתנות לריצוף בתוספת מפות PBR, עם img2img ואינפיינטינג אופציונליים

Open model · תמונה

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה

תיאור טקסטואלי של החומר או המרקם ליצירה.

image_size ברירת מחדל square_hd

ממדי הפיקסלים של המרקם שנוצר.

upscale_factor ברירת מחדל 0

מכפיל הגדלה רציפה של SeedVR המשפיע על מפות PBR החזויות אך משאיר את מרקם הבסיס ברזולוציה המקורית. בחר 2 לרזולוציה כפולה, 4 לרזולוציה מרובעת או 0 להשבתת ההגדלה.

num_images ברירת מחדל 1

מספר תמונות המרקם ליצירה.

מתקדם image · mask · tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
image_url
גרור קובץ, או

כתובת URL של תמונת המקור, המשמשת לצביעה פנימית אם mask_url נלווית אליה, ולעיבוד תמונה-לתמונה אחרת.

mask_url
גרור קובץ, או

כתובת URL של מסכת הצביעה הפנימית שסופקה לצד image_url הנדרשת. המסכה משמרת אזורים שחורים ללא שינוי ויוצרת מחדש אזורים לבנים.

tiling_mode ברירת מחדל both

כיוון הריצוף: 'both' לריצוף לכל הכיוונים, 'horizontal' או 'vertical'.

output_format ברירת מחדל png

פורמט קובץ התמונה עבור מרקמי הפלט ומפות PBR.

ברירת מחדל 8

מספר שלבי הסרת הרעש ששימשו ליצירת מרקמים.

ברירת מחדל 128

גודל אריח במרחב הלטנטי, כאשר 64 מייצג 512px ו-128 מייצג 1024px. בכל ציר מרוצף, ממד התמונה שנוצרה קובע גבול עליון אוטומטי.

ברירת מחדל 64

הגדר את המרווח בין אריחים במרחב הלטנטי; הגבלה אוטומטית מונעת ממנו לחרוג ממחצית גודל האריח האפקטיבי.

ברירת מחדל 0.6

עוצמת הטרנספורמציה המוחלת רק על תמונה שסופקה דרך image_url; אחרת אינה בשימוש.

seed אקראי שהופך את היצירה לניתנת לשחזור.

ברירת מחדל ["basecolor","normal"...

מפות PBR שנבחרו לחיזוי, כאשר כל חמש המפות נבחרות כברירת מחדל. בחירה באף מפה מדלגת לחלוטין על הערכת PBR.

POST /run/patina/material?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.com/v1/run/patina/material?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

מידע על PATINA · Material

יוצר טקסטורות הניתנות לריצוף מהנחיה וחוזה מפות PBR: basecolor, normal, roughness, metalness ו-height. השתמשו ב-`tiling_mode` עבור ריצוף בשני הכיוונים, אופקי או אנכי, וב-`upscale_factor` של 0, 2 או 4 להגדלת המפות. העברת `image_url` מאפשרת תמונה-לתמונה, והוספת `mask_url` מאפשרת אינפיינטינג. עד 4 תמונות בבקשה.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
תיאור טקסטואלי של החומר או המרקם ליצירה.
image_sizeאופציונלי
סוגobject
ברירת מחדלsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ממדי הפיקסלים של המרקם שנוצר.
num_inference_stepsאופציונלי
סוגinteger
ברירת מחדל8
1 – 8
מספר שלבי הסרת הרעש ששימשו ליצירת מרקמים.
seedאופציונלי
סוגinteger | null
seed אקראי שהופך את היצירה לניתנת לשחזור.
num_imagesאופציונלי num_outputs
סוגinteger
ברירת מחדל1
1 – 4
מספר תמונות המרקם ליצירה.
enable_prompt_expansionאופציונלי
סוגboolean
ברירת מחדלtrue
מפעיל הרחבת הנחיות המבוססת על LLM להוספת פרטים.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
מפעיל בדיקת בטיחות של תמונות שנוצרו.
tiling_modeאופציונלי
סוגenum
ברירת מחדלboth
bothhorizontalvertical
כיוון הריצוף: 'both' לריצוף לכל הכיוונים, 'horizontal' או 'vertical'.
tile_sizeאופציונלי
סוגinteger
ברירת מחדל128
32 – 256
גודל אריח במרחב הלטנטי, כאשר 64 מייצג 512px ו-128 מייצג 1024px. בכל ציר מרוצף, ממד התמונה שנוצרה קובע גבול עליון אוטומטי.
tile_strideאופציונלי
סוגinteger
ברירת מחדל64
16 – 128
הגדר את המרווח בין אריחים במרחב הלטנטי; הגבלה אוטומטית מונעת ממנו לחרוג ממחצית גודל האריח האפקטיבי.
image_urlאופציונלי image
סוגurl · image
כתובת URL של תמונת המקור, המשמשת לצביעה פנימית אם mask_url נלווית אליה, ולעיבוד תמונה-לתמונה אחרת.
mask_urlאופציונלי mask
סוגurl · image
כתובת URL של מסכת הצביעה הפנימית שסופקה לצד image_url הנדרשת. המסכה משמרת אזורים שחורים ללא שינוי ויוצרת מחדש אזורים לבנים.
strengthאופציונלי
סוגnumber
ברירת מחדל0.6
≤ 1> 0
עוצמת הטרנספורמציה המוחלת רק על תמונה שסופקה דרך image_url; אחרת אינה בשימוש.
mapsאופציונלי
סוגenum[]
ברירת מחדל["basecolor","normal","roughness","metalness","height"]
מפות PBR שנבחרו לחיזוי, כאשר כל חמש המפות נבחרות כברירת מחדל. בחירה באף מפה מדלגת לחלוטין על הערכת PBR.
upscale_factorאופציונלי
סוגenum
ברירת מחדל0
024
מכפיל הגדלה רציפה של SeedVR המשפיע על מפות PBR החזויות אך משאיר את מרקם הבסיס ברזולוציה המקורית. בחר 2 לרזולוציה כפולה, 4 לרזולוציה מרובעת או 0 להשבתת ההגדלה.
output_formatאופציונלי
סוגenum
ברירת מחדלpng
jpegpngwebp
פורמט קובץ התמונה עבור מרקמי הפלט ומפות PBR.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "patina/material",
  "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": {
    "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
      }
    ],
    "seed": 42,
    "prompt": "string",
    "timings": {}
  },
  "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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
images
array of anyתמונות הפלט כוללות מפות חומר PBR שחוזו על ידי PATINA לצד מרקמים הניתנים לריצוף שנוצרו על ידי z-image.
seed
integerSeed שהוחל בעת יצירת מרקמים.
prompt
stringהנחיית יצירת המרקם, כולל כל הרחבה שהוחלה.
timings
objectפירוט תזמון המכסה את התהליך המלא, בשניות.

מודלים נוספים: טקסט לתמונה

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/patina/material.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt