Μετάβαση στο περιεχόμενο

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 από εικόνα προέλευσης, με καθοδήγηση από prompt που ονομάζει την επιφάνεια

Open model · Εικόνα

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

•απαιτείται

Περιγραφή της επιθυμητής υφής προς εξαγωγή από την εικόνα.

•απαιτείται image_url
Αποθέστε ένα αρχείο ή

URL εικόνας προέλευσης για εξαγωγή υφής.

image_size προεπιλογή square_hd

Διαστάσεις pixel της τελικής υφής.

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

Λαμβάνει μια εικόνα εισόδου και prompt που περιγράφει ποια επιφάνεια θα εξαχθεί και επιστρέφει επαναλαμβανόμενη υφή μαζί με προβλεπόμενους χάρτες 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
Διαστάσεις pixel της τελικής υφής.
num_inference_stepsπροαιρετικό
Τύποςinteger
Προεπιλογή8
1 – 8
Πλήθος βημάτων αποθορυβοποίησης που χρησιμοποιούνται για την παραγωγή υφών.
seedπροαιρετικό
Τύποςinteger | null
Τυχαίο seed που καθιστά την παραγωγή αναπαραγώγιμη.
num_imagesπροαιρετικό num_outputs
Τύποςinteger
Προεπιλογή1
1 – 4
Πλήθος εικόνων υφής προς δημιουργία.
enable_prompt_expansionπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ενεργοποιεί την επέκταση prompt με βάση 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
stringPrompt παραγωγής υφής, συμπεριλαμβανομένης τυχόν εφαρμοσμένης επέκτασης.
timings
objectΑναλυτική χρονική κατανομή ολόκληρης της διαδικασίας, σε δευτερόλεπτα.

Περισσότερα μοντέλα: Επεξεργασία εικόνας

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/patina/material/extract.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt