דילוג לתוכן

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.ru/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.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 עם Meshy 7: מצב תצוגה מקדימה או מלא, גאומטריה של 2k ואפשרויות PBR, שלד ואנימציה

Meshy · 3D

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

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

בנה בקשה

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

•חובה 88 / 600

תיאור האובייקט לייצוג כמודל תלת־ממדי, מוגבל ל־600 תווים.

mode ברירת מחדל full

מצב יצירה: 'preview' מפיק גאומטריה ללא טקסטורות, ואילו 'full' מפיק מודל עם טקסטורה באמצעות שילוב של preview ו־refine.

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 בשלב הגאומטריה (preview) ולקבל חלקים נקיים שנוצרו בנפרד מלכתחילה.

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`.

השתמשו שוב ב־seed זה יחד עם הנחיה ללא שינוי כדי לשחזר בדרך כלל תוצאה קודמת.

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Meshy V7 Text to 3D

מייצר מודל 3D מ-`prompt` באורך של עד 600 תווים, עם `enable_prompt_expansion` אופציונלי. `mode` מחזיר גאומטריה ללא טקסטורה או מודל עם טקסטורה. בחרו standard, lowpoly או smart-topology באמצעות `model_type`, הגדירו `target_polycount` בין 100 ל-300000, ובחרו `geometry_resolution` של standard או 2k. ניתן להוסיף שלד וקדם-הגדרות אנימציה לדמויות דמויות-אדם.

פרמטרים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
≤ 600 תווים
תיאור האובייקט לייצוג כמודל תלת־ממדי, מוגבל ל־600 תווים.
modeאופציונלי
סוגenum
ברירת מחדלfull
previewfull
מצב יצירה: 'preview' מפיק גאומטריה ללא טקסטורות, ואילו 'full' מפיק מודל עם טקסטורה באמצעות שילוב של preview ו־refine.
seedאופציונלי
סוגinteger | null
השתמשו שוב ב־seed זה יחד עם הנחיה ללא שינוי כדי לשחזר בדרך כלל תוצאה קודמת.
model_typeאופציונלי
סוגenum
ברירת מחדלstandard
standardlowpolysmart-topology
מצב רשת תלת־ממדית: בחרו 'lowpoly' לתוצאה דלת־פוליגונים המותאמת לפוליגונים נקיים יותר; במצב זה Meshy מתעלם מ־topology, target_polycount ו־should_remesh. לתוצאה רגילה ברמת פירוט גבוהה בחרו 'standard', או בחרו 'smart-topology' כדי להשתמש ב־Meshy-T2 בשלב הגאומטריה (preview) ולקבל חלקים נקיים שנוצרו בנפרד מלכתחילה.
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.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 | nullערך ה-Seed ששימש במהלך היצירה.
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

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