Zum Inhalt springen

PATINA · Material · Extract

Integrieren

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"

Dateien wie das Beispiel: 0,17 $ 170 API-Credits Deine Dateien werden vor der Ausführung gemessen Auf dieser Seite ausführen

API-Schlüssel abrufen
Open model Bildbearbeitung #material#pbr#extraction

Extrahiert anhand eines die Oberfläche benennenden Prompts eine kachelbare Textur mit PBR-Karten aus einem Quellbild

Open model · Bild

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich

Beschreibung der gewünschten aus dem Bild zu extrahierenden Textur.

•erforderlich image_url
Datei ablegen oder

Quellbild-URL für die TexTurextraktion.

image_size Standard square_hd

Pixelabmessungen der resultierenden Textur.

upscale_factor Standard 0

Faktor für die nahtlose SeedVR-Hochskalierung, der vorhergesagte PBR-Maps beeinflusst, die Basistektur jedoch in ihrer ursprünglichen Auflösung belässt. Wählen Sie 2 für doppelte Auflösung, 4 für vierfache Auflösung oder 0 zum Deaktivieren der Hochskalierung.

num_images Standard 1

Anzahl der zu erstellenden Texturbilder.

Erweitert 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 der Kachelung: 'both' für omnidirektionale Kachelung, 'horizontal' oder 'vertical'.

output_format Standard png

Bilddateiformat für Ausgabe-Texturen und PBR-Maps.

Standard 8

Anzahl der Denoising-Schritte zur TexTurerzeugung.

Standard 128

Kachelgröße im latenten Raum, wobei 64 512px und 128 1024px entspricht. Auf jeder gekachelten Achse legt die Abmessung des generierten Bildes eine automatische Obergrenze fest.

Standard 64

Legt den Abstand zwischen Kacheln im latenten Raum fest; eine automatische Begrenzung verhindert, dass er die Hälfte der effektiven Kachelgröße überschreitet.

Standard 0.6

Transformationsstärke, die nur auf ein über image_url bereitgestelltes Bild angewendet wird; andernfalls ungenutzt.

Zufälliger Seed, der eine reproduzierbare Generierung ermöglicht.

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

Für die Vorhersage ausgewählte PBR-Maps, standardmäßig sind alle fünf ausgewählt. Wenn keine ausgewählt wird, wird die PBR-Schätzung vollständig übersprungen.

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über PATINA · Material · Extract

Nimmt ein Eingabebild und einen Prompt entgegen, der die zu extrahierende Oberfläche beschreibt, und gibt eine kachelbare Textur mit vorhergesagten PBR-Karten zurück. `maps` bestimmt, welche von basecolor, normal, roughness, metalness und height erzeugt werden. Optionen sind `tiling_mode`, `strength` von 0 bis 1, `upscale_factor` mit 0, 2 oder 4 sowie 1 bis 4 Ausgaben.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
prompterforderlich
Typstring
Beschreibung der gewünschten aus dem Bild zu extrahierenden Textur.
image_sizeoptional
Typobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Pixelabmessungen der resultierenden Textur.
num_inference_stepsoptional
Typinteger
Standard8
1 – 8
Anzahl der Denoising-Schritte zur TexTurerzeugung.
seedoptional
Typinteger | null
Zufälliger Seed, der eine reproduzierbare Generierung ermöglicht.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 4
Anzahl der zu erstellenden Texturbilder.
enable_prompt_expansionoptional
Typboolean
Standardtrue
Aktiviert die LLM-basierte Prompt-Erweiterung zum Hinzufügen von Details.
enable_safety_checkeroptional
Typboolean
Standardtrue
Aktiviert die Sicherheitsprüfung generierter Bilder.
tiling_modeoptional
Typenum
Standardboth
bothhorizontalvertical
Richtung der Kachelung: 'both' für omnidirektionale Kachelung, 'horizontal' oder 'vertical'.
tile_sizeoptional
Typinteger
Standard128
32 – 256
Kachelgröße im latenten Raum, wobei 64 512px und 128 1024px entspricht. Auf jeder gekachelten Achse legt die Abmessung des generierten Bildes eine automatische Obergrenze fest.
tile_strideoptional
Typinteger
Standard64
16 – 128
Legt den Abstand zwischen Kacheln im latenten Raum fest; eine automatische Begrenzung verhindert, dass er die Hälfte der effektiven Kachelgröße überschreitet.
image_urlerforderlich image
Typurl · image
Quellbild-URL für die TexTurextraktion.
strengthoptional
Typnumber
Standard0.6
≤ 1> 0
Transformationsstärke, die nur auf ein über image_url bereitgestelltes Bild angewendet wird; andernfalls ungenutzt.
mapsoptional
Typenum[]
Standard["basecolor","normal","roughness","metalness","height"]
Für die Vorhersage ausgewählte PBR-Maps, standardmäßig sind alle fünf ausgewählt. Wenn keine ausgewählt wird, wird die PBR-Schätzung vollständig übersprungen.
upscale_factoroptional
Typenum
Standard0
024
Faktor für die nahtlose SeedVR-Hochskalierung, der vorhergesagte PBR-Maps beeinflusst, die Basistektur jedoch in ihrer ursprünglichen Auflösung belässt. Wählen Sie 2 für doppelte Auflösung, 4 für vierfache Auflösung oder 0 zum Deaktivieren der Hochskalierung.
output_formatoptional
Typenum
Standardpng
jpegpngwebp
Bilddateiformat für Ausgabe-Texturen und PBR-Maps.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
images
array of anyAusgabebilder enthalten neben den von z-image erzeugten kachelbaren Texturen die von PATINA vorhergesagten PBR-Material-Maps.
seed
integerBeim Erzeugen von Texturen verwendeter Seed.
prompt
stringPrompt für die TexTurerzeugung einschließlich aller angewendeten Erweiterungen.
timings
objectZeitaufschlüsselung für den gesamten Prozess in Sekunden.

Weitere Modelle: Bildbearbeitung

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/patina/material/extract.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt