Bỏ qua đến nội dung

Meshy 7 Retexture

Tích hợp

Id mô hình meshy/v7/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/v7/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

Phiên bản Meshy 7 về tạo lại kết cấu 3D: diện mạo mới từ lời nhắc hoặc hình ảnh kiểu, với đầu ra PBR tùy chọn

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/v7/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/v7/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 7 Retexture

Tạo lại kết cấu cho tệp 3D được cung cấp (.glb, .gltf, .obj, .fbx, .stl) bằng mô tả văn bản tối đa 600 ký tự hoặc hình ảnh phong cách 2D; nếu gửi cả hai thì hình ảnh được ưu tiên. Độ phân giải màu cơ bản là 2k, 4k hoặc 8k; ở 8k, bản đồ PBR giảm xuống 4k và không có bản đồ phát xạ. Đặt `enable_original_uv` để giữ UV hiện có và `enable_pbr` để nhận bản đồ kim loại, độ nhám và pháp tuyến. Trả về GLB cùng các định dạng và tệp kết cấu khác.

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/v7/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.

Thêm mô hình: 3D

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