Op den Inhalt sprangen

PATINA · Material · Extract

Integréieren

Modell-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"

Dateie wéi am Beispill: 0,17 $ 170 API-Kreditter Är Dateie gi virun der Ausféierung gemooss Op dëser Säit ausféieren

API-Schlëssel kréien
Open model Bildbearbechtung #material#pbr#extraction

Extrahéiert aus engem Quellbild eng tilebar Textur mat PBR-Kaarten, gesteiert vun engem Prompt, deen d'Uewerfläch nennt

Open model · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch

Beschreiwung vun der gewënschter Textur, déi aus dem Bild extrahéiert soll ginn.

•obligatoresch image_url
Fichier erofzéien, oder

Quellbild-URL fir d'Texturextraktioun.

image_size Standard square_hd

Pixelmoossname vun der resultéierender Textur.

upscale_factor Standard 0

SeedVR-Faktor fir nahtlos Vergréisserung, deen déi prognostizéiert PBR-Maps beaflosst, d'Basistextur awer an hirer ursprénglecher Opléisung léisst. Wielt 2 fir duebel Opléisung, 4 fir véierfach Opléisung oder 0, fir d'Vergréisserung ze deaktivéieren.

num_images Standard 1

Zuel vun den Texturbiller, déi erstallt solle ginn.

Erweidert tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
tiling_mode Standard both

Richtung vum Tiling: 'both' fir omnidirektionalt Tiling, 'horizontal' oder 'vertical'.

output_format Standard png

Bilddateiformat fir Output-Texturen a PBR-Maps.

Standard 8

Zuel vun den Denoising-Schrëtt fir d'Texturgeneratioun.

Standard 128

Tile-Gréisst am latente Raum, wou 64 512px an 128 1024px duerstellt. Op all getilte Achs setzt d'Dimensioun vum generéierte Bild eng automatesch iewescht Limitt.

Standard 64

Setzt de Schrëtt tëscht den Tiles am latente Raum; eng automatesch Limitt verhënnert, datt en d'Hallschent vun der effektiver Tile-Gréisst iwwerschreit.

Standard 0.6

Transformatiounsstäerkt, déi nëmmen op e Bild iwwer image_url applizéiert gëtt; soss gëtt se net benotzt.

Zoufällege Seed, deen d'Generatioun reproduzéierbar mécht.

Standard ["basecolor","normal"...

PBR-Maps, déi fir d'Prognos ausgewielt goufen, mat all fënnef standardméisseg ausgewielt. Wann näischt ausgewielt gëtt, gëtt d'PBR-Schätzung komplett iwwersprongen.

POST /run/patina/material/extract?wait=20 Präis → 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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer PATINA · Material · Extract

Hëlt en Inputbild plus e Prompt, deen d'Uewerfläch fir d'Extraktioun beschreift, a gëtt eng tilebar Textur mat virausgesote PBR-Kaarten zeréck. `maps` wielt, wéi eng vun basecolor, normal, roughness, metalness an height produzéiert ginn. Optiounen enthalen `tiling_mode`, `strength` vun 0 bis 1, `upscale_factor` vun 0, 2 oder 4 an 1 bis 4 Ausgaben.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
promptobligatoresch
Typstring
Beschreiwung vun der gewënschter Textur, déi aus dem Bild extrahéiert soll ginn.
image_sizeoptional
Typobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Pixelmoossname vun der resultéierender Textur.
num_inference_stepsoptional
Typinteger
Standard8
1 – 8
Zuel vun den Denoising-Schrëtt fir d'Texturgeneratioun.
seedoptional
Typinteger | null
Zoufällege Seed, deen d'Generatioun reproduzéierbar mécht.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 4
Zuel vun den Texturbiller, déi erstallt solle ginn.
enable_prompt_expansionoptional
Typboolean
Standardtrue
Aktivéiert d'LLM-baséiert Prompt-Erweiderung fir Detailer bäizefügen.
enable_safety_checkeroptional
Typboolean
Standardtrue
Aktivéiert d'Sécherheetskontroll vun de generéierte Biller.
tiling_modeoptional
Typenum
Standardboth
bothhorizontalvertical
Richtung vum Tiling: 'both' fir omnidirektionalt Tiling, 'horizontal' oder 'vertical'.
tile_sizeoptional
Typinteger
Standard128
32 – 256
Tile-Gréisst am latente Raum, wou 64 512px an 128 1024px duerstellt. Op all getilte Achs setzt d'Dimensioun vum generéierte Bild eng automatesch iewescht Limitt.
tile_strideoptional
Typinteger
Standard64
16 – 128
Setzt de Schrëtt tëscht den Tiles am latente Raum; eng automatesch Limitt verhënnert, datt en d'Hallschent vun der effektiver Tile-Gréisst iwwerschreit.
image_urlobligatoresch image
Typurl · image
Quellbild-URL fir d'Texturextraktioun.
strengthoptional
Typnumber
Standard0.6
≤ 1> 0
Transformatiounsstäerkt, déi nëmmen op e Bild iwwer image_url applizéiert gëtt; soss gëtt se net benotzt.
mapsoptional
Typenum[]
Standard["basecolor","normal","roughness","metalness","height"]
PBR-Maps, déi fir d'Prognos ausgewielt goufen, mat all fënnef standardméisseg ausgewielt. Wann näischt ausgewielt gëtt, gëtt d'PBR-Schätzung komplett iwwersprongen.
upscale_factoroptional
Typenum
Standard0
024
SeedVR-Faktor fir nahtlos Vergréisserung, deen déi prognostizéiert PBR-Maps beaflosst, d'Basistextur awer an hirer ursprénglecher Opléisung léisst. Wielt 2 fir duebel Opléisung, 4 fir véierfach Opléisung oder 0, fir d'Vergréisserung ze deaktivéieren.
output_formatoptional
Typenum
Standardpng
jpegpngwebp
Bilddateiformat fir Output-Texturen a PBR-Maps.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
images
array of anyOutput-Biller enthalen PBR-Material-Maps, déi vu PATINA prognostizéiert goufen, nieft tilbaren Texturen, déi mat z-image generéiert goufen.
seed
integerSeed, dee bei der Texturgeneratioun applizéiert gëtt.
prompt
stringPrompt fir d'Texturgeneratioun, inklusiv all applizéiert Erweiderung.
timings
objectTiming-Opschlësselung fir de ganze Prozess, a Sekonnen.

Méi Modeller: Bildbearbechtung

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/patina/material/extract.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt