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

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.ru/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.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

تحويل صورة واحدة إلى شبكة ثلاثية الأبعاد مع خيار هندسة 2k وPBR وتجهيز للتحريك ورسوم متحركة اختياريًا

Meshy · 3D

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

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

إنشاء طلب

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

•مطلوب image_url
أفلت ملفًا، أو

وفّر الصورة المصدر لإنشاء ثلاثي الأبعاد عبر عنوان URL أو معرّف بيانات 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

وضع الشبكة الثلاثية الأبعاد: اختر 'lowpoly' لنتيجة منخفضة المضلعات محسّنة لمضلعات أنظف؛ في هذا الوضع يتجاهل Meshy كلًا من topology وtarget_polycount وshould_remesh. للحصول على نتيجة تقليدية عالية التفاصيل اختر 'standard'، أو اختر 'smart-topology' لاستخدام Meshy-T2 والحصول على أجزاء نظيفة تُولَّد منفصلة منذ البداية.

topology الافتراضي triangle

اختيار طوبولوجيا النموذج بين Triangle للتفاصيل الهندسية وQuad لنعومة السطح.

symmetry_mode الافتراضي auto

اختر ما إذا كان توليد النموذج يفرض التناظر باستخدام On، أو يحذفه باستخدام Off، أو يقرره تلقائيًا باستخدام Auto.

pose_mode الافتراضي

اترك السلسلة فارغة لتجنب تحديد وضعية النموذج المُولَّد، أو اطلب وضعية A باستخدام 'a-pose' أو وضعية T باستخدام 't-pose'.

الافتراضي 30000

العدد المستهدف للمضلعات، ويُحد بـ15,000 عندما تكون model_type تساوي 'smart-topology'. يؤدي حذف الهدف في ذلك الوضع إلى اختيار القيمة الافتراضية الأقل في 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 عرض السعر → ⁨‏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/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.ru/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 أو معرّف بيانات base64، باستخدام .jpg أو .jpeg أو .png أو AVIF أو HEIF. يتولى التحويل التلقائي معالجة مدخلي AVIF وHEIF.
model_typeاختياري
النوعenum
الافتراضيstandard
standardlowpolysmart-topology
وضع الشبكة الثلاثية الأبعاد: اختر 'lowpoly' لنتيجة منخفضة المضلعات محسّنة لمضلعات أنظف؛ في هذا الوضع يتجاهل Meshy كلًا من topology وtarget_polycount وshould_remesh. للحصول على نتيجة تقليدية عالية التفاصيل اختر 'standard'، أو اختر 'smart-topology' لاستخدام Meshy-T2 والحصول على أجزاء نظيفة تُولَّد منفصلة منذ البداية.
topologyاختياري
النوعenum
الافتراضيtriangle
quadtriangle
اختيار طوبولوجيا النموذج بين Triangle للتفاصيل الهندسية وQuad لنعومة السطح.
target_polycountاختياري
النوعinteger
الافتراضي30000
100 – 300,000
العدد المستهدف للمضلعات، ويُحد بـ15,000 عندما تكون model_type تساوي 'smart-topology'. يؤدي حذف الهدف في ذلك الوضع إلى اختيار القيمة الافتراضية الأقل في 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، يُفعّل بالقيمة true؛ وهو مهجور لصالح pose_mode.
pose_modeاختياري
النوعenum
الافتراضي
a-poset-pose
اترك السلسلة فارغة لتجنب تحديد وضعية النموذج المُولَّد، أو اطلب وضعية A باستخدام 'a-pose' أو وضعية T باستخدام 't-pose'.
texture_promptاختياري
النوعstring | null
≤ 600 حرف
تعليمات نصية توجه توليد الخامات.
texture_image_urlاختياري
النوعurl · image
صورة مرجعية ثنائية الأبعاد توجه توليد الخامات.
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
دقة هندسة الشبكة؛ خيارتا 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.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}كائنات ملفات الخامات في مصفوفة منظمة بما يطابق 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/ar/developers/models/meshy/v7/image-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt