İçeriğe geç

Meshy V7 Multi Image to 3D

Entegre et

Model kimliği 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"

Örnekteki gibi dosyalar: $1,20 1.200 API kredisi dosyalarınız çalıştırmadan önce ölçülür Bu sayfada çalıştır

API anahtarı al
Meshy Görselden 3D'ye #stylized#transform

Poligon ve topoloji denetimleriyle aynı nesnenin 1 ile 4 görünümünden tek bir 3D model oluşturur

Meshy · 3D

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli image_urls
Dosyayı bırakın veya

3D oluşturma için görsel kümesi; .jpg, .jpeg, .png ve otomatik dönüştürmeyle AVIF/HEIF kabul edilir. Tek bir nesneyi farklı açılardan gösteren 1 ila 4 görünüm sağlayın; ilk 4'ten sonraki girdiler kullanılmaz.

geometry_resolution

Geometrinin çözünürlüğü; birden fazla görselden üretimde 4k kullanılamaz.

Gelişmiş 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

should_texture değerinin true olmasını gerektiren, metin istemi olarak sağlanan dokulandırma yönlendirmesi.

Dosyayı bırakın veya

should_texture değerinin true olmasını gerektiren, 2D görsel olarak sağlanan dokulandırma yönlendirmesi.

topology varsayılan triangle

Geometrik ayrıntı için Triangle ile yüzey pürüzsüzlüğü için Quad arasındaki model topolojisi seçimi.

symmetry_mode varsayılan auto

Model oluşturulurken uygulanan simetri ayarı.

pose_mode varsayılan

Üretilen modelin pozunu belirtmemek için dizeyi boş bırakın; 'a-pose' ile A-pose veya 't-pose' ile T-pose isteyin.

varsayılan 30000

Çıktı modelinde istenen poligon sayısı.

varsayılan 1.7

enable_rigging true olduğunda metre cinsinden tahmini karakter yüksekliği sağlayın; aksi halde bu değer etkisizdir.

varsayılan 92

Meshy kitaplığındaki animasyon ön ayarı kimliği; kullanılabilir eylemler https://docs.meshy.ai/en/api/animation-library adresinde listelenir. Doğrulama ve kullanım yalnızca enable_animation true olduğunda geçerlidir: [0, 696] dışındaki değerler 422 ile reddedilir ve "Idle" değeri `0` ile eşleşir.

POST /run/meshy/v7/multi-image-to-3d?wait=20 fiyat → $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"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Meshy V7 Multi Image to 3D hakkında

Farklı açılardan çekilmiş bir ila dört fotoğraf içeren `image_urls` ile tek bir nesneyi yeniden oluşturur. `topology` değerini quad veya triangle, `target_polycount` değerini 100 ile 300000 arasında ayarlayın ve standard veya 2k `geometry_resolution` seçin. Dokulandırma `should_texture` ile isteğe bağlıdır; PBR haritaları, poz modu, iskelet oluşturma ve animasyon kullanılabilir. Çıktılar arasında GLB ve diğer biçimler bulunur.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlsgerekli images
Türurl[] · image
3D oluşturma için görsel kümesi; .jpg, .jpeg, .png ve otomatik dönüştürmeyle AVIF/HEIF kabul edilir. Tek bir nesneyi farklı açılardan gösteren 1 ila 4 görünüm sağlayın; ilk 4'ten sonraki girdiler kullanılmaz.
topologyisteğe bağlı
Türenum
Varsayılantriangle
quadtriangle
Geometrik ayrıntı için Triangle ile yüzey pürüzsüzlüğü için Quad arasındaki model topolojisi seçimi.
target_polycountisteğe bağlı
Türinteger
Varsayılan30000
100 – 300.000
Çıktı modelinde istenen poligon sayısı.
symmetry_modeisteğe bağlı
Türenum
Varsayılanauto
offautoon
Model oluşturulurken uygulanan simetri ayarı.
should_remeshisteğe bağlı
Türboolean
Varsayılantrue
Yeniden mesh oluşturma aşamasının çalıştırılıp çalıştırılmayacağı. Bunu false olarak ayarlamak üçgen mesh üretir; ardından topology ve target_polycount yok sayılır.
should_textureisteğe bağlı
Türboolean
Varsayılantrue
Doku üretimini etkinleştirir veya devre dışı bırakır.
enable_pbristeğe bağlı
Türboolean
Varsayılanfalse
Yalnızca should_texture true olduğunda kullanılabilen ek PBR çıktı anahtarı; temel rengin yanında metallic, roughness ve normal haritaları ekler.
is_a_t_poseisteğe bağlı
Türboolean
Varsayılanfalse
true ile etkinleştirilen T-pose üretim anahtarı; pose_mode lehine kullanımdan kaldırılmıştır.
pose_modeisteğe bağlı
Türenum
Varsayılan
a-poset-pose
Üretilen modelin pozunu belirtmemek için dizeyi boş bırakın; 'a-pose' ile A-pose veya 't-pose' ile T-pose isteyin.
texture_promptisteğe bağlı
Türstring | null
≤ 600 karakter
should_texture değerinin true olmasını gerektiren, metin istemi olarak sağlanan dokulandırma yönlendirmesi.
texture_image_urlisteğe bağlı
Türurl · image
should_texture değerinin true olmasını gerektiren, 2D görsel olarak sağlanan dokulandırma yönlendirmesi.
enable_riggingisteğe bağlı
Türboolean
Varsayılanfalse
İnsansı modellerde ve uzuvları açıkça ayırt edilebilen karakterlerde en etkili otomatik insansı rig. Etkinleştirildiğinde üretilen modele rig uygular ve yürüme ile koşma için temel animasyonlar sağlar.
rigging_height_metersisteğe bağlı
Türnumber
Varsayılan1.7
> 0
enable_rigging true olduğunda metre cinsinden tahmini karakter yüksekliği sağlayın; aksi halde bu değer etkisizdir.
enable_animationisteğe bağlı
Türboolean
Varsayılanfalse
Rig uygulanmış modelin, enable_rigging değerinin true olmasını gerektiren bir ön ayar animasyonu alıp almayacağı.
animation_action_idisteğe bağlı
Türinteger
Varsayılan92
Meshy kitaplığındaki animasyon ön ayarı kimliği; kullanılabilir eylemler https://docs.meshy.ai/en/api/animation-library adresinde listelenir. Doğrulama ve kullanım yalnızca enable_animation true olduğunda geçerlidir: [0, 696] dışındaki değerler 422 ile reddedilir ve "Idle" değeri `0` ile eşleşir.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Ön işleme güvenlik kontrolü anahtarı: true, girdi güvenlik kontrolünü işlemenin ön koşulu yapar.
geometry_resolutionisteğe bağlı
Türenum
standard2k
Geometrinin çözünürlüğü; birden fazla görselden üretimde 4k kullanılamaz.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
animation_glb
object {url, content_type, file_name, file_size} | null3D modeli GLB olarak içeren animasyon sonucu; enable_animation true olmadıkça yanıt bu sonucu içermez.
animation_fbx
object {url, content_type, file_name, file_size} | null3D modeli FBX olarak içeren animasyon sonucu; enable_animation true olmadıkça yanıt bu sonucu içermez.
model_glb
object {url, content_type, file_name, file_size}Üretilen 3D nesneyi içeren GLB dosyası.
thumbnail
object {url, content_type, file_name, file_size} | nullÜretilen modelin önizlemesini gösteren küçük görsel.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Çeşitli biçimlerdeki 3D model bağlantıları.
texture_urls
array of object {base_color, metallic, normal, roughness}Nesne dizisi olarak temsil edilen doku dosyaları.
seed
integer | nullVarsa üretim tohumu.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullGLB karakter dosyası olarak sunulan rig sonucu; enable_rigging true olmadıkça yanıtta bulunmaz.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullFBX karakter dosyası olarak sunulan rig sonucu; enable_rigging true olmadıkça yanıtta bulunmaz.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullYalnızca enable_rigging true olduğunda dahil edilen temel yürüme ve koşma animasyonları.
rig_task_id
string | nullRig işleminin tanımlayıcısı; yalnızca enable_rigging true olduğunda dahil edilir.

Daha fazla model: Görselden 3D'ye

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/meshy/v7/multi-image-to-3d.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt