رفتن به محتوا

Meshy 7.1 Text to 3D

یکپارچه‌سازی

شناسه مدل meshy/v7.1/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.1/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"

فایل‌هایی مانند نمونه: ⁨‎$۱٫۲۰⁩ ۱٬۲۰۰ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Meshy متن به 3D خروجی 4K #3d#text-to-3d#textures#pbr

تبدیل متن به 3D در Meshy 7.1 با حالت پیش‌نمایش یا کامل و وضوح هندسی حداکثر 4k

Meshy · 3D

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 88 / 600

توضیح شیئی که باید به‌صورت مدل سه‌بعدی نمایش داده شود، محدود به 600 نویسه.

mode پیش‌فرض full

حالت تولید: 'preview' هندسه را بدون بافت خروجی می‌دهد، درحالی‌که 'full' با ترکیب preview و refine مدل بافت‌دار تولید می‌کند.

پیشرفته texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · geometry_resolution · 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' با یک پرامپت متنی اضافی، بافت‌دهی را هدایت می‌کند؛ حالت‌های دیگر از آن استفاده نمی‌کنند.

یک فایل بیندازید، یا

تصویر مرجع دوبعدی برای تولید بافت، فقط در حالت 'full' اعمال می‌شود.

model_type پیش‌فرض standard

حالت مش سه‌بعدی: برای نتیجه low-poly با چندضلعی‌های تمیزتر 'lowpoly' را انتخاب کنید؛ در این حالت Meshy گزینه‌های topology، target_polycount و should_remesh را نادیده می‌گیرد. برای نتیجه معمولی با جزئیات زیاد 'standard' یا برای استفاده از Meshy-T2 در مرحله هندسه (preview) و تولید قطعات تمیز به‌صورت جداگانه از ابتدا، 'smart-topology' را انتخاب کنید.

topology پیش‌فرض triangle

انتخاب توپولوژی مدل بین Triangle برای جزئیات هندسی و Quad برای نرمی سطح.

symmetry_mode پیش‌فرض auto

تنظیم تقارن اعمال‌شده هنگام تولید مدل.

pose_mode پیش‌فرض

رشته را خالی بگذارید تا حالت ژست مدل تولیدشده مشخص نشود، یا با 'a-pose' ژست A و با 't-pose' ژست T درخواست کنید.

geometry_resolution

وضوح هندسه؛ 4k به Meshy-7.1 نیاز دارد.

پیش‌فرض 30000

هدف تعداد چندضلعی، که وقتی model_type برابر 'smart-topology' است به 15,000 محدود می‌شود. حذف هدف در این حالت، مقدار پیش‌فرض پایین‌تر Meshy یعنی 4,000 را انتخاب می‌کند.

پیش‌فرض 1.7

وقتی enable_rigging برابر true است، ارتفاع تخمینی شخصیت را برحسب متر ارائه دهید؛ در غیر این صورت این مقدار اثری ندارد.

پیش‌فرض 92

شناسه انیمیشن پیش‌تنظیم‌شده کتابخانه Meshy؛ کنش‌های موجود در https://docs.meshy.ai/en/api/animation-library فهرست شده‌اند. اعتبارسنجی و استفاده فقط وقتی اعمال می‌شود که enable_animation برابر true باشد: مقادیر خارج از [0, 696] با 422 رد می‌شوند و "Idle" متناظر با `0` است.

این بذر را همراه با پرامپت بدون تغییر دوباره استفاده کنید تا معمولاً نتیجه قبلی بازتولید شود.

POST /run/meshy/v7.1/text-to-3d?wait=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.1/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"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Meshy 7.1 Text to 3D

یک مدل سه‌بعدی را از `prompt` متنی حداکثر 600 نویسه‌ای تولید می‌کند. `mode` هندسه بدون بافت یا نتیجه بافت‌دار را برمی‌گرداند و `geometry_resolution` امکان انتخاب standard، 2k یا 4k را می‌دهد. با `model_type` یکی از standard، lowpoly یا smart-topology را انتخاب کنید، `target_polycount` را از 100 تا 300000 تنظیم کنید و در صورت نیاز PBR، گسترش پرامپت، ریگ‌بندی و انیمیشن را فعال کنید.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۶۰۰ نویسه
توضیح شیئی که باید به‌صورت مدل سه‌بعدی نمایش داده شود، محدود به 600 نویسه.
modeاختیاری
نوعenum
پیش‌فرضfull
previewfull
حالت تولید: 'preview' هندسه را بدون بافت خروجی می‌دهد، درحالی‌که 'full' با ترکیب preview و refine مدل بافت‌دار تولید می‌کند.
seedاختیاری
نوعinteger | null
این بذر را همراه با پرامپت بدون تغییر دوباره استفاده کنید تا معمولاً نتیجه قبلی بازتولید شود.
model_typeاختیاری
نوعenum
پیش‌فرضstandard
standardlowpolysmart-topology
حالت مش سه‌بعدی: برای نتیجه low-poly با چندضلعی‌های تمیزتر 'lowpoly' را انتخاب کنید؛ در این حالت Meshy گزینه‌های topology، target_polycount و should_remesh را نادیده می‌گیرد. برای نتیجه معمولی با جزئیات زیاد 'standard' یا برای استفاده از Meshy-T2 در مرحله هندسه (preview) و تولید قطعات تمیز به‌صورت جداگانه از ابتدا، 'smart-topology' را انتخاب کنید.
topologyاختیاری
نوعenum
پیش‌فرضtriangle
quadtriangle
انتخاب توپولوژی مدل بین Triangle برای جزئیات هندسی و Quad برای نرمی سطح.
target_polycountاختیاری
نوعinteger
پیش‌فرض30000
۱۰۰ – ۳۰۰٬۰۰۰
هدف تعداد چندضلعی، که وقتی model_type برابر 'smart-topology' است به 15,000 محدود می‌شود. حذف هدف در این حالت، مقدار پیش‌فرض پایین‌تر Meshy یعنی 4,000 را انتخاب می‌کند.
should_remeshاختیاری
نوعboolean
پیش‌فرضtrue
با قرار دادن این مقدار روی false، بازسازی مش را رد کرده و مش مثلثی خام را دریافت کنید؛ در غیر این صورت مرحله بازسازی مش فعال می‌شود.
symmetry_modeاختیاری
نوعenum
پیش‌فرضauto
offautoon
تنظیم تقارن اعمال‌شده هنگام تولید مدل.
enable_pbrاختیاری
نوعboolean
پیش‌فرضfalse
تولید نقشه‌های PBR فلزی، زبری و نرمال را در کنار رنگ پایه کنترل می‌کند.
is_a_t_poseاختیاری
نوعboolean
پیش‌فرضfalse
کلید تولید T-pose که با true فعال می‌شود؛ استفاده از آن منسوخ شده و pose_mode جایگزینش است.
pose_modeاختیاری
نوعenum
پیش‌فرض
a-poset-pose
رشته را خالی بگذارید تا حالت ژست مدل تولیدشده مشخص نشود، یا با 'a-pose' ژست A و با 't-pose' ژست T درخواست کنید.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضfalse
به مدل زبانی بزرگ اجازه می‌دهد پرامپت را با جزئیات غنی کند. فعال‌کردن این گسترش معنای پرامپت را تغییر نمی‌دهد.
texture_promptاختیاری
نوعstring | null
≤ ۶۰۰ نویسه
در حالت 'full' با یک پرامپت متنی اضافی، بافت‌دهی را هدایت می‌کند؛ حالت‌های دیگر از آن استفاده نمی‌کنند.
texture_image_urlاختیاری
نوعurl · image
تصویر مرجع دوبعدی برای تولید بافت، فقط در حالت 'full' اعمال می‌شود.
enable_riggingاختیاری
نوعboolean
پیش‌فرضfalse
ریگ‌بندی خودکار انسان‌نما، که برای مدل‌های انسان‌نما با اندام‌های کاملاً متمایز مؤثرتر است. فعال‌کردن آن مدل تولیدشده را ریگ‌بندی کرده و انیمیشن‌های پایه راه‌رفتن و دویدن را ارائه می‌دهد.
rigging_height_metersاختیاری
نوعnumber
پیش‌فرض1.7
> ۰
وقتی enable_rigging برابر true است، ارتفاع تخمینی شخصیت را برحسب متر ارائه دهید؛ در غیر این صورت این مقدار اثری ندارد.
enable_animationاختیاری
نوعboolean
پیش‌فرضfalse
مشخص می‌کند مدل ریگ‌شده انیمیشن پیش‌تنظیم‌شده دریافت کند یا نه؛ برای آن، enable_rigging باید true باشد.
animation_action_idاختیاری
نوعinteger
پیش‌فرض92
شناسه انیمیشن پیش‌تنظیم‌شده کتابخانه Meshy؛ کنش‌های موجود در https://docs.meshy.ai/en/api/animation-library فهرست شده‌اند. اعتبارسنجی و استفاده فقط وقتی اعمال می‌شود که enable_animation برابر true باشد: مقادیر خارج از [0, 696] با 422 رد می‌شوند و "Idle" متناظر با `0` است.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
کلید بررسی ایمنی پیش‌پردازش: مقدار true بررسی ایمنی ورودی را پیش‌شرط پردازش می‌کند.
geometry_resolutionاختیاری
نوعenum
standard2k4k
وضوح هندسه؛ 4k به Meshy-7.1 نیاز دارد.
ultra_modeاختیاری
نوعboolean
پیش‌فرضfalse
گزینه منسوخ‌شده که geometry_resolution جایگزین آن شده و در صورت ارائه هر دو، برنده است؛ به‌جای آن از geometry_resolution='2k' استفاده کنید.
الزامی

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7.1/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"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
animation_glb
object {url, content_type, file_name, file_size} | nullنتیجه انیمیشن شامل مدل سه‌بعدی به‌صورت GLB؛ پاسخ این نتیجه را مگر وقتی enable_animation برابر true باشد حذف می‌کند.
animation_fbx
object {url, content_type, file_name, file_size} | nullنتیجه انیمیشن شامل مدل سه‌بعدی به‌صورت FBX؛ پاسخ این نتیجه را مگر وقتی enable_animation برابر true باشد حذف می‌کند.
model_glb
object {url, content_type, file_name, file_size}فایل GLB حاوی شیء سه‌بعدی تولیدشده.
thumbnail
object {url, content_type, file_name, file_size} | nullتصویر بندانگشتی برای پیش‌نمایش مدل تولیدشده.
model_urls
object {glb, fbx, obj, usdz, blend, stl}پیوندهای مدل سه‌بعدی در قالب‌های مختلف.
texture_urls
array of object {base_color, metallic, normal, roughness}فایل‌های بافت، نمایش‌داده‌شده به‌صورت آرایه‌ای از اشیا.
seed
integer | nullمقدار Seed استفاده‌شده هنگام تولید.
prompt
stringپرامپت متنی ارائه‌شده برای تولید.
actual_prompt
string | nullمتن پرامپتی که هنگام فعال‌بودن گسترش پرامپت واقعاً برای تولید اعمال شده است.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullنتیجه ریگ‌بندی به‌صورت فایل شخصیت GLB؛ مگر وقتی enable_rigging برابر true باشد، در پاسخ وجود ندارد.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullنتیجه ریگ‌بندی به‌صورت فایل شخصیت FBX؛ مگر وقتی enable_rigging برابر true باشد، در پاسخ وجود ندارد.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullانیمیشن‌های پایه راه‌رفتن و دویدن، فقط وقتی enable_rigging برابر true باشد درج می‌شوند.
rig_task_id
string | nullشناسه وظیفه ریگ‌بندی؛ فقط وقتی enable_rigging برابر true باشد درج می‌شود.

مدل‌های بیشتر: متن به 3D

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/meshy/v7.1/text-to-3d.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt