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

Meshy V7 Text to 3D

التكامل

معرّف النموذج meshy/v7/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/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"

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

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

تحويل النص إلى ثلاثي الأبعاد مع Meshy 7: وضع المعاينة أو الخامات، وهندسة 2k، وخيارات PBR والتحريك والرسوم المتحركة

Meshy · 3D

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

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

إنشاء طلب

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

•مطلوب 88 / 600

وصف للكائن المراد تمثيله كنموذج ثلاثي الأبعاد، محدود بـ600 حرف.

mode الافتراضي full

وضع التوليد: ينتج 'preview' هندسة بلا خامات، بينما ينتج 'full' نموذجًا مزودًا بالخامات عبر الجمع بين المعاينة والتحسين.

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 · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode
0 / 600

وجّه إضافة الخامة بموجّه نصي إضافي في وضع 'full'؛ ولا تستخدمه الأوضاع الأخرى.

أفلت ملفًا، أو

صورة مرجعية ثنائية الأبعاد لتوليد الخامات، تُطبَّق فقط في وضع 'full'.

model_type الافتراضي standard

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

topology الافتراضي triangle

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

symmetry_mode الافتراضي 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/text-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.com/v1/run/meshy/v7/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 V7 Text to 3D

ينشئ نموذجًا ثلاثي الأبعاد من `prompt` تصل إلى 600 حرف، مع `enable_prompt_expansion` اختياريًا. تعيد `mode` إما هندسة بلا خامات أو نموذجًا مزوّدًا بالخامات. اختر standard أو lowpoly أو smart-topology عبر `model_type`، واضبط `target_polycount` من 100 إلى 300000، واختر standard أو 2k لـ `geometry_resolution`. يمكن إضافة تجهيز التحريك وإعدادات الرسوم المتحركة للشخصيات البشرية.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 600 حرف
وصف للكائن المراد تمثيله كنموذج ثلاثي الأبعاد، محدود بـ600 حرف.
modeاختياري
النوعenum
الافتراضيfull
previewfull
وضع التوليد: ينتج 'preview' هندسة بلا خامات، بينما ينتج 'full' نموذجًا مزودًا بالخامات عبر الجمع بين المعاينة والتحسين.
seedاختياري
النوعinteger | null
أعد استخدام هذه البذرة مع موجّه لم يتغير لإعادة إنتاج نتيجة سابقة عادةً.
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.
should_remeshاختياري
النوعboolean
الافتراضيtrue
تخطَّ إعادة بناء الشبكة وتلقَّ الشبكة المثلثة الخام بتعيين هذه القيمة إلى false؛ وإلا فعّل مرحلة إعادة البناء.
symmetry_modeاختياري
النوعenum
الافتراضيauto
offautoon
إعداد التناظر المطبق أثناء توليد النموذج.
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'.
enable_prompt_expansionاختياري
النوعboolean
الافتراضيfalse
السماح لنموذج لغوي كبير بإثراء الموجّه بالتفاصيل. لا يغيّر تفعيل هذا التوسيع معنى الموجّه.
texture_promptاختياري
النوعstring | null
≤ 600 حرف
وجّه إضافة الخامة بموجّه نصي إضافي في وضع 'full'؛ ولا تستخدمه الأوضاع الأخرى.
texture_image_urlاختياري
النوعurl · image
صورة مرجعية ثنائية الأبعاد لتوليد الخامات، تُطبَّق فقط في وضع 'full'.
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/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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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قيمة البذرة المستخدمة أثناء التوليد.
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/ar/developers/models/meshy/v7/text-to-3d.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt