Langkau ke kandungan

PATINA · Material

Integrasikan

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

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

Dapatkan kunci API
Open model Teks ke Imej #material#pbr#displacement#metalness

Penjana teks-ke-tekstur yang menghasilkan imej boleh jubin bersama peta PBR, dengan img2img dan inpainting pilihan

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 teks bahan atau tekstur untuk dicipta.

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 image · mask · tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
image_url
Lepaskan fail, atau

URL imej sumber, digunakan untuk inpainting jika mask_url disertakan bersamanya dan untuk pemprosesan imej-ke-imej jika tidak.

mask_url
Lepaskan fail, atau

URL topeng inpainting yang dibekalkan bersama image_url yang diperlukan. Topeng mengekalkan kawasan hitam tanpa perubahan dan menjana semula kawasan putih.

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?wait=20 sebut harga → $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"

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

Mencipta tekstur boleh jubin daripada prompt dan meramalkan peta PBR: basecolor, normal, roughness, metalness dan height. Gunakan `tiling_mode` untuk jubin kedua-dua arah, mendatar atau menegak, dan `upscale_factor` 0, 2 atau 4 untuk membesarkan peta. Menghantar `image_url` mengaktifkan imej-ke-imej, manakala menambah `mask_url` mengaktifkan inpainting. Sehingga 4 imej bagi setiap permintaan.

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
Perihalan teks bahan atau tekstur untuk dicipta.
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_urlpilihan image
Jenisurl · image
URL imej sumber, digunakan untuk inpainting jika mask_url disertakan bersamanya dan untuk pemprosesan imej-ke-imej jika tidak.
mask_urlpilihan mask
Jenisurl · image
URL topeng inpainting yang dibekalkan bersama image_url yang diperlukan. Topeng mengekalkan kawasan hitam tanpa perubahan dan menjana semula kawasan putih.
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",
  "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"
  }
}
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: Teks ke Imej

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