Lompat ke konten

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

File seperti contoh: $1,20 1.200 kredit API · ≈ ₽129,10 file Anda diukur sebelum dijalankan Jalankan di halaman ini

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

Membangun satu model 3D dari 1 hingga 4 tampilan objek yang sama, dengan kontrol polygon dan topology

Meshy · 3D

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib image_urls
Jatuhkan file, atau

Kumpulan gambar untuk pembuatan 3D, menerima .jpg, .jpeg, .png, serta AVIF/HEIF dengan konversi otomatis. Berikan 1 hingga 4 tampilan yang menunjukkan satu objek dari sudut berbeda; entri setelah 4 pertama tidak digunakan.

geometry_resolution

Resolusi geometri; 4k tidak tersedia untuk pembuatan dari beberapa gambar.

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 diberikan sebagai prompt teks, yang mengharuskan should_texture bernilai true.

Jatuhkan file, atau

Panduan tekstur yang diberikan sebagai gambar 2D, yang mengharuskan should_texture bernilai true.

topology bawaan triangle

Pilihan topologi model antara Triangle untuk detail geometris dan Quad untuk kehalusan permukaan.

symmetry_mode bawaan auto

Pengaturan simetri yang diterapkan saat membuat model.

pose_mode bawaan

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

bawaan 30000

Jumlah poligon yang diinginkan untuk model output.

bawaan 1.7

Berikan perkiraan tinggi karakter dalam meter saat enable_rigging bernilai true; jika tidak, nilai ini tidak berpengaruh.

bawaan 92

ID preset animasi pustaka Meshy, dengan tindakan yang tersedia tercantum di https://docs.meshy.ai/en/api/animation-library. Validasi dan penggunaan hanya berlaku jika enable_animation bernilai true: nilai di luar [0, 696] ditolak dengan 422, dan "Idle" sesuai dengan `0`.

POST /run/meshy/v7/multi-image-to-3d?wait=20 estimasi 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Meshy V7 Multi Image to 3D

Merekonstruksi satu objek dari `image_urls`, yang menerima satu hingga empat gambar objek dari sudut berbeda. Atur `topology` ke quad atau triangle dan `target_polycount` dari 100 hingga 300000, lalu pilih `geometry_resolution` standard atau 2k. Tekstur bersifat opsional melalui `should_texture`, dengan peta PBR, pose mode, rigging, dan animasi yang tersedia. Output mencakup GLB dan format lain.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlswajib images
Tipeurl[] · image
Kumpulan gambar untuk pembuatan 3D, menerima .jpg, .jpeg, .png, serta AVIF/HEIF dengan konversi otomatis. Berikan 1 hingga 4 tampilan yang menunjukkan satu objek dari sudut berbeda; entri setelah 4 pertama tidak digunakan.
topologyopsional
Tipeenum
Bawaantriangle
quadtriangle
Pilihan topologi model antara Triangle untuk detail geometris dan Quad untuk kehalusan permukaan.
target_polycountopsional
Tipeinteger
Bawaan30000
100 – 300.000
Jumlah poligon yang diinginkan untuk model output.
symmetry_modeopsional
Tipeenum
Bawaanauto
offautoon
Pengaturan simetri yang diterapkan saat membuat model.
should_remeshopsional
Tipeboolean
Bawaantrue
Apakah fase remesh dijalankan. Menetapkan ini ke false menghasilkan mesh segitiga; topology dan target_polycount kemudian diabaikan.
should_textureopsional
Tipeboolean
Bawaantrue
Mengaktifkan atau menonaktifkan pembuatan tekstur.
enable_pbropsional
Tipeboolean
Bawaanfalse
Sakelar output PBR tambahan, hanya tersedia jika should_texture ditetapkan ke true; menambahkan peta metalik, roughness, dan normal bersama warna dasar.
is_a_t_poseopsional
Tipeboolean
Bawaanfalse
Sakelar pembuatan pose-T yang diaktifkan oleh true; sudah tidak digunakan dan digantikan oleh pose_mode.
pose_modeopsional
Tipeenum
Bawaan
a-poset-pose
Biarkan string kosong untuk tidak menentukan pose model yang dibuat, atau minta pose-A dengan 'a-pose' atau pose-T dengan 't-pose'.
texture_promptopsional
Tipestring | null
≤ 600 karakter
Panduan tekstur yang diberikan sebagai prompt teks, yang mengharuskan should_texture bernilai true.
texture_image_urlopsional
Tipeurl · image
Panduan tekstur yang diberikan sebagai gambar 2D, yang mengharuskan should_texture bernilai true.
enable_riggingopsional
Tipeboolean
Bawaanfalse
Rigging humanoid otomatis, paling efektif untuk model humanoid yang anggota tubuhnya dapat dibedakan dengan jelas. Mengaktifkannya akan memberi rigging pada model yang dibuat dan menyediakan animasi dasar untuk berjalan dan berlari.
rigging_height_metersopsional
Tipenumber
Bawaan1.7
> 0
Berikan perkiraan tinggi karakter dalam meter saat enable_rigging bernilai true; jika tidak, nilai ini tidak berpengaruh.
enable_animationopsional
Tipeboolean
Bawaanfalse
Apakah model yang telah diberi rigging menerima animasi preset, yang memerlukan enable_rigging bernilai true.
animation_action_idopsional
Tipeinteger
Bawaan92
ID preset animasi pustaka Meshy, dengan tindakan yang tersedia tercantum di https://docs.meshy.ai/en/api/animation-library. Validasi dan penggunaan hanya berlaku jika enable_animation bernilai true: nilai di luar [0, 696] ditolak dengan 422, dan "Idle" sesuai dengan `0`.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Sakelar pemeriksaan keamanan prapemrosesan: true menjadikan pemeriksaan keamanan input sebagai prasyarat pemrosesan.
geometry_resolutionopsional
Tipeenum
standard2k
Resolusi geometri; 4k tidak tersedia untuk pembuatan dari beberapa gambar.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
animation_glb
object {url, content_type, file_name, file_size} | nullHasil animasi yang berisi model 3D sebagai GLB; respons tidak menyertakan hasil ini kecuali enable_animation bernilai true.
animation_fbx
object {url, content_type, file_name, file_size} | nullHasil animasi yang berisi model 3D sebagai FBX; respons tidak menyertakan hasil ini kecuali enable_animation bernilai true.
model_glb
object {url, content_type, file_name, file_size}File GLB yang berisi objek 3D yang dibuat.
thumbnail
object {url, content_type, file_name, file_size} | nullThumbnail yang menampilkan pratinjau model yang dibuat.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Tautan ke model 3D dalam berbagai format.
texture_urls
array of object {base_color, metallic, normal, roughness}file tekstur yang direpresentasikan sebagai array objek.
seed
integer | nullSeed pembuatan, jika tersedia.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullHasil rigging yang dikirim sebagai file karakter GLB; tidak ada dalam respons kecuali enable_rigging bernilai true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullHasil rigging yang dikirim sebagai file karakter FBX; tidak ada dalam respons kecuali enable_rigging bernilai true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimasi berjalan dan berlari dasar, hanya disertakan jika enable_rigging bernilai true.
rig_task_id
string | nullPengenal tugas rigging; hanya disertakan jika enable_rigging bernilai true.

Model lainnya: Gambar ke 3D

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