Langkau ke kandungan

Meshy V7 Image to 3D

Integrasikan

ID model meshy/v7/image-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/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"

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

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

Menukar satu imej kepada jejaring 3D dengan pilihan geometri 2k, PBR, rigging dan animasi pilihan

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 image_url
Lepaskan fail, atau

Bekalkan imej sumber untuk penciptaan 3D melalui URL atau URI data base64, menggunakan .jpg, .jpeg, .png, AVIF atau HEIF. Penukaran automatik mengendalikan input AVIF dan HEIF.

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 · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker · ultra_mode
0 / 600

Arahan teks yang mengarahkan penjanaan tekstur.

Lepaskan fail, atau

Imej rujukan 2D yang mengarahkan penjanaan tekstur.

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 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

Pilih sama ada penjanaan model memaksa simetri dengan On, mengabaikannya dengan Off, atau menentukannya secara automatik dengan Auto.

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`.

POST /run/meshy/v7/image-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/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"

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 Image to 3D

Mencipta model 3D daripada satu imej dalam `image_url` (JPG, PNG, AVIF atau HEIF). `model_type` memilih standard, lowpoly atau smart-topology, dan `target_polycount` menerima 100 hingga 300000. `geometry_resolution` menawarkan standard atau 2k. Tekstur boleh dimatikan dengan `should_texture`, manakala peta PBR, mod pose, rig humanoid dan praset animasi adalah pilihan.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
Bekalkan imej sumber untuk penciptaan 3D melalui URL atau URI data base64, menggunakan .jpg, .jpeg, .png, AVIF atau HEIF. Penukaran automatik mengendalikan input AVIF dan HEIF.
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 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.
symmetry_modepilihan
Jenisenum
Lalaiauto
offautoon
Pilih sama ada penjanaan model memaksa simetri dengan On, mengabaikannya dengan Off, atau menentukannya secara automatik dengan Auto.
should_remeshpilihan
Jenisboolean
Lalaitrue
Mendayakan atau melumpuhkan peringkat penjeratan semula.
should_texturepilihan
Jenisboolean
Lalaitrue
Mendayakan atau melumpuhkan penjanaan tekstur.
enable_pbrpilihan
Jenisboolean
Lalaifalse
Menambahkan 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'.
texture_promptpilihan
Jenisstring | null
≤ 600 aksara
Arahan teks yang mengarahkan penjanaan tekstur.
texture_image_urlpilihan
Jenisurl · image
Imej rujukan 2D yang mengarahkan penjanaan tekstur.
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 Nama kanonik, turut diterima

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/image-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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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,
    "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}Objek fail tekstur dalam tatasusunan yang distrukturkan agar sepadan dengan Meshy API.
seed
integer | nullBenih penjanaan, jika tersedia.
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: Imej ke 3D

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