Bỏ qua đến nội dung

PATINA · Material · Extract

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 0,17 $ 170 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Open model Chỉnh sửa hình ảnh #material#pbr#extraction

Trích xuất họa tiết có thể lát cùng các bản đồ PBR từ hình ảnh nguồn, theo lời nhắc nêu bề mặt

Open model · Hình ảnh

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

Mô tả kết cấu mong muốn cần trích xuất từ hình ảnh.

•bắt buộc image_url
Thả tệp hoặc

URL hình ảnh nguồn để trích xuất kết cấu.

image_size mặc định square_hd

Kích thước pixel của kết cấu kết quả.

upscale_factor mặc định 0

Hệ số nâng cấp liền mạch SeedVR áp dụng cho các bản đồ PBR được dự đoán nhưng giữ kết cấu cơ sở ở độ phân giải ban đầu. Chọn 2 để tăng gấp đôi độ phân giải, 4 để tăng gấp bốn lần hoặc 0 để tắt nâng cấp.

num_images mặc định 1

Số lượng hình ảnh kết cấu cần tạo.

Nâng cao tiling_mode · output_format · num_inference_steps · tile_size · tile_stride · strength · seed · enable_prompt_expansion · enable_safety_checker · maps
tiling_mode mặc định both

Hướng lát: 'both' để lát đa hướng, 'horizontal' hoặc 'vertical'.

output_format mặc định png

Định dạng tệp hình ảnh cho kết cấu đầu ra và bản đồ PBR.

mặc định 8

Số bước khử nhiễu dùng để tạo kết cấu.

mặc định 128

Kích thước ô trong không gian tiềm ẩn, trong đó 64 tương ứng với 512px và 128 tương ứng với 1024px. Trên mỗi trục được lát, kích thước hình ảnh được tạo sẽ đặt giới hạn trên tự động.

mặc định 64

Đặt bước dịch giữa các ô trong không gian tiềm ẩn; giới hạn tự động ngăn giá trị vượt quá một nửa kích thước ô hiệu dụng.

mặc định 0.6

Cường độ biến đổi chỉ áp dụng cho hình ảnh được cung cấp qua image_url; nếu không thì không được sử dụng.

Seed ngẫu nhiên giúp tái tạo kết quả tạo sinh.

mặc định ["basecolor","normal"...

Các bản đồ PBR được chọn để dự đoán, theo mặc định cả năm bản đồ đều được chọn. Không chọn bản đồ nào sẽ bỏ qua hoàn toàn việc ước tính PBR.

POST /run/patina/material/extract?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về PATINA · Material · Extract

Nhận một hình ảnh đầu vào cùng lời nhắc mô tả bề mặt cần trích xuất, rồi trả về họa tiết có thể lát cùng các bản đồ PBR được dự đoán. `maps` chọn các bản đồ basecolor, normal, roughness, metalness và height cần tạo. Các tùy chọn gồm `tiling_mode`, `strength` từ 0 đến 1, `upscale_factor` có giá trị 0, 2 hoặc 4 và từ 1 đến 4 đầu ra.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
Mô tả kết cấu mong muốn cần trích xuất từ hình ảnh.
image_sizetùy chọn
Kiểuobject
Mặc địnhsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Kích thước pixel của kết cấu kết quả.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định8
1 – 8
Số bước khử nhiễu dùng để tạo kết cấu.
seedtùy chọn
Kiểuinteger | null
Seed ngẫu nhiên giúp tái tạo kết quả tạo sinh.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số lượng hình ảnh kết cấu cần tạo.
enable_prompt_expansiontùy chọn
Kiểuboolean
Mặc địnhtrue
Bật mở rộng lời nhắc dựa trên LLM để bổ sung chi tiết.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Bật kiểm tra an toàn cho hình ảnh được tạo.
tiling_modetùy chọn
Kiểuenum
Mặc địnhboth
bothhorizontalvertical
Hướng lát: 'both' để lát đa hướng, 'horizontal' hoặc 'vertical'.
tile_sizetùy chọn
Kiểuinteger
Mặc định128
32 – 256
Kích thước ô trong không gian tiềm ẩn, trong đó 64 tương ứng với 512px và 128 tương ứng với 1024px. Trên mỗi trục được lát, kích thước hình ảnh được tạo sẽ đặt giới hạn trên tự động.
tile_stridetùy chọn
Kiểuinteger
Mặc định64
16 – 128
Đặt bước dịch giữa các ô trong không gian tiềm ẩn; giới hạn tự động ngăn giá trị vượt quá một nửa kích thước ô hiệu dụng.
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh nguồn để trích xuất kết cấu.
strengthtùy chọn
Kiểunumber
Mặc định0.6
≤ 1> 0
Cường độ biến đổi chỉ áp dụng cho hình ảnh được cung cấp qua image_url; nếu không thì không được sử dụng.
mapstùy chọn
Kiểuenum[]
Mặc định["basecolor","normal","roughness","metalness","height"]
Các bản đồ PBR được chọn để dự đoán, theo mặc định cả năm bản đồ đều được chọn. Không chọn bản đồ nào sẽ bỏ qua hoàn toàn việc ước tính PBR.
upscale_factortùy chọn
Kiểuenum
Mặc định0
024
Hệ số nâng cấp liền mạch SeedVR áp dụng cho các bản đồ PBR được dự đoán nhưng giữ kết cấu cơ sở ở độ phân giải ban đầu. Chọn 2 để tăng gấp đôi độ phân giải, 4 để tăng gấp bốn lần hoặc 0 để tắt nâng cấp.
output_formattùy chọn
Kiểuenum
Mặc địnhpng
jpegpngwebp
Định dạng tệp hình ảnh cho kết cấu đầu ra và bản đồ PBR.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
images
array of anyHình ảnh đầu ra bao gồm các bản đồ vật liệu PBR do PATINA dự đoán cùng với các kết cấu có thể lát được tạo bởi z-image.
seed
integerSeed được áp dụng khi tạo kết cấu.
prompt
stringLời nhắc tạo kết cấu, bao gồm mọi phần mở rộng đã áp dụng.
timings
objectPhân tích thời gian bao quát toàn bộ quá trình, tính theo giây.

Thêm mô hình: Chỉnh sửa hình ảnh

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/patina/material/extract.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt