رفتن به محتوا

Meshy V7 Image to 3D

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

شناسه مدل 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"

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

دریافت کلید API
Meshy تصویر به 3D #stylized#transform

تبدیل یک تصویر به مش 3D با گزینه هندسی 2k، PBR، ریگ و انیمیشن اختیاری

Meshy · 3D

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

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

ساخت درخواست

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

•الزامی image_url
یک فایل بیندازید، یا

تصویر منبع را برای ساخت سه‌بعدی با URL یا URI داده base64 ارائه دهید؛ قالب‌های .jpg، .jpeg، .png، AVIF یا HEIF پذیرفته می‌شوند. تبدیل خودکار ورودی‌های AVIF و HEIF را مدیریت می‌کند.

geometry_resolution

وضوح هندسه مش؛ گزینه‌های Meshy-7 پشتیبانی‌شده standard و 2k هستند.

پیشرفته 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

دستورهای متنی برای هدایت تولید بافت.

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

تصویر مرجع دوبعدی برای هدایت تولید بافت.

model_type پیش‌فرض standard

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

topology پیش‌فرض triangle

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

symmetry_mode پیش‌فرض auto

مشخص کنید تولید مدل با On تقارن را اجباری کند، با Off آن را حذف کند یا با Auto به‌صورت خودکار تصمیم بگیرد.

pose_mode پیش‌فرض

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

پیش‌فرض 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/image-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/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"

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

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

درباره Meshy V7 Image to 3D

از یک تصویر در `image_url` (JPG، PNG، AVIF یا HEIF) مدل سه‌بعدی می‌سازد. `model_type`، standard، lowpoly یا smart-topology را انتخاب می‌کند و `target_polycount` مقادیر 100 تا 300000 را می‌پذیرد. `geometry_resolution` گزینه‌های standard یا 2k را ارائه می‌دهد. با `should_texture` می‌توان بافت‌گذاری را خاموش کرد و نقشه‌های PBR، حالت ژست، ریگ انسان‌نما و تنظیم انیمیشن اختیاری هستند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
تصویر منبع را برای ساخت سه‌بعدی با URL یا URI داده base64 ارائه دهید؛ قالب‌های .jpg، .jpeg، .png، AVIF یا HEIF پذیرفته می‌شوند. تبدیل خودکار ورودی‌های AVIF و HEIF را مدیریت می‌کند.
model_typeاختیاری
نوعenum
پیش‌فرضstandard
standardlowpolysmart-topology
حالت مش سه‌بعدی: برای نتیجه low-poly با چندضلعی‌های تمیزتر، 'lowpoly' را انتخاب کنید؛ در این حالت Meshy گزینه‌های topology، target_polycount و should_remesh را نادیده می‌گیرد. برای نتیجه معمولی با جزئیات زیاد 'standard' یا برای استفاده از Meshy-T2 و تولید قطعات تمیز به‌صورت جداگانه از ابتدا، 'smart-topology' را انتخاب کنید.
topologyاختیاری
نوعenum
پیش‌فرضtriangle
quadtriangle
انتخاب توپولوژی مدل بین Triangle برای جزئیات هندسی و Quad برای نرمی سطح.
target_polycountاختیاری
نوعinteger
پیش‌فرض30000
۱۰۰ – ۳۰۰٬۰۰۰
هدف تعداد چندضلعی، که وقتی model_type برابر 'smart-topology' است به 15,000 محدود می‌شود. حذف هدف در این حالت، مقدار پیش‌فرض پایین‌تر Meshy یعنی 4,000 را انتخاب می‌کند.
symmetry_modeاختیاری
نوعenum
پیش‌فرضauto
offautoon
مشخص کنید تولید مدل با On تقارن را اجباری کند، با Off آن را حذف کند یا با Auto به‌صورت خودکار تصمیم بگیرد.
should_remeshاختیاری
نوعboolean
پیش‌فرضtrue
مرحله بازسازی مش را فعال یا غیرفعال می‌کند.
should_textureاختیاری
نوعboolean
پیش‌فرضtrue
تولید بافت را فعال یا غیرفعال می‌کند.
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 درخواست کنید.
texture_promptاختیاری
نوعstring | null
≤ ۶۰۰ نویسه
دستورهای متنی برای هدایت تولید بافت.
texture_image_urlاختیاری
نوعurl · image
تصویر مرجع دوبعدی برای هدایت تولید بافت.
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
standard2k
وضوح هندسه مش؛ گزینه‌های Meshy-7 پشتیبانی‌شده standard و 2k هستند.
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/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"
  }
}
فایل‌های شما، انتخاب شماهر 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}اشیای فایل بافت در آرایه‌ای مطابق ساختار Meshy API.
seed
integer | 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/image-to-3d.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt