رفتن به محتوا

Meshy V7 Multi Image to 3D

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

شناسه مدل meshy/v7/multi-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/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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 از 1 تا 4 نمای یک شیء، با کنترل چندضلعی و توپولوژی

Meshy · 3D

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

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

ساخت درخواست

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

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

مجموعه تصاویر برای ساخت سه‌بعدی، با پذیرش .jpg، .jpeg، .png و AVIF/HEIF همراه با تبدیل خودکار. 1 تا 4 نما از یک شیء را از زوایای مختلف ارائه دهید؛ موارد پس از 4 مورد اول استفاده نمی‌شوند.

geometry_resolution

وضوح هندسه؛ 4k برای تولید از چند تصویر در دسترس نیست.

پیشرفته texture_prompt · texture_image_url · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker
0 / 600

راهنمای بافت‌دهی ارائه‌شده به‌صورت پرامپت متنی؛ should_texture باید true باشد.

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

راهنمای بافت‌دهی ارائه‌شده به‌صورت تصویر دوبعدی؛ should_texture باید true باشد.

topology پیش‌فرض triangle

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

symmetry_mode پیش‌فرض auto

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

pose_mode پیش‌فرض

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

پیش‌فرض 30000

تعداد چندضلعی مطلوب برای مدل خروجی.

پیش‌فرض 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/multi-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/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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 Multi Image to 3D

یک شیء را از `image_urls` که 1 تا 4 تصویر از زوایای مختلف می‌پذیرد، بازسازی می‌کند. `topology` را روی quad یا triangle و `target_polycount` را از 100 تا 300000 تنظیم کنید و `geometry_resolution` استاندارد یا 2k را انتخاب کنید. بافت‌گذاری با `should_texture` اختیاری است و نقشه‌های PBR، حالت ژست، ریگ و انیمیشن در دسترس‌اند. خروجی شامل GLB و قالب‌های دیگر است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlsالزامی images
نوعurl[] · image
مجموعه تصاویر برای ساخت سه‌بعدی، با پذیرش .jpg، .jpeg، .png و AVIF/HEIF همراه با تبدیل خودکار. 1 تا 4 نما از یک شیء را از زوایای مختلف ارائه دهید؛ موارد پس از 4 مورد اول استفاده نمی‌شوند.
topologyاختیاری
نوعenum
پیش‌فرضtriangle
quadtriangle
انتخاب توپولوژی مدل بین Triangle برای جزئیات هندسی و Quad برای نرمی سطح.
target_polycountاختیاری
نوعinteger
پیش‌فرض30000
۱۰۰ – ۳۰۰٬۰۰۰
تعداد چندضلعی مطلوب برای مدل خروجی.
symmetry_modeاختیاری
نوعenum
پیش‌فرضauto
offautoon
تنظیم تقارن اعمال‌شده هنگام تولید مدل.
should_remeshاختیاری
نوعboolean
پیش‌فرضtrue
مشخص می‌کند مرحله بازسازی مش اجرا شود یا نه. قرار دادن این مقدار روی false مش مثلثی تولید می‌کند؛ سپس topology و target_polycount نادیده گرفته می‌شوند.
should_textureاختیاری
نوعboolean
پیش‌فرضtrue
تولید بافت را فعال یا غیرفعال می‌کند.
enable_pbrاختیاری
نوعboolean
پیش‌فرضfalse
کلید خروجی اضافی PBR که فقط با should_texture برابر true در دسترس است؛ نقشه‌های فلزی، زبری و نرمال را در کنار رنگ پایه اضافه می‌کند.
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
≤ ۶۰۰ نویسه
راهنمای بافت‌دهی ارائه‌شده به‌صورت پرامپت متنی؛ should_texture باید true باشد.
texture_image_urlاختیاری
نوعurl · image
راهنمای بافت‌دهی ارائه‌شده به‌صورت تصویر دوبعدی؛ should_texture باید true باشد.
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
وضوح هندسه؛ 4k برای تولید از چند تصویر در دسترس نیست.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/multi-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_urls": [
      "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}فایل‌های بافت، نمایش‌داده‌شده به‌صورت آرایه‌ای از اشیا.
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/multi-image-to-3d.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt