Lompat ke konten

Meshy 6 · Text to 3D

Integrasikan

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

Permintaan ini: $0,80 800 kredit API · ≈ ₽86,06 Jalankan di halaman ini

Dapatkan kunci API
Meshy Teks ke 3D #text-to-3d

Generator mesh Text-to-3D dengan mode pratinjau atau bertekstur, PBR opsional, rigging, dan animasi

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

Deskripsi objek yang akan direpresentasikan sebagai model 3D, dibatasi hingga 600 karakter.

Lanjutan texture_prompt · texture_image_url · mode · 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_rigging · enable_animation · enable_safety_checker
0 / 600

Arahkan tekstur dengan prompt teks tambahan dalam mode 'full'; mode lain tidak menggunakannya.

Jatuhkan file, atau

Gambar referensi 2D untuk pembuatan tekstur, hanya diterapkan dalam mode 'full'.

mode bawaan full

Mode pembuatan: 'preview' menghasilkan geometri tanpa tekstur, sedangkan 'full' menghasilkan model bertekstur dengan menggabungkan preview dan refine.

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 selama tahap geometri (preview) 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

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

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`.

Gunakan kembali seed ini bersama prompt yang tidak berubah untuk biasanya mereproduksi hasil sebelumnya.

POST /run/meshy/v6/text-to-3d?wait=20 estimasi harga → $0,80
# 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/v6/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.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 6 · Text to 3D

Membangun model 3D dari `prompt` teks hingga 600 karakter. `mode` memilih geometri tanpa tekstur (`preview`) atau hasil bertekstur (`full`). `model_type` dapat berupa standard, lowpoly, atau smart-topology, dan `target_polycount` berkisar antara 100 hingga 300000, dengan smart topology dibatasi hingga 15000. Model juga dapat menambahkan peta PBR, pose, rigging humanoid, dan prasetel animasi.

Parameter

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
≤ 600 karakter
Deskripsi objek yang akan direpresentasikan sebagai model 3D, dibatasi hingga 600 karakter.
modeopsional
Tipeenum
Bawaanfull
previewfull
Mode pembuatan: 'preview' menghasilkan geometri tanpa tekstur, sedangkan 'full' menghasilkan model bertekstur dengan menggabungkan preview dan refine.
seedopsional
Tipeinteger | null
Gunakan kembali seed ini bersama prompt yang tidak berubah untuk biasanya mereproduksi hasil sebelumnya.
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 selama tahap geometri (preview) 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.
should_remeshopsional
Tipeboolean
Bawaantrue
Lewati remeshing dan terima mesh segitiga mentah dengan menetapkan ini ke false; jika tidak, aktifkan fase remesh.
symmetry_modeopsional
Tipeenum
Bawaanauto
offautoon
Pengaturan simetri yang diterapkan saat membuat model.
enable_pbropsional
Tipeboolean
Bawaanfalse
Mengontrol pembuatan peta PBR 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'.
enable_prompt_expansionopsional
Tipeboolean
Bawaanfalse
Izinkan large language model memperkaya prompt dengan detail. Mengaktifkan ekspansi ini tidak mengubah makna prompt.
texture_promptopsional
Tipestring | null
≤ 600 karakter
Arahkan tekstur dengan prompt teks tambahan dalam mode 'full'; mode lain tidak menggunakannya.
texture_image_urlopsional
Tipeurl · image
Gambar referensi 2D untuk pembuatan tekstur, hanya diterapkan dalam mode 'full'.
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.
wajib

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/v6/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": 800,
    "usd": "0.80",
    "charged": 800,
    "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.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 | nullNilai seed yang digunakan selama pembuatan.
prompt
stringPrompt teks yang diberikan untuk pembuatan.
actual_prompt
string | nullPrompt yang benar-benar diterapkan pada pembuatan saat perluasan prompt diaktifkan.
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: Teks ke 3D

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