Naar inhoud springen

PATINA · Material · Extract

Integreren

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

Bestanden zoals het voorbeeld: $ 0,17 170 API-tegoed je bestanden worden vóór de uitvoering gemeten Op deze pagina uitvoeren

API-sleutel ophalen
Open model Afbeelding bewerken #material#pbr#extraction

Haalt een tegelbare textuur met PBR-kaarten uit een bronafbeelding, gestuurd door een prompt die het oppervlak benoemt

Open model · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht

Beschrijving van de gewenste textuur die uit de afbeelding moet worden geëxtraheerd.

•verplicht image_url
Sleep een bestand hierheen of

URL van de bronafbeelding voor texturextractie.

image_size standaard square_hd

Pixelafmetingen van de resulterende textuur.

upscale_factor standaard 0

Factor voor naadloze SeedVR-opschaling die voorspelde PBR-kaarten beïnvloedt, maar de basistextuur op de oorspronkelijke resolutie laat. Kies 2 voor dubbele resolutie, 4 voor viervoudige resolutie of 0 om opschaling uit te schakelen.

num_images standaard 1

Aantal te maken textuurafbeeldingen.

Geavanceerd tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
tiling_mode standaard both

Richting van het tegelen: 'both' voor tegelen in alle richtingen, 'horizontal' of 'vertical'.

output_format standaard png

Bestandsindeling voor uitvoertexturen en PBR-kaarten.

standaard 8

Aantal denoising-stappen dat wordt gebruikt om texturen te genereren.

standaard 128

Tegelgrootte in de latente ruimte, waarbij 64 staat voor 512px en 128 voor 1024px. Op elke getegelde as bepaalt de afmeting van de gegenereerde afbeelding automatisch een bovengrens.

standaard 64

Stel de stapgrootte tussen tegels in de latente ruimte in; een automatische limiet voorkomt dat deze meer dan de helft van de effectieve tegelgrootte bedraagt.

standaard 0.6

Transformatiesterkte die alleen wordt toegepast op een afbeelding die via image_url is aangeleverd; anders niet gebruikt.

Willekeurige seed die reproduceerbare generatie mogelijk maakt.

standaard ["basecolor","normal"...

PBR-kaarten die voor voorspelling zijn geselecteerd; standaard zijn alle vijf geselecteerd. Als geen enkele wordt geselecteerd, wordt PBR-schatting volledig overgeslagen.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over PATINA · Material · Extract

Neemt een invoerafbeelding plus een prompt die beschrijft welk oppervlak moet worden geëxtraheerd en retourneert een tegelbare textuur met voorspelde PBR-kaarten. `maps` selecteert welke van basecolor, normal, roughness, metalness en height worden geproduceerd. Opties omvatten `tiling_mode`, `strength` van 0 tot 1, `upscale_factor` van 0, 2 of 4 en 1 tot 4 uitvoerafbeeldingen.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
promptverplicht
Typestring
Beschrijving van de gewenste textuur die uit de afbeelding moet worden geëxtraheerd.
image_sizeoptioneel
Typeobject
Standaardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Pixelafmetingen van de resulterende textuur.
num_inference_stepsoptioneel
Typeinteger
Standaard8
1 – 8
Aantal denoising-stappen dat wordt gebruikt om texturen te genereren.
seedoptioneel
Typeinteger | null
Willekeurige seed die reproduceerbare generatie mogelijk maakt.
num_imagesoptioneel num_outputs
Typeinteger
Standaard1
1 – 4
Aantal te maken textuurafbeeldingen.
enable_prompt_expansionoptioneel
Typeboolean
Standaardtrue
Schakelt promptuitbreiding op basis van een LLM in om details toe te voegen.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Schakelt veiligheidscontrole van gegenereerde afbeeldingen in.
tiling_modeoptioneel
Typeenum
Standaardboth
bothhorizontalvertical
Richting van het tegelen: 'both' voor tegelen in alle richtingen, 'horizontal' of 'vertical'.
tile_sizeoptioneel
Typeinteger
Standaard128
32 – 256
Tegelgrootte in de latente ruimte, waarbij 64 staat voor 512px en 128 voor 1024px. Op elke getegelde as bepaalt de afmeting van de gegenereerde afbeelding automatisch een bovengrens.
tile_strideoptioneel
Typeinteger
Standaard64
16 – 128
Stel de stapgrootte tussen tegels in de latente ruimte in; een automatische limiet voorkomt dat deze meer dan de helft van de effectieve tegelgrootte bedraagt.
image_urlverplicht image
Typeurl · image
URL van de bronafbeelding voor texturextractie.
strengthoptioneel
Typenumber
Standaard0.6
≤ 1> 0
Transformatiesterkte die alleen wordt toegepast op een afbeelding die via image_url is aangeleverd; anders niet gebruikt.
mapsoptioneel
Typeenum[]
Standaard["basecolor","normal","roughness","metalness","height"]
PBR-kaarten die voor voorspelling zijn geselecteerd; standaard zijn alle vijf geselecteerd. Als geen enkele wordt geselecteerd, wordt PBR-schatting volledig overgeslagen.
upscale_factoroptioneel
Typeenum
Standaard0
024
Factor voor naadloze SeedVR-opschaling die voorspelde PBR-kaarten beïnvloedt, maar de basistextuur op de oorspronkelijke resolutie laat. Kies 2 voor dubbele resolutie, 4 voor viervoudige resolutie of 0 om opschaling uit te schakelen.
output_formatoptioneel
Typeenum
Standaardpng
jpegpngwebp
Bestandsindeling voor uitvoertexturen en PBR-kaarten.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
images
array of anyUitvoerafbeeldingen bevatten door PATINA voorspelde PBR-materiaalk aarten naast door z-image gegenereerde tegelbare texturen.
seed
integerSeed die wordt toegepast bij het genereren van texturen.
prompt
stringPrompt voor textuurgeneratie, inclusief eventuele toegepaste uitbreiding.
timings
objectTimingoverzicht van het volledige proces, in seconden.

Meer modellen: Afbeelding bewerken

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/patina/material/extract.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt