Bỏ qua đến nội dung

Meshy 6 Retexture

Tích hợp

Id mô hình meshy/v6/retexture
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v6/retexture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Yêu cầu này: 0,30 $ 300 tín dụng API · ≈ 31,41 ₽ Chạy trên trang này

Lấy khóa API
Meshy 3D Đầu ra 4K #3d#3d-to-3d#textures#pbr

Tạo lại kết cấu cho mô hình 3D đã tải lên từ lời nhắc văn bản hoặc hình ảnh kiểu, với bản đồ PBR tùy chọn và kết cấu tối đa 8k

Meshy · 3D

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.

texture_resolution mặc định 2k

Các lựa chọn độ phân giải màu cơ sở là 2k (2048), 4k (4096) và 8k (8192). Chọn 8k sẽ giới hạn bản đồ PBR ở 4k và bỏ qua bản đồ phát xạ; cả 8k và 4k chỉ khả dụng với Meshy 6 hoặc 7.

•bắt buộc

Nguồn mô hình 3D để tạo kết cấu, được cung cấp dưới dạng URL công khai hoặc URI dữ liệu base64 dùng MIME type application/octet-stream. Các phần mở rộng tệp được chấp nhận là .glb, .gltf, .obj, .fbx và .stl.

Nâng cao text_style_prompt · image_style_url · enable_original_uv · enable_pbr · enable_safety_checker
0 / 600

Văn bản kiểu kết cấu, bắt buộc khi không có image_style_url và giới hạn 600 ký tự.

Thả tệp hoặc

Hướng dẫn tạo kết cấu 2D được ưu tiên hơn text_style_prompt khi được cung cấp dưới dạng image_style_url. Cung cấp hình ảnh này nếu không có text_style_prompt; các loại tệp được hỗ trợ là .jpg, .jpeg và .png.

POST /run/meshy/v6/retexture?wait=20 báo giá → 0,30 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v6/retexture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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ề Meshy 6 Retexture

Thay thế kết cấu bề mặt của lưới hiện có ở định dạng .glb, .gltf, .obj, .fbx hoặc .stl. Phong cách lấy từ `text_style_prompt` (tối đa 600 ký tự) hoặc `image_style_url`; nếu cung cấp cả hai thì `image_style_url` được ưu tiên. `texture_resolution` có thể là 2k, 4k hoặc 8k, `enable_pbr` thêm bản đồ kim loại, độ nhám và pháp tuyến, còn `enable_original_uv` giữ bố cục UV của mô hình. Đầu ra gồm GLB, các định dạng khác, kết cấu và ảnh thu nhỏ.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
model_urlbắt buộc
Kiểustring
Nguồn mô hình 3D để tạo kết cấu, được cung cấp dưới dạng URL công khai hoặc URI dữ liệu base64 dùng MIME type application/octet-stream. Các phần mở rộng tệp được chấp nhận là .glb, .gltf, .obj, .fbx và .stl.
text_style_prompttùy chọn
Kiểustring | null
≤ 600 ký tự
Văn bản kiểu kết cấu, bắt buộc khi không có image_style_url và giới hạn 600 ký tự.
image_style_urltùy chọn
Kiểuurl · image
Hướng dẫn tạo kết cấu 2D được ưu tiên hơn text_style_prompt khi được cung cấp dưới dạng image_style_url. Cung cấp hình ảnh này nếu không có text_style_prompt; các loại tệp được hỗ trợ là .jpg, .jpeg và .png.
texture_resolutiontùy chọn
Kiểuenum
Mặc định2k
2k4k8k
Các lựa chọn độ phân giải màu cơ sở là 2k (2048), 4k (4096) và 8k (8192). Chọn 8k sẽ giới hạn bản đồ PBR ở 4k và bỏ qua bản đồ phát xạ; cả 8k và 4k chỉ khả dụng với Meshy 6 hoặc 7.
enable_original_uvtùy chọn
Kiểuboolean
Mặc địnhtrue
Giữ UV thay vì tạo lại bằng cách bật tùy chọn này. Chất lượng có thể giảm nếu bật cho mô hình không có ánh xạ UV ban đầu.
enable_pbrtùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc tạo các bản đồ PBR kim loại, độ nhám và pháp tuyến cùng với màu cơ sở.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Công tắc kiểm tra an toàn trước xử lý: true khiến kiểm tra an toàn đầu vào là điều kiện bắt buộc trước khi xử lý.
bắt buộc

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": "meshy/v6/retexture",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "model_url": "https://example.com/your-file.glb"
  },
  "output": {
    "model_glb": {
      "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
    },
    "thumbnail": {
      "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
    },
    "model_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
      },
      "obj": {
        "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
      },
      "usdz": {
        "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
      },
      "blend": {
        "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
      },
      "stl": {
        "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
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "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
        },
        "metallic": {
          "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
        },
        "normal": {
          "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
        },
        "roughness": {
          "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
        }
      }
    ],
    "text_style_prompt": "red and black chest",
    "image_style_url": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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
model_glb
object {url, content_type, file_name, file_size}Đối tượng 3D định dạng GLB với kết cấu đã cập nhật.
thumbnail
object {url, content_type, file_name, file_size} | nullHình thu nhỏ hiển thị bản xem trước của mô hình sau khi tạo lại kết cấu.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Liên kết đến mô hình 3D ở nhiều định dạng.
texture_urls
array of object {base_color, metallic, normal, roughness}Các tệp kết cấu được biểu diễn dưới dạng mảng đối tượng.
text_style_prompt
string | nullLời nhắc tạo kết cấu đã được sử dụng, nếu được cung cấp.
image_style_url
string | nullURL của hình ảnh tạo kết cấu đã được sử dụng, nếu được cung cấp.

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