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

Meshy Rigging Multi Animation

التكامل

معرّف النموذج meshy/rigging/multi-animation
# 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/rigging/multi-animation?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb",
    "animation_action_ids": [
      36,
      92
    ]
  }'

# 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"

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

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

يجهّز GLB بشريًا للتحريك مرة واحدة ويخبز عدة إعدادات حركة في تشغيل واحد

Meshy · بيانات (JSON)

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

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

إنشاء طلب

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

•مطلوب

عنوان URL لتركيب وتحريك شخصية بشرية ثلاثية الأبعاد يمكن تمييز أطرافها بوضوح. يجب أن يكون عنوان URL متاحًا للعامة وأن يشير إلى ملف GLB؛ وقد يأتي النموذج من Hunyuan أو Trellis أو Meshy أو أداة توليد ثلاثية الأبعاد أخرى.

•مطلوب

معرّفات الحركات المسبقة من مكتبة Meshy؛ يلزم معرّف واحد على الأقل، ويجب أن يقع كل معرّف ضمن [0, 696]، مع حد أقصى يبلغ 10 مقاطع متميزة وإزالة التكرارات. ينتج كل معرّف مقطعًا باستخدام الهيكل نفسه، وتُعاد المقاطع في مصفوفة animations بالترتيب المطلوب. توثَّق المعرّفات المتاحة في https://docs.meshy.ai/en/api/animation-library.

متقدم height_meters · enable_safety_checker
الافتراضي 1.7

الارتفاع المقدّر للشخصية، مقاسًا بالأمتار.

POST /run/meshy/rigging/multi-animation?wait=20 عرض السعر → ⁨‏0.44 $⁩
# 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/rigging/multi-animation?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb",
    "animation_action_ids": [
      36,
      92
    ]
  }'

# 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 Rigging Multi Animation

يجهّز GLB بشريًا من `model_url` وينشئ مقطع حركة واحدًا لكل معرّف في `animation_action_ids`، وكلها على نفس الهيكل. تعود المقاطع بترتيب الطلب في مصفوفة `animations`، إلى جانب ملفات GLB وFBX المجهزة للتحريك وحركتي المشي والجري الأساسيتين. يلزم معرّف واحد على الأقل. يحدد `height_meters` الارتفاع التقريبي للشخصية.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
model_urlمطلوب
النوعstring
عنوان URL لتركيب وتحريك شخصية بشرية ثلاثية الأبعاد يمكن تمييز أطرافها بوضوح. يجب أن يكون عنوان URL متاحًا للعامة وأن يشير إلى ملف GLB؛ وقد يأتي النموذج من Hunyuan أو Trellis أو Meshy أو أداة توليد ثلاثية الأبعاد أخرى.
height_metersاختياري
النوعnumber
الافتراضي1.7
> 0
الارتفاع المقدّر للشخصية، مقاسًا بالأمتار.
animation_action_idsمطلوب
النوعinteger[]
معرّفات الحركات المسبقة من مكتبة Meshy؛ يلزم معرّف واحد على الأقل، ويجب أن يقع كل معرّف ضمن [0, 696]، مع حد أقصى يبلغ 10 مقاطع متميزة وإزالة التكرارات. ينتج كل معرّف مقطعًا باستخدام الهيكل نفسه، وتُعاد المقاطع في مصفوفة animations بالترتيب المطلوب. توثَّق المعرّفات المتاحة في https://docs.meshy.ai/en/api/animation-library.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص أمان المعالجة المسبقة: تجعل القيمة true فحص أمان المدخل شرطًا مسبقًا للمعالجة.
مطلوب

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/rigging/multi-animation",
  "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": 440,
    "usd": "0.44",
    "charged": 440,
    "refunded": 0
  },
  "input": {
    "model_url": "https://example.com/your-file.glb",
    "animation_action_ids": [
      36,
      92
    ]
  },
  "output": {
    "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
      }
    },
    "animations": [
      {
        "action_id": 1,
        "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
        }
      }
    ],
    "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
rigged_character_glb
object {url, content_type, file_name, file_size} | nullشخصية بتنسيق GLB مع تطبيق التركيب.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullشخصية بتنسيق FBX مع تطبيق التركيب.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullحركات أساسية للمشي والجري مقدمة كجزء من التركيب.
animations
array of object {action_id, animation_glb, animation_fbx}نتائج الحركة المرتبة المطابقة لمعرّفات الإجراءات في الطلب. لكل معرّف مطلوب عنصر واحد يحتوي على مقطع مُولَّد باستخدام الهيكل.
rig_task_id
string | nullمُعرّف مهمة التركيب في Meshy.

مزيد من النماذج: 3D

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/meshy/rigging/multi-animation.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt