דילוג לתוכן

Meshy 6 · Image to 3D

שילוב

מזהה מודל meshy/v6/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/v6/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 #image-to-3d

Meshy 6 מתמונה ל-3D עם יצירת רשת מחדש, מפות PBR, שלד דמוי-אדם ואנימציה אופציונליים

Meshy · 3D

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה image_url
גרור קובץ, או

ספקו את תמונת המקור ליצירה תלת־ממדית באמצעות כתובת URL או URI של נתוני base64, באמצעות .jpg, .jpeg, .png, AVIF או HEIF. המרה אוטומטית מטפלת בקלטי AVIF ו־HEIF.

מתקדם 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
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/v6/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/v6/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 6 · Image to 3D

בונה מודל 3D מתמונה אחת (`image_url`). `model_type` הוא standard, lowpoly או smart-topology, הטופולוגיה היא triangle או quad, ו-`target_polycount` נע בין 100 ל-300000 (בטופולוגיה חכמה המקסימום הוא 15,000). האפשרויות כוללות טקסטורות, מפות PBR, סימטריה, תנוחת A או T ושלד דמוי-אדם עם קדם-הגדרת אנימציה. הפלט כולל קובצי GLB ו-FBX.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
image_urlחובה image
סוגurl · image
ספקו את תמונת המקור ליצירה תלת־ממדית באמצעות כתובת URL או URI של נתוני 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 הופך את בדיקת הבטיחות של הקלט לתנאי מקדים לעיבוד.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v6/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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי 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}אובייקטי קובצי טקסטורה במערך המובנה בהתאם ל־Meshy API.
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/v6/image-to-3d.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt