İçeriğe geç

Meshy V7 Text to 3D

Entegre et

Model kimliği meshy/v7/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Metinden 3D'ye #stylized#transform

Meshy 7 ile metinden 3D: ön izleme veya tam mod, 2k geometri, PBR, iskelet oluşturma ve animasyon seçenekleri

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 88 / 600

3D model olarak temsil edilecek nesnenin 600 karakterle sınırlı açıklaması.

mode varsayılan full

Üretim modu: 'preview' dokusuz geometri, 'full' ise preview ve refine'ı birleştirerek dokulu model üretir.

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 · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode
0 / 600

'full' modunda ek bir metin istemiyle dokulandırmayı yönlendirir; diğer modlar bunu kullanmaz.

Dosyayı bırakın veya

Yalnızca 'full' modunda uygulanan doku üretimi için 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' veya geometri (preview) adımında Meshy-T2 kullanıp başlangıçtan itibaren ayrı oluşturulan temiz parçalar elde etmek 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 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

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.

Daha önceki bir sonucu genellikle yeniden üretmek için bu tohumu değişmeden kalan istemle birlikte yeniden kullanın.

POST /run/meshy/v7/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

İsteğe bağlı `enable_prompt_expansion` ile en fazla 600 karakterlik `prompt` üzerinden 3D model üretir. `mode`, dokusuz geometri veya dokulu model döndürür. `model_type` ile standard, lowpoly veya smart-topology seçin, `target_polycount` değerini 100 ile 300000 arasında ayarlayın ve standard veya 2k `geometry_resolution` seçin. Humanoid karakterlere iskelet ve animasyon ön ayarları eklenebilir.

Parametreler

AdTür Varsayılanİzin verilen Açıklama
promptgerekli
Türstring
≤ 600 karakter
3D model olarak temsil edilecek nesnenin 600 karakterle sınırlı açıklaması.
modeisteğe bağlı
Türenum
Varsayılanfull
previewfull
Üretim modu: 'preview' dokusuz geometri, 'full' ise preview ve refine'ı birleştirerek dokulu model üretir.
seedisteğe bağlı
Türinteger | null
Daha önceki bir sonucu genellikle yeniden üretmek için bu tohumu değişmeden kalan istemle birlikte yeniden kullanın.
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' veya geometri (preview) adımında Meshy-T2 kullanıp başlangıçtan itibaren ayrı oluşturulan temiz parçalar elde etmek 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.
should_remeshisteğe bağlı
Türboolean
Varsayılantrue
Bunu false olarak ayarlayarak yeniden mesh oluşturmayı atlayın ve ham üçgen mesh'i alın; aksi halde yeniden mesh oluşturma aşamasını etkinleştirin.
symmetry_modeisteğe bağlı
Türenum
Varsayılanauto
offautoon
Model oluşturulurken uygulanan simetri ayarı.
enable_pbristeğe bağlı
Türboolean
Varsayılanfalse
Temel rengin yanında metallic, roughness ve normal PBR haritalarının üretimini denetler.
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.
enable_prompt_expansionisteğe bağlı
Türboolean
Varsayılanfalse
Büyük dil modelinin istemi ayrıntılarla zenginleştirmesine izin verir. Bu genişletmenin etkinleştirilmesi istemin anlamını değiştirmez.
texture_promptisteğe bağlı
Türstring | null
≤ 600 karakter
'full' modunda ek bir metin istemiyle dokulandırmayı yönlendirir; diğer modlar bunu kullanmaz.
texture_image_urlisteğe bağlı
Türurl · image
Yalnızca 'full' modunda uygulanan doku üretimi için 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

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/text-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": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "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 | nullÜretim sırasında kullanılan seed değeri.
prompt
stringÜretim için sağlanan metin istemi.
actual_prompt
string | nullİstem genişletme etkinleştirildiğinde üretime gerçekten uygulanan istem metni.
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: Metinden 3D'ye

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