Langkau ke kandungan

Meshy V7 Text to 3D

Integrasikan

ID model 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fail seperti contoh: $1.20 1,200 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Meshy Teks ke 3D #stylized#transform

Teks-ke-3D dengan Meshy 7: mod pratonton atau penuh, geometri 2k, serta pilihan PBR, rigging dan animasi

Meshy · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan 88 / 600

Huraian objek untuk diwakili sebagai model 3D, dihadkan kepada 600 aksara.

mode lalai full

Mod penjanaan: 'preview' menghasilkan geometri tanpa tekstur, manakala 'full' menghasilkan model bertekstur dengan menggabungkan preview dan refine.

geometry_resolution

Resolusi geometri jerat; pilihan Meshy-7 yang disokong ialah standard dan 2k.

Lanjutan 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

Bimbing tekstur dengan prompt teks tambahan dalam mod 'full'; mod lain tidak menggunakannya.

Lepaskan fail, atau

Imej rujukan 2D untuk penjanaan tekstur, digunakan hanya dalam mod 'full'.

model_type lalai standard

Mod jerat 3D: pilih 'lowpoly' untuk hasil poligon rendah yang dioptimumkan bagi poligon lebih kemas; dalam mod ini Meshy mengabaikan topology, target_polycount dan should_remesh. Untuk hasil perincian tinggi konvensional, pilih 'standard', atau pilih 'smart-topology' untuk menggunakan Meshy-T2 semasa langkah geometri (preview) dan mendapatkan bahagian kemas yang dijana secara berasingan sejak awal.

topology lalai triangle

Pilihan topologi model antara Triangle untuk perincian geometri dan Quad untuk kelicinan permukaan.

symmetry_mode lalai auto

Tetapan simetri yang digunakan semasa menjana model.

pose_mode lalai

Biarkan rentetan kosong untuk tidak menentukan pose model yang dijana, atau minta pose-A dengan 'a-pose' atau pose-T dengan 't-pose'.

lalai 30000

Sasaran bilangan poligon, dihadkan kepada 15,000 apabila model_type ialah 'smart-topology'. Jika sasaran tidak ditentukan dalam mod itu, lalai Meshy yang lebih rendah, iaitu 4,000, digunakan.

lalai 1.7

Bekalkan ketinggian watak yang dianggarkan dalam meter apabila enable_rigging ialah true; jika tidak, nilai ini tiada kesan.

lalai 92

ID pratetap animasi pustaka Meshy, dengan tindakan yang tersedia disenaraikan di https://docs.meshy.ai/en/api/animation-library. Pengesahan dan penggunaan hanya terpakai apabila enable_animation ialah true: nilai di luar [0, 696] ditolak dengan 422, dan "Idle" sepadan dengan `0`.

Guna semula benih ini bersama prompt yang tidak berubah untuk biasanya menghasilkan semula hasil terdahulu.

POST /run/meshy/v7/text-to-3d?wait=20 sebut harga → $1.20
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Meshy V7 Text to 3D

Menjana model 3D daripada `prompt` sehingga 600 aksara, dengan `enable_prompt_expansion` pilihan. `mode` mengembalikan sama ada geometri tanpa tekstur atau model bertekstur. Pilih standard, lowpoly atau smart-topology melalui `model_type`, tetapkan `target_polycount` dari 100 hingga 300000, dan pilih `geometry_resolution` standard atau 2k. Praset rigging dan animasi boleh ditambah untuk watak humanoid.

Parameter

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 600 aksara
Huraian objek untuk diwakili sebagai model 3D, dihadkan kepada 600 aksara.
modepilihan
Jenisenum
Lalaifull
previewfull
Mod penjanaan: 'preview' menghasilkan geometri tanpa tekstur, manakala 'full' menghasilkan model bertekstur dengan menggabungkan preview dan refine.
seedpilihan
Jenisinteger | null
Guna semula benih ini bersama prompt yang tidak berubah untuk biasanya menghasilkan semula hasil terdahulu.
model_typepilihan
Jenisenum
Lalaistandard
standardlowpolysmart-topology
Mod jerat 3D: pilih 'lowpoly' untuk hasil poligon rendah yang dioptimumkan bagi poligon lebih kemas; dalam mod ini Meshy mengabaikan topology, target_polycount dan should_remesh. Untuk hasil perincian tinggi konvensional, pilih 'standard', atau pilih 'smart-topology' untuk menggunakan Meshy-T2 semasa langkah geometri (preview) dan mendapatkan bahagian kemas yang dijana secara berasingan sejak awal.
topologypilihan
Jenisenum
Lalaitriangle
quadtriangle
Pilihan topologi model antara Triangle untuk perincian geometri dan Quad untuk kelicinan permukaan.
target_polycountpilihan
Jenisinteger
Lalai30000
100 – 300,000
Sasaran bilangan poligon, dihadkan kepada 15,000 apabila model_type ialah 'smart-topology'. Jika sasaran tidak ditentukan dalam mod itu, lalai Meshy yang lebih rendah, iaitu 4,000, digunakan.
should_remeshpilihan
Jenisboolean
Lalaitrue
Langkau penjeratan semula dan terima jerat segi tiga mentah dengan menetapkan nilai ini kepada false; jika tidak, dayakan fasa penjeratan semula.
symmetry_modepilihan
Jenisenum
Lalaiauto
offautoon
Tetapan simetri yang digunakan semasa menjana model.
enable_pbrpilihan
Jenisboolean
Lalaifalse
Mengawal penjanaan peta PBR metalik, kekasaran dan normal bersama warna asas.
is_a_t_posepilihan
Jenisboolean
Lalaifalse
Suis penjanaan pose-T yang diaktifkan oleh true; tidak digunakan lagi dan digantikan dengan pose_mode.
pose_modepilihan
Jenisenum
Lalai
a-poset-pose
Biarkan rentetan kosong untuk tidak menentukan pose model yang dijana, atau minta pose-A dengan 'a-pose' atau pose-T dengan 't-pose'.
enable_prompt_expansionpilihan
Jenisboolean
Lalaifalse
Benarkan model bahasa besar memperkaya prompt dengan butiran. Mendayakan pengembangan ini mengekalkan maksud prompt.
texture_promptpilihan
Jenisstring | null
≤ 600 aksara
Bimbing tekstur dengan prompt teks tambahan dalam mod 'full'; mod lain tidak menggunakannya.
texture_image_urlpilihan
Jenisurl · image
Imej rujukan 2D untuk penjanaan tekstur, digunakan hanya dalam mod 'full'.
enable_riggingpilihan
Jenisboolean
Lalaifalse
Pemasangan rangka humanoid automatik, paling berkesan untuk model humanoid yang anggota badannya jelas dapat dibezakan. Mendayakannya memasang rangka pada model yang dijana dan membekalkan animasi asas berjalan dan berlari.
rigging_height_meterspilihan
Jenisnumber
Lalai1.7
> 0
Bekalkan ketinggian watak yang dianggarkan dalam meter apabila enable_rigging ialah true; jika tidak, nilai ini tiada kesan.
enable_animationpilihan
Jenisboolean
Lalaifalse
Sama ada model yang telah dipasang rangkanya menerima animasi pratetap, yang memerlukan enable_rigging bernilai true.
animation_action_idpilihan
Jenisinteger
Lalai92
ID pratetap animasi pustaka Meshy, dengan tindakan yang tersedia disenaraikan di https://docs.meshy.ai/en/api/animation-library. Pengesahan dan penggunaan hanya terpakai apabila enable_animation ialah true: nilai di luar [0, 696] ditolak dengan 422, dan "Idle" sepadan dengan `0`.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Suis semakan keselamatan prapemprosesan: true menjadikan semakan keselamatan input prasyarat pemprosesan.
geometry_resolutionpilihan
Jenisenum
standard2k
Resolusi geometri jerat; pilihan Meshy-7 yang disokong ialah standard dan 2k.
ultra_modepilihan
Jenisboolean
Lalaifalse
Pilihan yang tidak digunakan lagi dan digantikan oleh geometry_resolution, yang diutamakan jika kedua-duanya dibekalkan; gunakan geometry_resolution='2k' sebagai ganti.
diperlukan

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
animation_glb
object {url, content_type, file_name, file_size} | nullHasil animasi yang mengandungi model 3D sebagai GLB; respons tidak menyertakan hasil ini melainkan enable_animation ialah true.
animation_fbx
object {url, content_type, file_name, file_size} | nullHasil animasi yang mengandungi model 3D sebagai FBX; respons tidak menyertakan hasil ini melainkan enable_animation ialah true.
model_glb
object {url, content_type, file_name, file_size}Fail GLB yang mengandungi objek 3D yang dijana.
thumbnail
object {url, content_type, file_name, file_size} | nullLakaran kecil yang menunjukkan pratonton model yang dijana.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Pautan ke model 3D dalam pelbagai format.
texture_urls
array of object {base_color, metallic, normal, roughness}Fail tekstur yang diwakili sebagai tatasusunan objek.
seed
integer | nullNilai seed yang digunakan semasa penjanaan.
prompt
stringPrompt teks yang dibekalkan untuk penjanaan.
actual_prompt
string | nullPrompt yang sebenarnya digunakan untuk penjanaan apabila pengembangan prompt didayakan.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullHasil pemasangan rangka yang dihantar sebagai fail watak GLB; tiada dalam respons melainkan enable_rigging ialah true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullHasil pemasangan rangka yang dihantar sebagai fail watak FBX; tiada dalam respons melainkan enable_rigging ialah true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimasi asas berjalan dan berlari, disertakan hanya jika enable_rigging ialah true.
rig_task_id
string | nullPengecam tugas pemasangan rangka; disertakan hanya jika enable_rigging ialah true.

Lebih banyak model: Teks ke 3D

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/meshy/v7/text-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt