Lompat ke konten

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.ru/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.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

Mengubah satu gambar menjadi mesh 3D dengan opsi geometri 2k, PBR, rigging, dan animasi opsional

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_url
Jatuhkan file, atau

Berikan gambar sumber untuk pembuatan 3D melalui URL atau URI data base64, menggunakan .jpg, .jpeg, .png, AVIF, atau HEIF. Konversi otomatis menangani input AVIF dan HEIF.

geometry_resolution

Resolusi geometri mesh; opsi Meshy-7 yang didukung adalah 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

Instruksi teks yang mengarahkan pembuatan tekstur.

Jatuhkan file, atau

Gambar referensi 2D yang mengarahkan pembuatan tekstur.

model_type bawaan standard

Mode mesh 3D: pilih 'lowpoly' untuk hasil low-poly yang dioptimalkan dengan poligon lebih rapi; dalam mode ini Meshy mengabaikan topology, target_polycount, dan should_remesh. Untuk hasil konvensional dengan detail tinggi, pilih 'standard', atau pilih 'smart-topology' untuk menggunakan Meshy-T2 dan mendapatkan bagian rapi yang dibuat secara terpisah sejak awal.

topology bawaan triangle

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

symmetry_mode bawaan auto

Pilih apakah pembuatan model memaksa simetri dengan On, meniadakannya dengan Off, atau menentukannya secara otomatis dengan Auto.

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

Target jumlah poligon, dibatasi hingga 15,000 saat model_type bernilai 'smart-topology'. Jika target dihilangkan dalam mode tersebut, bawaan Meshy yang lebih rendah, yaitu 4,000, akan dipilih.

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

Membuat model 3D dari satu gambar di `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 dapat dinonaktifkan dengan `should_texture`, sedangkan peta PBR, mode pose, rigging humanoid, dan prasetel animasi bersifat opsional.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
Berikan gambar sumber untuk pembuatan 3D melalui URL atau URI data base64, menggunakan .jpg, .jpeg, .png, AVIF, atau HEIF. Konversi otomatis menangani input AVIF dan HEIF.
model_typeopsional
Tipeenum
Bawaanstandard
standardlowpolysmart-topology
Mode mesh 3D: pilih 'lowpoly' untuk hasil low-poly yang dioptimalkan dengan poligon lebih rapi; dalam mode ini Meshy mengabaikan topology, target_polycount, dan should_remesh. Untuk hasil konvensional dengan detail tinggi, pilih 'standard', atau pilih 'smart-topology' untuk menggunakan Meshy-T2 dan mendapatkan bagian rapi yang dibuat secara terpisah sejak awal.
topologyopsional
Tipeenum
Bawaantriangle
quadtriangle
Pilihan topologi model antara Triangle untuk detail geometris dan Quad untuk kehalusan permukaan.
target_polycountopsional
Tipeinteger
Bawaan30000
100 – 300.000
Target jumlah poligon, dibatasi hingga 15,000 saat model_type bernilai 'smart-topology'. Jika target dihilangkan dalam mode tersebut, bawaan Meshy yang lebih rendah, yaitu 4,000, akan dipilih.
symmetry_modeopsional
Tipeenum
Bawaanauto
offautoon
Pilih apakah pembuatan model memaksa simetri dengan On, meniadakannya dengan Off, atau menentukannya secara otomatis dengan Auto.
should_remeshopsional
Tipeboolean
Bawaantrue
Mengaktifkan atau menonaktifkan tahap remeshing.
should_textureopsional
Tipeboolean
Bawaantrue
Mengaktifkan atau menonaktifkan pembuatan tekstur.
enable_pbropsional
Tipeboolean
Bawaanfalse
Menambahkan peta PBR untuk 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
Instruksi teks yang mengarahkan pembuatan tekstur.
texture_image_urlopsional
Tipeurl · image
Gambar referensi 2D yang mengarahkan pembuatan tekstur.
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 mesh; opsi Meshy-7 yang didukung adalah standard dan 2k.
ultra_modeopsional
Tipeboolean
Bawaanfalse
Opsi yang sudah tidak digunakan dan digantikan oleh geometry_resolution, yang berlaku jika keduanya diberikan; gunakan geometry_resolution='2k'.
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/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.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}Objek file tekstur dalam array yang disusun agar sesuai dengan Meshy API.
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/image-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt