דילוג לתוכן

PATINA · Material · Extract

שילוב

מזהה מודל patina/material/extract
# 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/extract?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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

קבצים כמו בדוגמה: ⁨‏0.17 ‏$⁩ 170 קרדיטי API הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

קבלת מפתח API
Open model עריכת תמונה #material#pbr#extraction

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

Open model · תמונה

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

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

בנה בקשה

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

•חובה

תיאור המרקם הרצוי לחילוץ מהתמונה.

•חובה image_url
גרור קובץ, או

כתובת URL של תמונת המקור לחילוץ מרקם.

image_size ברירת מחדל square_hd

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

upscale_factor ברירת מחדל 0

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

num_images ברירת מחדל 1

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

מתקדם tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
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/extract?wait=20 הצעת מחיר → ⁨‏0.17 ‏$⁩
# 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/extract?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",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על PATINA · Material · Extract

מקבל תמונת קלט וכן הנחיה המתארת איזה משטח לחלץ, ומחזיר טקסטורה הניתנת לריצוף יחד עם מפות PBR חזויות. `maps` בוחר אילו מבין basecolor, normal, roughness, metalness ו-height להפיק. האפשרויות כוללות `tiling_mode`, `strength` מ-0 עד 1, `upscale_factor` בערכים 0, 2 או 4, ו-1 עד 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 של תמונת המקור לחילוץ מרקם.
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/extract",
  "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": 170,
    "usd": "0.17",
    "charged": 170,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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/extract.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt