Langkau ke kandungan

Meshy V7 Multi Image to 3D

Integrasikan

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

Membina satu model 3D daripada 1 hingga 4 pandangan objek yang sama, dengan kawalan poligon dan topologi

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

Set imej untuk penciptaan 3D, menerima .jpg, .jpeg, .png serta AVIF/HEIF dengan penukaran automatik. Bekalkan 1 hingga 4 pandangan yang menunjukkan satu objek dari sudut berbeza; entri selepas 4 yang pertama tidak digunakan.

geometry_resolution

Resolusi geometri; 4k tidak tersedia untuk penjanaan daripada berbilang imej.

Lanjutan texture_prompt · texture_image_url · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker
0 / 600

Panduan tekstur yang dibekalkan sebagai prompt teks, yang memerlukan should_texture bernilai true.

Lepaskan fail, atau

Panduan tekstur yang dibekalkan sebagai imej 2D, yang memerlukan should_texture bernilai true.

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

Bilangan poligon yang dikehendaki untuk model output.

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/multi-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/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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 Multi Image to 3D

Membina semula satu objek daripada `image_urls`, yang menerima satu hingga empat gambar objek itu dari sudut berbeza. Tetapkan `topology` kepada quad atau triangle dan `target_polycount` dari 100 hingga 300000, kemudian pilih `geometry_resolution` standard atau 2k. Tekstur adalah pilihan melalui `should_texture`, dengan peta PBR, mod pose, rigging dan animasi tersedia. Output termasuk GLB dan format lain.

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
image_urlsdiperlukan images
Jenisurl[] · image
Set imej untuk penciptaan 3D, menerima .jpg, .jpeg, .png serta AVIF/HEIF dengan penukaran automatik. Bekalkan 1 hingga 4 pandangan yang menunjukkan satu objek dari sudut berbeza; entri selepas 4 yang pertama tidak digunakan.
topologypilihan
Jenisenum
Lalaitriangle
quadtriangle
Pilihan topologi model antara Triangle untuk perincian geometri dan Quad untuk kelicinan permukaan.
target_polycountpilihan
Jenisinteger
Lalai30000
100 – 300,000
Bilangan poligon yang dikehendaki untuk model output.
symmetry_modepilihan
Jenisenum
Lalaiauto
offautoon
Tetapan simetri yang digunakan semasa menjana model.
should_remeshpilihan
Jenisboolean
Lalaitrue
Sama ada menjalankan fasa penjeratan semula. Menetapkan ini kepada false menghasilkan jerat segi tiga; topology dan target_polycount kemudiannya diabaikan.
should_texturepilihan
Jenisboolean
Lalaitrue
Mendayakan atau melumpuhkan penjanaan tekstur.
enable_pbrpilihan
Jenisboolean
Lalaifalse
Suis output PBR tambahan, hanya tersedia apabila should_texture ditetapkan kepada true; menambahkan peta 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
Panduan tekstur yang dibekalkan sebagai prompt teks, yang memerlukan should_texture bernilai true.
texture_image_urlpilihan
Jenisurl · image
Panduan tekstur yang dibekalkan sebagai imej 2D, yang memerlukan should_texture bernilai true.
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; 4k tidak tersedia untuk penjanaan daripada berbilang imej.
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/multi-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_urls": [
      "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}Fail tekstur yang diwakili sebagai tatasusunan objek.
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/multi-image-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt