Lompat ke konten

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"

File seperti contoh: $0,17 170 kredit API file Anda diukur sebelum dijalankan Jalankan di halaman ini

Dapatkan kunci API
Open model Pengeditan Gambar #material#pbr#extraction

Mengambil tekstur tileable dengan peta PBR dari gambar sumber, dipandu prompt yang menyebutkan permukaan

Open model · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib

Deskripsi tekstur yang diinginkan untuk diekstrak dari gambar.

•wajib image_url
Jatuhkan file, atau

URL gambar sumber untuk ekstraksi tekstur.

image_size bawaan square_hd

Dimensi piksel tekstur yang dihasilkan.

upscale_factor bawaan 0

Faktor peningkatan resolusi tanpa sambungan SeedVR yang memengaruhi peta PBR yang diprediksi, tetapi mempertahankan tekstur dasar pada resolusi aslinya. Pilih 2 untuk resolusi dua kali lipat, 4 untuk empat kali lipat, atau 0 untuk menonaktifkan peningkatan resolusi.

num_images bawaan 1

Jumlah gambar tekstur yang akan dibuat.

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

Arah tiling: 'both' untuk tiling omnidireksional, 'horizontal', atau 'vertical'.

output_format bawaan png

Format file gambar untuk tekstur output dan peta PBR.

bawaan 8

Jumlah langkah denoising yang digunakan untuk menghasilkan tekstur.

bawaan 128

Ukuran tile dalam ruang laten, dengan 64 mewakili 512px dan 128 mewakili 1024px. Pada setiap sumbu yang di-tile, dimensi gambar yang dibuat menetapkan batas atas otomatis.

bawaan 64

Atur stride antar-tile ruang laten; batas otomatis mencegahnya melebihi setengah ukuran tile efektif.

bawaan 0.6

Kekuatan transformasi yang hanya diterapkan pada gambar yang disediakan melalui image_url; jika tidak, tidak digunakan.

Seed acak yang membuat pembuatan dapat direproduksi.

bawaan ["basecolor","normal"...

Peta PBR yang dipilih untuk prediksi, dengan kelimanya dipilih secara bawaan. Jika tidak memilih apa pun, estimasi PBR dilewati sepenuhnya.

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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang PATINA · Material · Extract

Menerima gambar input dan prompt yang menjelaskan permukaan yang akan diekstrak, lalu mengembalikan tekstur tileable beserta peta PBR yang diprediksi. `maps` memilih basecolor, normal, roughness, metalness, dan height yang akan dibuat. Opsi mencakup `tiling_mode`, `strength` dari 0 hingga 1, `upscale_factor` 0, 2, atau 4, dan 1 hingga 4 output.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
Deskripsi tekstur yang diinginkan untuk diekstrak dari gambar.
image_sizeopsional
Tipeobject
Bawaansquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi piksel tekstur yang dihasilkan.
num_inference_stepsopsional
Tipeinteger
Bawaan8
1 – 8
Jumlah langkah denoising yang digunakan untuk menghasilkan tekstur.
seedopsional
Tipeinteger | null
Seed acak yang membuat pembuatan dapat direproduksi.
num_imagesopsional num_outputs
Tipeinteger
Bawaan1
1 – 4
Jumlah gambar tekstur yang akan dibuat.
enable_prompt_expansionopsional
Tipeboolean
Bawaantrue
Mengaktifkan perluasan prompt berbasis LLM untuk menambahkan detail.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Mengaktifkan pemeriksaan keamanan gambar yang dibuat.
tiling_modeopsional
Tipeenum
Bawaanboth
bothhorizontalvertical
Arah tiling: 'both' untuk tiling omnidireksional, 'horizontal', atau 'vertical'.
tile_sizeopsional
Tipeinteger
Bawaan128
32 – 256
Ukuran tile dalam ruang laten, dengan 64 mewakili 512px dan 128 mewakili 1024px. Pada setiap sumbu yang di-tile, dimensi gambar yang dibuat menetapkan batas atas otomatis.
tile_strideopsional
Tipeinteger
Bawaan64
16 – 128
Atur stride antar-tile ruang laten; batas otomatis mencegahnya melebihi setengah ukuran tile efektif.
image_urlwajib image
Tipeurl · image
URL gambar sumber untuk ekstraksi tekstur.
strengthopsional
Tipenumber
Bawaan0.6
≤ 1> 0
Kekuatan transformasi yang hanya diterapkan pada gambar yang disediakan melalui image_url; jika tidak, tidak digunakan.
mapsopsional
Tipeenum[]
Bawaan["basecolor","normal","roughness","metalness","height"]
Peta PBR yang dipilih untuk prediksi, dengan kelimanya dipilih secara bawaan. Jika tidak memilih apa pun, estimasi PBR dilewati sepenuhnya.
upscale_factoropsional
Tipeenum
Bawaan0
024
Faktor peningkatan resolusi tanpa sambungan SeedVR yang memengaruhi peta PBR yang diprediksi, tetapi mempertahankan tekstur dasar pada resolusi aslinya. Pilih 2 untuk resolusi dua kali lipat, 4 untuk empat kali lipat, atau 0 untuk menonaktifkan peningkatan resolusi.
output_formatopsional
Tipeenum
Bawaanpng
jpegpngwebp
Format file gambar untuk tekstur output dan peta PBR.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
images
array of anyGambar output menyertakan peta material PBR yang diprediksi oleh PATINA bersama tekstur yang dapat di-tile dan dibuat oleh z-image.
seed
integerSeed yang diterapkan saat membuat tekstur.
prompt
stringPrompt pembuatan tekstur, termasuk perluasan apa pun yang diterapkan.
timings
objectRincian waktu yang mencakup seluruh proses, dalam detik.

Model lainnya: Pengeditan Gambar

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