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

PATINA · Material

Ενσωμάτωση

id μοντέλου patina/material
# 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?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"
  }'

# 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,08 $ 80 πιστώσεις API τα αρχεία σας μετρώνται πριν από την εκτέλεση Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Open model Κείμενο σε εικόνα #material#pbr#displacement#metalness

Δημιουργός υφών από κείμενο που παράγει επαναλαμβανόμενες εικόνες και χάρτες PBR, με προαιρετικά img2img και inpainting

Open model · Εικόνα

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

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

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

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

•απαιτείται

Περιγραφή κειμένου του υλικού ή της υφής προς δημιουργία.

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

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

upscale_factor προεπιλογή 0

Συντελεστής απρόσκοπτης μεγέθυνσης SeedVR που επηρεάζει τους προβλεπόμενους χάρτες PBR, αλλά αφήνει την βασική υφή στην αρχική της ανάλυση. Επιλέξτε 2 για διπλάσια ανάλυση, 4 για τετραπλάσια ή 0 για απενεργοποίηση της μεγέθυνσης.

num_images προεπιλογή 1

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

Για προχωρημένους image · mask · tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
image_url
Αποθέστε ένα αρχείο ή

URL της εικόνας προέλευσης, που χρησιμοποιείται για inpainting αν συνοδεύεται από mask_url και για επεξεργασία image-to-image διαφορετικά.

mask_url
Αποθέστε ένα αρχείο ή

URL μάσκας inpainting που παρέχεται μαζί με το απαιτούμενο image_url. Η μάσκα διατηρεί αμετάβλητες τις μαύρες περιοχές και αναδημιουργεί τις λευκές.

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?wait=20 προσφορά → 0,08 $
# 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?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"
  }'

# 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

Δημιουργεί επαναλαμβανόμενες υφές από prompt και προβλέπει χάρτες PBR: basecolor, normal, roughness, metalness και height. Χρησιμοποιήστε το `tiling_mode` για πλακόστρωση και στις δύο κατευθύνσεις, οριζόντια ή κάθετα, και το `upscale_factor` με τιμή 0, 2 ή 4 για μεγέθυνση των χαρτών. Η παροχή `image_url` ενεργοποιεί image-to-image και η προσθήκη `mask_url` ενεργοποιεί inpainting. Έως 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 της εικόνας προέλευσης, που χρησιμοποιείται για inpainting αν συνοδεύεται από mask_url και για επεξεργασία image-to-image διαφορετικά.
mask_urlπροαιρετικό mask
Τύποςurl · image
URL μάσκας inpainting που παρέχεται μαζί με το απαιτούμενο 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",
  "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": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt