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

Meshy 6 Retexture

التكامل

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

# 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.30 $⁩ 300 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Meshy 3D إخراج بدقة 4K #3d#3d-to-3d#textures#pbr

إعادة تركيب خامات نموذج ثلاثي الأبعاد مرفوع من مطالبة نصية أو صورة نمط، مع خرائط PBR اختيارية وخامات حتى 8k

Meshy · 3D

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

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

إنشاء طلب

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

texture_resolution الافتراضي 2k

خيارات دقة اللون الأساسي هي 2k (2048) و4k (4096) و8k (8192). يحد اختيار 8k خرائط PBR إلى 4k ويحذف خريطة الانبعاث؛ ولا يتوفر كل من 8k و4k إلا مع Meshy 6 أو 7.

•مطلوب

مصدر النموذج الثلاثي الأبعاد لإضافة الخامات، يُقدَّم إما كعنوان URL متاح للعامة أو كمعرّف بيانات base64 يستخدم application/octet-stream نوع MIME. امتدادات الملفات المقبولة هي .glb و.gltf و.obj و.fbx و.stl.

متقدم text_style_prompt · image_style_url · enable_original_uv · enable_pbr · enable_safety_checker
0 / 600

نص نمط الخامة، مطلوب عند غياب image_style_url ومحدود بـ600 حرف.

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

دليل خامة ثنائي الأبعاد تكون له الأولوية على text_style_prompt عند تقديمه كـ image_style_url. قدّم هذه الصورة إذا كان text_style_prompt غائبًا؛ وأنواع الملفات المدعومة هي .jpg و.jpeg و.png.

POST /run/meshy/v6/retexture?wait=20 عرض السعر → ⁨‏0.30 $⁩
# 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/v6/retexture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_url": "https://example.com/your-file.glb"
  }'

# 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 6 Retexture

يستبدل خامات سطح شبكة موجودة بتنسيق .glb أو .gltf أو .obj أو .fbx أو .stl. يأتي النمط من `text_style_prompt` (حتى 600 حرف) أو `image_style_url` التي لها الأولوية عند تقديم كليهما. يمكن أن تكون `texture_resolution` ‏2k أو 4k أو 8k، وتضيف `enable_pbr` خرائط المعدني والخشونة والنورمال، بينما يحافظ `enable_original_uv` على تخطيط UV للنموذج. تتضمن المخرجات GLB وتنسيقات أخرى وخامات وصورة مصغرة.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
model_urlمطلوب
النوعstring
مصدر النموذج الثلاثي الأبعاد لإضافة الخامات، يُقدَّم إما كعنوان URL متاح للعامة أو كمعرّف بيانات base64 يستخدم application/octet-stream نوع MIME. امتدادات الملفات المقبولة هي .glb و.gltf و.obj و.fbx و.stl.
text_style_promptاختياري
النوعstring | null
≤ 600 حرف
نص نمط الخامة، مطلوب عند غياب image_style_url ومحدود بـ600 حرف.
image_style_urlاختياري
النوعurl · image
دليل خامة ثنائي الأبعاد تكون له الأولوية على text_style_prompt عند تقديمه كـ image_style_url. قدّم هذه الصورة إذا كان text_style_prompt غائبًا؛ وأنواع الملفات المدعومة هي .jpg و.jpeg و.png.
texture_resolutionاختياري
النوعenum
الافتراضي2k
2k4k8k
خيارات دقة اللون الأساسي هي 2k (2048) و4k (4096) و8k (8192). يحد اختيار 8k خرائط PBR إلى 4k ويحذف خريطة الانبعاث؛ ولا يتوفر كل من 8k و4k إلا مع Meshy 6 أو 7.
enable_original_uvاختياري
النوعboolean
الافتراضيtrue
احتفظ بـUV بدلًا من إعادة توليدها عند تمكين هذا الخيار. قد تتدهور الجودة إذا تم تمكينه لنموذج يفتقر إلى تخطيط UV أصلي.
enable_pbrاختياري
النوعboolean
الافتراضيfalse
يتحكم في توليد خرائط PBR للمعدنية والخشونة والطبيعية إلى جانب اللون الأساسي.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص أمان المعالجة المسبقة: تجعل القيمة true فحص أمان المدخل شرطًا مسبقًا للمعالجة.
مطلوب

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v6/retexture",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "model_url": "https://example.com/your-file.glb"
  },
  "output": {
    "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
        }
      }
    ],
    "text_style_prompt": "red and black chest",
    "image_style_url": "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
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}ملفات الخامات ممثلة كمصفوفة من الكائنات.
text_style_prompt
string | nullموجّه إضافة الخامة المستخدم، عند تقديمه.
image_style_url
string | nullعنوان URL لصورة إضافة الخامة المستخدمة، عند تقديمها.

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