דילוג לתוכן

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

בונה מודל 3D אחד מ-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, ובחרו `geometry_resolution` של standard או 2k. הטקסטורות אופציונליות באמצעות `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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 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 | nullSeed היצירה, כאשר זמין.
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

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/meshy/v7/multi-image-to-3d.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt