Bỏ qua đến nội dung

Meshy V7 Text to 3D

Tích hợp

Id mô hình meshy/v7/text-to-3d
# 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/text-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Các tệp như ví dụ: 1,20 $ 1.200 tín dụng API · ≈ 129,10 ₽ 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
Meshy Văn bản sang 3D #stylized#transform

Text-to-3D với Meshy 7: chế độ preview hoặc full, hình học 2k, tùy chọn PBR, gắn khung xương và hoạt ảnh

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.

•bắt buộc 88 / 600

Mô tả đối tượng cần biểu diễn dưới dạng mô hình 3D, giới hạn 600 ký tự.

mode mặc định full

Chế độ tạo sinh: 'preview' xuất hình học không có kết cấu, còn 'full' xuất mô hình có kết cấu bằng cách kết hợp preview và refine.

geometry_resolution

Độ phân giải hình học lưới; các tùy chọn Meshy-7 được hỗ trợ là standard và 2k.

Nâng cao texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode
0 / 600

Hướng dẫn tạo kết cấu bằng lời nhắc văn bản bổ sung trong chế độ 'full'; các chế độ khác không sử dụng tùy chọn này.

Thả tệp hoặc

Hình ảnh tham chiếu 2D để tạo kết cấu, chỉ áp dụng trong chế độ 'full'.

model_type mặc định standard

Chế độ lưới 3D: chọn 'lowpoly' để tạo kết quả ít đa giác, tối ưu cho đa giác rõ ràng hơn; ở chế độ này Meshy bỏ qua topology, target_polycount và should_remesh. Chọn 'standard' để tạo kết quả chi tiết cao thông thường, hoặc 'smart-topology' để dùng Meshy-T2 trong bước hình học (preview) và nhận các phần sạch được tạo riêng ngay từ đầu.

topology mặc định triangle

Lựa chọn topology mô hình giữa Triangle cho chi tiết hình học và Quad cho bề mặt mượt hơn.

symmetry_mode mặc định auto

Thiết lập đối xứng được áp dụng khi tạo mô hình.

pose_mode mặc định

Để chuỗi trống để không chỉ định tư thế của mô hình được tạo, hoặc yêu cầu tư thế chữ A bằng 'a-pose' hay tư thế chữ T bằng 't-pose'.

mặc định 30000

Mục tiêu số lượng đa giác, giới hạn ở 15,000 khi model_type là 'smart-topology'. Nếu bỏ qua mục tiêu ở chế độ đó, Meshy sẽ chọn mặc định thấp hơn là 4,000.

mặc định 1.7

Cung cấp chiều cao nhân vật ước tính bằng mét khi enable_rigging là true; nếu không, giá trị này không có tác dụng.

mặc định 92

ID hoạt ảnh preset trong thư viện Meshy, với các hành động có tại https://docs.meshy.ai/en/api/animation-library. Việc xác thực và sử dụng chỉ áp dụng khi enable_animation là true: các giá trị ngoài [0, 696] bị từ chối với lỗi 422, và "Idle" tương ứng với `0`.

Dùng lại seed này cùng lời nhắc không thay đổi để thường tái tạo kết quả trước đó.

POST /run/meshy/v7/text-to-3d?wait=20 báo giá → 1,20 $
# 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/text-to-3d?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.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 V7 Text to 3D

Tạo mô hình 3D từ `prompt` tối đa 600 ký tự, với `enable_prompt_expansion` tùy chọn. `mode` trả về hình học không có kết cấu hoặc mô hình có kết cấu. Chọn standard, lowpoly hoặc smart-topology qua `model_type`, đặt `target_polycount` từ 100 đến 300000 và chọn `geometry_resolution` standard hoặc 2k. Có thể thêm gắn khung xương và các thiết lập sẵn hoạt ảnh cho nhân vật hình người.

Tham số

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
≤ 600 ký tự
Mô tả đối tượng cần biểu diễn dưới dạng mô hình 3D, giới hạn 600 ký tự.
modetùy chọn
Kiểuenum
Mặc địnhfull
previewfull
Chế độ tạo sinh: 'preview' xuất hình học không có kết cấu, còn 'full' xuất mô hình có kết cấu bằng cách kết hợp preview và refine.
seedtùy chọn
Kiểuinteger | null
Dùng lại seed này cùng lời nhắc không thay đổi để thường tái tạo kết quả trước đó.
model_typetùy chọn
Kiểuenum
Mặc địnhstandard
standardlowpolysmart-topology
Chế độ lưới 3D: chọn 'lowpoly' để tạo kết quả ít đa giác, tối ưu cho đa giác rõ ràng hơn; ở chế độ này Meshy bỏ qua topology, target_polycount và should_remesh. Chọn 'standard' để tạo kết quả chi tiết cao thông thường, hoặc 'smart-topology' để dùng Meshy-T2 trong bước hình học (preview) và nhận các phần sạch được tạo riêng ngay từ đầu.
topologytùy chọn
Kiểuenum
Mặc địnhtriangle
quadtriangle
Lựa chọn topology mô hình giữa Triangle cho chi tiết hình học và Quad cho bề mặt mượt hơn.
target_polycounttùy chọn
Kiểuinteger
Mặc định30000
100 – 300.000
Mục tiêu số lượng đa giác, giới hạn ở 15,000 khi model_type là 'smart-topology'. Nếu bỏ qua mục tiêu ở chế độ đó, Meshy sẽ chọn mặc định thấp hơn là 4,000.
should_remeshtùy chọn
Kiểuboolean
Mặc địnhtrue
Bỏ qua việc tạo lại lưới và nhận lưới tam giác thô bằng cách đặt giá trị này thành false; nếu không, hãy bật giai đoạn tạo lại lưới.
symmetry_modetùy chọn
Kiểuenum
Mặc địnhauto
offautoon
Thiết lập đối xứng được áp dụng khi tạo mô hình.
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ở.
is_a_t_posetùy chọn
Kiểuboolean
Mặc địnhfalse
Công tắc tạo tư thế chữ T, được kích hoạt bằng true; đã lỗi thời và được thay thế bằng pose_mode.
pose_modetùy chọn
Kiểuenum
Mặc định
a-poset-pose
Để chuỗi trống để không chỉ định tư thế của mô hình được tạo, hoặc yêu cầu tư thế chữ A bằng 'a-pose' hay tư thế chữ T bằng 't-pose'.
enable_prompt_expansiontùy chọn
Kiểuboolean
Mặc địnhfalse
Cho phép mô hình ngôn ngữ lớn bổ sung chi tiết cho lời nhắc. Việc bật mở rộng này không thay đổi ý nghĩa của lời nhắc.
texture_prompttùy chọn
Kiểustring | null
≤ 600 ký tự
Hướng dẫn tạo kết cấu bằng lời nhắc văn bản bổ sung trong chế độ 'full'; các chế độ khác không sử dụng tùy chọn này.
texture_image_urltùy chọn
Kiểuurl · image
Hình ảnh tham chiếu 2D để tạo kết cấu, chỉ áp dụng trong chế độ 'full'.
enable_riggingtùy chọn
Kiểuboolean
Mặc địnhfalse
Tự động gắn xương cho nhân vật hình người, hiệu quả nhất với các mô hình hình người có các chi dễ phân biệt. Bật tùy chọn này sẽ gắn xương cho mô hình được tạo và cung cấp hoạt ảnh cơ bản để đi bộ và chạy.
rigging_height_meterstùy chọn
Kiểunumber
Mặc định1.7
> 0
Cung cấp chiều cao nhân vật ước tính bằng mét khi enable_rigging là true; nếu không, giá trị này không có tác dụng.
enable_animationtùy chọn
Kiểuboolean
Mặc địnhfalse
Mô hình đã gắn xương có nhận hoạt ảnh preset hay không; tùy chọn này yêu cầu enable_rigging là true.
animation_action_idtùy chọn
Kiểuinteger
Mặc định92
ID hoạt ảnh preset trong thư viện Meshy, với các hành động có tại https://docs.meshy.ai/en/api/animation-library. Việc xác thực và sử dụng chỉ áp dụng khi enable_animation là true: các giá trị ngoài [0, 696] bị từ chối với lỗi 422, và "Idle" tương ứng với `0`.
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ý.
geometry_resolutiontùy chọn
Kiểuenum
standard2k
Độ phân giải hình học lưới; các tùy chọn Meshy-7 được hỗ trợ là standard và 2k.
ultra_modetùy chọn
Kiểuboolean
Mặc địnhfalse
Tùy chọn đã lỗi thời, được thay thế bởi geometry_resolution; geometry_resolution được ưu tiên nếu cung cấp cả hai. Hãy dùng geometry_resolution='2k'.
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/text-to-3d",
  "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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "animation_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
    },
    "animation_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
    },
    "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
        }
      }
    ],
    "seed": 42,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "rigged_character_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
    },
    "rigged_character_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
    },
    "basic_animations": {
      "walking_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
      },
      "walking_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
      },
      "walking_armature_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
      },
      "running_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
      },
      "running_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
      },
      "running_armature_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
      }
    },
    "rig_task_id": "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
animation_glb
object {url, content_type, file_name, file_size} | nullKết quả hoạt ảnh chứa mô hình 3D dưới dạng GLB; phản hồi bỏ qua kết quả này trừ khi enable_animation là true.
animation_fbx
object {url, content_type, file_name, file_size} | nullKết quả hoạt ảnh chứa mô hình 3D dưới dạng FBX; phản hồi bỏ qua kết quả này trừ khi enable_animation là true.
model_glb
object {url, content_type, file_name, file_size}Tệp GLB chứa đối tượng 3D được tạo.
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 được tạo.
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.
seed
integer | nullGiá trị seed dùng trong quá trình tạo sinh.
prompt
stringLời nhắc văn bản được cung cấp để tạo sinh.
actual_prompt
string | nullLời nhắc thực tế được áp dụng khi tạo sinh lúc bật mở rộng lời nhắc.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullKết quả gắn xương được trả về dưới dạng tệp nhân vật GLB; không có trong phản hồi trừ khi enable_rigging là true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullKết quả gắn xương được trả về dưới dạng tệp nhân vật FBX; không có trong phản hồi trừ khi enable_rigging là true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullHoạt ảnh đi bộ và chạy cơ bản, chỉ được đưa vào khi enable_rigging là true.
rig_task_id
string | nullMã định danh tác vụ gắn xương; chỉ được đưa vào khi enable_rigging là true.

Thêm mô hình: Văn bản sang 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/text-to-3d.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt