Langkau ke kandungan

PATINA · Material · Extract

Integrasikan

ID model 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"

Fail seperti contoh: $0.17 170 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Open model Penyuntingan Imej #material#pbr#extraction

Mengekstrak tekstur boleh jubin dengan peta PBR daripada imej sumber, dipandu oleh prompt yang menamakan permukaan

Open model · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Perihalan tekstur yang dikehendaki untuk diekstrak daripada imej.

•diperlukan image_url
Lepaskan fail, atau

URL imej sumber untuk pengekstrakan tekstur.

image_size lalai square_hd

Dimensi piksel tekstur yang terhasil.

upscale_factor lalai 0

Faktor peningkatan skala lancar SeedVR yang mempengaruhi peta PBR yang diramalkan tetapi mengekalkan tekstur asas pada resolusi asalnya. Pilih 2 untuk resolusi dua kali ganda, 4 untuk resolusi empat kali ganda atau 0 untuk melumpuhkan peningkatan skala.

num_images lalai 1

Bilangan imej tekstur untuk dicipta.

Lanjutan tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
tiling_mode lalai both

Arah jubinan: 'both' untuk jubinan semua arah, 'horizontal' atau 'vertical'.

output_format lalai png

Format fail imej untuk tekstur output dan peta PBR.

lalai 8

Bilangan langkah penyahhingaran yang digunakan untuk menjana tekstur.

lalai 128

Saiz jubin ruang laten, dengan 64 mewakili 512px dan 128 mewakili 1024px. Pada setiap paksi berjubin, dimensi imej yang dijana menetapkan had atas automatik.

lalai 64

Tetapkan jarak antara jubin ruang laten; had automatik menghalangnya daripada melebihi separuh saiz jubin berkesan.

lalai 0.6

Kekuatan transformasi yang hanya digunakan pada imej yang dibekalkan melalui image_url; jika tidak, tidak digunakan.

Seed rawak yang menjadikan penjanaan boleh dihasilkan semula.

lalai ["basecolor","normal"...

Peta PBR yang dipilih untuk ramalan, dengan kelima-limanya dipilih secara lalai. Jika tiada yang dipilih, anggaran PBR dilangkau sepenuhnya.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang PATINA · Material · Extract

Menerima imej input serta prompt yang menerangkan permukaan untuk diekstrak, lalu mengembalikan tekstur boleh jubin bersama peta PBR yang diramalkan. `maps` memilih basecolor, normal, roughness, metalness dan height yang hendak dihasilkan. Pilihan termasuk `tiling_mode`, `strength` daripada 0 hingga 1, `upscale_factor` 0, 2 atau 4 dan 1 hingga 4 output.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
Perihalan tekstur yang dikehendaki untuk diekstrak daripada imej.
image_sizepilihan
Jenisobject
Lalaisquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi piksel tekstur yang terhasil.
num_inference_stepspilihan
Jenisinteger
Lalai8
1 – 8
Bilangan langkah penyahhingaran yang digunakan untuk menjana tekstur.
seedpilihan
Jenisinteger | null
Seed rawak yang menjadikan penjanaan boleh dihasilkan semula.
num_imagespilihan num_outputs
Jenisinteger
Lalai1
1 – 4
Bilangan imej tekstur untuk dicipta.
enable_prompt_expansionpilihan
Jenisboolean
Lalaitrue
Mendayakan pengembangan prompt berasaskan LLM untuk menambah perincian.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Mendayakan pemeriksaan keselamatan imej yang dijana.
tiling_modepilihan
Jenisenum
Lalaiboth
bothhorizontalvertical
Arah jubinan: 'both' untuk jubinan semua arah, 'horizontal' atau 'vertical'.
tile_sizepilihan
Jenisinteger
Lalai128
32 – 256
Saiz jubin ruang laten, dengan 64 mewakili 512px dan 128 mewakili 1024px. Pada setiap paksi berjubin, dimensi imej yang dijana menetapkan had atas automatik.
tile_stridepilihan
Jenisinteger
Lalai64
16 – 128
Tetapkan jarak antara jubin ruang laten; had automatik menghalangnya daripada melebihi separuh saiz jubin berkesan.
image_urldiperlukan image
Jenisurl · image
URL imej sumber untuk pengekstrakan tekstur.
strengthpilihan
Jenisnumber
Lalai0.6
≤ 1> 0
Kekuatan transformasi yang hanya digunakan pada imej yang dibekalkan melalui image_url; jika tidak, tidak digunakan.
mapspilihan
Jenisenum[]
Lalai["basecolor","normal","roughness","metalness","height"]
Peta PBR yang dipilih untuk ramalan, dengan kelima-limanya dipilih secara lalai. Jika tiada yang dipilih, anggaran PBR dilangkau sepenuhnya.
upscale_factorpilihan
Jenisenum
Lalai0
024
Faktor peningkatan skala lancar SeedVR yang mempengaruhi peta PBR yang diramalkan tetapi mengekalkan tekstur asas pada resolusi asalnya. Pilih 2 untuk resolusi dua kali ganda, 4 untuk resolusi empat kali ganda atau 0 untuk melumpuhkan peningkatan skala.
output_formatpilihan
Jenisenum
Lalaipng
jpegpngwebp
Format fail imej untuk tekstur output dan peta PBR.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of anyImej output menyertakan peta bahan PBR yang diramalkan oleh PATINA bersama tekstur berjubin yang dijana oleh z-image.
seed
integerSeed yang digunakan semasa menjana tekstur.
prompt
stringPrompt penjanaan tekstur, termasuk sebarang pengembangan yang digunakan.
timings
objectPecahan masa yang meliputi keseluruhan proses, dalam saat.

Lebih banyak model: Penyuntingan Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/patina/material/extract.md. Semua model dan panduan: https://doitong.com/developers/llms.txt