İçeriğe geç

Meshy V7 Image to 3D

Entegre et

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

Ö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

2k geometri seçeneği, isteğe bağlı PBR, iskelet oluşturma ve animasyonla tek görseli 3D poligon ağına dönüştürür

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_url
Dosyayı bırakın veya

.jpg, .jpeg, .png, AVIF veya HEIF kullanan URL ya da base64 veri URI'siyle 3D oluşturma için kaynak görseli sağlayın. AVIF ve HEIF girdileri otomatik olarak dönüştürülür.

geometry_resolution

Mesh geometrisi çözünürlüğü; desteklenen Meshy-7 seçenekleri standard ve 2k'dir.

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

Doku üretimini yönlendiren metin talimatları.

Dosyayı bırakın veya

Doku üretimini yönlendiren 2D referans görseli.

model_type varsayılan standard

3D mesh modu: daha temiz poligonlar için optimize edilmiş düşük poligonlu sonuç için 'lowpoly' seçin; bu modda Meshy topology, target_polycount ve should_remesh değerlerini yok sayar. Geleneksel yüksek ayrıntılı sonuç için 'standard', başlangıçtan itibaren ayrı oluşturulan temiz parçalar elde etmek üzere Meshy-T2 kullanmak için 'smart-topology' seçin.

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 üretiminin On ile simetriyi zorlamasını, Off ile simetriyi kaldırmasını veya Auto ile otomatik karar vermesini seçin.

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

model_type 'smart-topology' olduğunda 15,000 ile sınırlanan poligon sayısı hedefi. Bu modda hedef belirtilmezse Meshy'nin daha düşük varsayılanı olan 4,000 seçilir.

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

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

`image_url` içindeki tek bir görselden 3D model oluşturur (JPG, PNG, AVIF veya HEIF). `model_type`, standard, lowpoly veya smart-topology seçeneklerinden birini seçer; `target_polycount` 100 ile 300000 arasındadır. `geometry_resolution`, standard veya 2k seçeneklerini sunar. `should_texture` ile dokulandırma kapatılabilir; PBR haritaları, poz modu, humanoid iskelet oluşturma ve animasyon ön ayarı isteğe bağlıdır.

Parametreler

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

AdTür Varsayılanİzin verilen Açıklama
image_urlgerekli image
Türurl · image
.jpg, .jpeg, .png, AVIF veya HEIF kullanan URL ya da base64 veri URI'siyle 3D oluşturma için kaynak görseli sağlayın. AVIF ve HEIF girdileri otomatik olarak dönüştürülür.
model_typeisteğe bağlı
Türenum
Varsayılanstandard
standardlowpolysmart-topology
3D mesh modu: daha temiz poligonlar için optimize edilmiş düşük poligonlu sonuç için 'lowpoly' seçin; bu modda Meshy topology, target_polycount ve should_remesh değerlerini yok sayar. Geleneksel yüksek ayrıntılı sonuç için 'standard', başlangıçtan itibaren ayrı oluşturulan temiz parçalar elde etmek üzere Meshy-T2 kullanmak için 'smart-topology' seçin.
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
model_type 'smart-topology' olduğunda 15,000 ile sınırlanan poligon sayısı hedefi. Bu modda hedef belirtilmezse Meshy'nin daha düşük varsayılanı olan 4,000 seçilir.
symmetry_modeisteğe bağlı
Türenum
Varsayılanauto
offautoon
Model üretiminin On ile simetriyi zorlamasını, Off ile simetriyi kaldırmasını veya Auto ile otomatik karar vermesini seçin.
should_remeshisteğe bağlı
Türboolean
Varsayılantrue
Yeniden mesh oluşturma aşamasını etkinleştirir veya devre dışı bırakı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
Temel rengin yanında metallic, roughness ve normal için PBR 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
Doku üretimini yönlendiren metin talimatları.
texture_image_urlisteğe bağlı
Türurl · image
Doku üretimini yönlendiren 2D referans görseli.
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
Mesh geometrisi çözünürlüğü; desteklenen Meshy-7 seçenekleri standard ve 2k'dir.
ultra_modeisteğe bağlı
Türboolean
Varsayılanfalse
geometry_resolution ile değiştirilen kullanımdan kaldırılmış seçenek; ikisi de sağlanırsa geometry_resolution önceliklidir. Bunun yerine geometry_resolution='2k' kullanın.
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/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"
  }
}
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}Meshy API'ye uyacak şekilde yapılandırılmış dizideki doku dosyası nesneleri.
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/image-to-3d.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt