تخطّي إلى المحتوى

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

ملفات مثل المثال: ⁨‏1.20 $⁩ 1,200 رصيد API · ≈ ⁨‏129.10 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Meshy من صورة إلى 3D #stylized#transform

يبني نموذجًا ثلاثي الأبعاد واحدًا من 1 إلى 4 زوايا للجسم نفسه، مع عناصر تحكم في المضلعات والطوبولوجيا

Meshy · 3D

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب 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 باستخدام 'a-pose' أو وضعية T باستخدام 't-pose'.

الافتراضي 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 عرض السعر → ⁨‏1.20 $⁩
# 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/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Meshy V7 Multi Image to 3D

يعيد بناء جسم واحد من `image_urls`، التي تستقبل صورة واحدة إلى أربع صور له من زوايا مختلفة. اضبط `topology` على quad أو triangle و`target_polycount` من 100 إلى 300000، واختر standard أو 2k لـ `geometry_resolution`. تركيب الخامات اختياري عبر `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
100 – 300,000
عدد المضلعات المطلوب للنموذج المخرج.
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، يُفعّل بالقيمة true؛ وهو مهجور لصالح pose_mode.
pose_modeاختياري
النوعenum
الافتراضي
a-poset-pose
اترك السلسلة فارغة لتجنب تحديد وضعية النموذج المُولَّد، أو اطلب وضعية A باستخدام 'a-pose' أو وضعية T باستخدام 't-pose'.
texture_promptاختياري
النوعstring | null
≤ 600 حرف
إرشادات إضافة الخامة المقدمة كموجّه نصي، وتتطلب أن تكون should_texture تساوي true.
texture_image_urlاختياري
النوعurl · image
إرشادات إضافة الخامة المقدمة كصورة ثنائية الأبعاد، وتتطلب أن تكون should_texture تساوي true.
enable_riggingاختياري
النوعboolean
الافتراضيfalse
تركيب تلقائي لشخصية بشرية، وهو الأكثر فاعلية للنماذج البشرية التي يمكن تمييز أطرافها بوضوح. يؤدي تمكينه إلى تركيب النموذج المُولَّد وتوفير حركات أساسية للمشي والجري.
rigging_height_metersاختياري
النوعnumber
الافتراضي1.7
> 0
وفّر ارتفاعًا مقدّرًا للشخصية بالأمتار عندما تكون 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?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/ar/developers/models/meshy/v7/multi-image-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt