שפּרינגען צו אינהאַלט

Meshy V7 Multi Image to 3D

אינטעגרירן

מאָדעל־id 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

פֿײַלן ווי דער בײַשפּיל: ⁨$ 1.20⁩ 1,200 API־קרעדיטן אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Meshy בילד צו 3D #stylized#transform

בויט איין 3D־מאָדעל פֿון 1 ביז 4 קוקן פֿונעם זעלבן אָביעקט, מיט קאָנטראָלן פֿאַר פּאָליגאָנען און טאָפּאָלאָגיע

Meshy · 3D

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט image_urls
לייגט אַרײַן אַ טעקע, אָדער

בילדער־סעט פֿאַר 3D שאַפֿן, מיט .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.

לייגט אַרײַן אַ טעקע, אָדער

טעקסטוריר־אינסטרוקציעס צוגעשטעלט ווי אַ 2D בילד, וואָס דאַרף should_texture זײַן true.

topology סטאַנדאַרט triangle

מאָדעל־טאָפּאָלאָגיע־ברירה צווישן Triangle פֿאַר געאָמעטרישן דעטאַל און Quad פֿאַר גלאַטקייט פון דער אויבערפֿלאַך.

symmetry_mode סטאַנדאַרט auto

סימעטריע־באַשטעטיקונג געווענדט בײַם גענערירן דעם מאָדעל.

pose_mode סטאַנדאַרט

לאָז דעם סטרינג ליידיק כּדי נישט צו ספּעציפֿיצירן דעם פּאָזע פונעם גענערירטן מאָדעל, אָדער בעט אַן A-pose מיט 'a-pose' אָדער אַ T-pose מיט 't-pose'.

סטאַנדאַרט 30000

געווינצטע פּאָליגאָן־צאָל פֿאַר דעם רעזולטאַט־מאָדעל.

סטאַנדאַרט 1.7

גיט אַ געשאַצטע כאַראַקטער־הייך אין מעטער ווען enable_rigging איז true; אַנדערש האָט דער ווערט קיין השפּעה נישט.

סטאַנדאַרט 92

Meshy ביבליאָטעק־אַנימאַציע־פּרעסעט־ID, מיט צוטריטלעכע אַקציעס לויט 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Meshy V7 Multi Image to 3D

רעקאָנסטרויִרט איין אָביעקט פֿון `image_urls`, וואָס נעמט איין ביז פֿיר בילדער פֿון פֿאַרשידענע ווינקלען. שטעלט `topology` אויף quad אָדער triangle און `target_polycount` פֿון 100 ביז 300000, און קלייבט standard אָדער 2k `geometry_resolution`. טעקסטורינג איז אָפּציאָנעל דורך `should_texture`, מיט PBR־מאַפּעס, פּאָזע־מאָדע, ריגינג און אַנימאַציע. רעזולטאַטן אַרײַננעמען אַ GLB און אַנדערע פֿאָרמאַטן.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlsפארלאנגט images
טיפּurl[] · image
בילדער־סעט פֿאַר 3D שאַפֿן, מיט .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-pose גענערירונג־באַשטימער אַקטיוו מיט true; דעפּרעקירט לטובת pose_mode.
pose_modeאָפּציאָנעל
טיפּenum
סטאַנדאַרט
a-poset-pose
לאָז דעם סטרינג ליידיק כּדי נישט צו ספּעציפֿיצירן דעם פּאָזע פונעם גענערירטן מאָדעל, אָדער בעט אַן A-pose מיט 'a-pose' אָדער אַ T-pose מיט 't-pose'.
texture_promptאָפּציאָנעל
טיפּstring | null
≤ 600 כאַראַקטערן
טעקסטוריר־אינסטרוקציעס צוגעשטעלט ווי אַ טעקסט־פּראָמפּט, וואָס דאַרף should_texture זײַן true.
texture_image_urlאָפּציאָנעל
טיפּurl · image
טעקסטוריר־אינסטרוקציעס צוגעשטעלט ווי אַ 2D בילד, וואָס דאַרף 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 ביבליאָטעק־אַנימאַציע־פּרעסעט־ID, מיט צוטריטלעכע אַקציעס לויט 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 איז נישט בנימצא פֿאַר גענערירונג פֿון מערערע בילדער.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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אַנימאַציע־רעזולטאַט מיטן 3D מאָדעל ווי GLB; דער ענטפֿער לאָזט דעם רעזולטאַט אויס אויב enable_animation איז נישט true.
animation_fbx
object {url, content_type, file_name, file_size} | nullאַנימאַציע־רעזולטאַט מיטן 3D מאָדעל ווי FBX; דער ענטפֿער לאָזט דעם רעזולטאַט אויס אויב enable_animation איז נישט true.
model_glb
object {url, content_type, file_name, file_size}GLB־פֿײַל מיטן גענערירטן 3D־אָביעקט.
thumbnail
object {url, content_type, file_name, file_size} | nullטהומבנייל מיט אַ פּריוויו פֿונעם גענערירטן מאָדעל.
model_urls
object {glb, fbx, obj, usdz, blend, stl}לינקס צו דעם 3D־מאָדעל אין פֿאַרשידענע פֿאָרמאַטן.
texture_urls
array of object {base_color, metallic, normal, roughness}טעקסטור־פֿײַלן רעפּרעזענטירט ווי אַן אַרריי פון אָביעקטן.
seed
integer | 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/yi/developers/models/meshy/v7/multi-image-to-3d.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt