שפּרינגען צו אינהאַלט

PATINA · Material · Extract

אינטעגרירן

מאָדעל־id 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

טײַל־גרייס אין latent-space, וווּ 64 רעפּרעזענטירט 512px און 128 רעפּרעזענטירט 1024px. אויף יעדן געטײַלטן אַקס שטעלט די דימענסיע פֿונעם גענערירטן בילד אַן אויטאָמאַטישן אויבערשטן גרענעץ.

סטאַנדאַרט 64

שטעלט דעם סטרייד צווישן latent-space טײַלן; אַן אויטאָמאַטישער שיעור פֿאַרמיידט אַז ער זאָל איבערשטײַגן האַלב פֿון דער עפעקטיווער טײַל־גרייס.

סטאַנדאַרט 0.6

טראַנספֿאָרמאַציע־שטאַרקייט געווענדט בלויז צו אַ בילד צוגעשטעלט דורך image_url; אַנדערש נישט גענוצט.

צופֿעליקער סיד וואָס מאכט די גענערירונג רעפּראָדוצירבאַר.

סטאַנדאַרט ["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"

לויפֿן דעם ריקוועסט

אײַער 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
צופֿעליקער סיד וואָס מאכט די גענערירונג רעפּראָדוצירבאַר.
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
טײַל־גרייס אין latent-space, וווּ 64 רעפּרעזענטירט 512px און 128 רעפּרעזענטירט 1024px. אויף יעדן געטײַלטן אַקס שטעלט די דימענסיע פֿונעם גענערירטן בילד אַן אויטאָמאַטישן אויבערשטן גרענעץ.
tile_strideאָפּציאָנעל
טיפּinteger
סטאַנדאַרט64
16 – 128
שטעלט דעם סטרייד צווישן latent-space טײַלן; אַן אויטאָמאַטישער שיעור פֿאַרמיידט אַז ער זאָל איבערשטײַגן האַלב פֿון דער עפעקטיווער טײַל־גרייס.
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 מאַפּס.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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
integerסיד געווענדט בײַם גענערירן טעקסטורן.
prompt
stringטעקסטור־גענערירונג־פּראָמפּט, אַרײַנגערעכנט יעדע געווענדטע יקספּאַנשאַן.
timings
objectצײַט־איבערבליק פֿאַרן גאַנצן פּראָצעס, אין סעקונדעס.

מער מאָדעלן: בילד־עדיטירונג

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/patina/material/extract.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt